{"id":30522959,"url":"https://github.com/hammergpt/claude-co-desk","last_synced_at":"2026-06-23T22:03:55.213Z","repository":{"id":311387288,"uuid":"1041889680","full_name":"HammerGPT/claude-co-desk","owner":"HammerGPT","description":"A local AI task automation system built on Claude Code framework, exploring the limits of AI agents with full system resource control.","archived":false,"fork":false,"pushed_at":"2025-09-14T06:06:09.000Z","size":9931,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-14T07:06:25.864Z","etag":null,"topics":["ai-automation","claude-code","mcp-protocol","multi-agent-systems","task-automation"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HammerGPT.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-21T06:55:26.000Z","updated_at":"2025-09-14T06:06:23.000Z","dependencies_parsed_at":"2025-08-24T13:10:13.262Z","dependency_job_id":"219ac3f3-283d-431e-a5c0-da741cc1755b","html_url":"https://github.com/HammerGPT/claude-co-desk","commit_stats":null,"previous_names":["hammergpt/claude-co-desk"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/HammerGPT/claude-co-desk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HammerGPT%2Fclaude-co-desk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HammerGPT%2Fclaude-co-desk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HammerGPT%2Fclaude-co-desk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HammerGPT%2Fclaude-co-desk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HammerGPT","download_url":"https://codeload.github.com/HammerGPT/claude-co-desk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HammerGPT%2Fclaude-co-desk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275453457,"owners_count":25467726,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-16T02:00:10.229Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-automation","claude-code","mcp-protocol","multi-agent-systems","task-automation"],"created_at":"2025-08-26T19:43:51.110Z","updated_at":"2025-09-16T16:46:54.393Z","avatar_url":"https://github.com/HammerGPT.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"static/assets/icons/system/app-icon-192.png\" alt=\"Claude Co-Desk Logo\" width=\"64\" height=\"64\"\u003e\n  \u003ch1\u003eClaude Co-Desk\u003c/h1\u003e\n  \u003cp\u003e\n    \u003ca href=\"README_CN.md\"\u003e中文\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n**Exploring the Limits of AI Agent System Resource Control**\n\nClaude Co-Desk is a local AI task automation system built on Claude Code's complete context engineering framework. It pushes the boundaries of what AI agents can achieve when given full control over system resources, enabling unprecedented levels of automation through multi-agent collaboration.\n\n## Screenshots\n\n\u003cdiv align=\"center\"\u003e\n  \n\u003cdiv align=\"center\"\u003e\n\n\u003ch3\u003eMain Dashboard\u003c/h3\u003e\n\u003cimg src=\"docs/screenshots/main-dashboard.png\" alt=\"Main Dashboard\" width=\"800\"\u003e\n\u003cp\u003e\u003cem\u003eMulti-agent collaboration control center\u003c/em\u003e\u003c/p\u003e\n\n\u003ch3\u003eDigital Employees\u003c/h3\u003e\n\u003cimg src=\"docs/screenshots/digital-employees.png\" alt=\"Digital Employees\" width=\"800\"\u003e\n\u003cp\u003e\u003cem\u003ePre-configured AI agent specialists\u003c/em\u003e\u003c/p\u003e\n\n\u003ch3\u003ePC Task Execution\u003c/h3\u003e\n\u003cimg src=\"docs/screenshots/pc-task-execution.png\" alt=\"PC Task Execution\" width=\"800\"\u003e\n\u003cp\u003e\u003cem\u003eFull-featured desktop interface with Claude Code project management\u003c/em\u003e\u003c/p\u003e\n\n\u003ch3\u003eMobile Task Execution\u003c/h3\u003e\n\u003cimg src=\"docs/screenshots/mobile-task-execution.png\" alt=\"Mobile Task Execution\" width=\"400\"\u003e\n\u003cp\u003e\u003cem\u003eMobile-first task monitoring and status tracking (project management not supported)\u003c/em\u003e\u003c/p\u003e\n\n\u003ch3\u003eNotification System\u003c/h3\u003e\n\u003cimg src=\"docs/screenshots/notification-system.png\" alt=\"Notification System\" width=\"800\"\u003e\n\u003cp\u003e\u003cem\u003eEmail \u0026 WeChat notifications with detailed task completion results\u003c/em\u003e\u003c/p\u003e\n\n\u003ch3\u003eMCP Tool Management\u003c/h3\u003e\n\u003cimg src=\"docs/screenshots/mcp-tools.png\" alt=\"MCP Tool Management\" width=\"800\"\u003e\n\u003cp\u003e\u003cem\u003eDynamic tool extension and management\u003c/em\u003e\u003c/p\u003e\n\n\u003c/div\u003e\n\n\u003c/div\u003e\n\n## Vision\n\n**Exploring the limits of AI Agent complete control over system resources for automation.**\n\nBuilt on Claude Code's mature context engineering framework, Claude Co-Desk represents a new paradigm in AI automation - moving beyond simple code generation to true system-level task automation where AI agents can orchestrate complex workflows with near 100% completion rates.\n\n### Beyond Traditional AI Tools - The Unconventional Path\n\nWhile others use Claude Code for development assistance, Claude Co-Desk explores uncharted territory - transforming AI from a coding companion into an autonomous revenue generation engine. We've deliberately chosen the unconventional path, pushing Claude Code's capabilities far beyond its intended scope to create digital employees that generate real business income.\n\nThis isn't incremental improvement. This is a fundamental reimagining of what AI can accomplish when given system-level autonomy and business objectives.\n\n## Core Features\n\n- **System-Level Resource Control**: AI agents with comprehensive access to system resources\n- **Multi-Agent Collaboration Platform**: Coordinated task execution across specialized agents\n- **Built-in MCP Tool Ecosystem**: Pre-integrated email notifications, WeChat notifications, and application management tools\n- **Digital Employee Auto-Deployment**: Automated deployment and management of AI agent teams with specialized roles\n- **Mobile Task Access**: Access and monitor tasks anywhere through mobile-optimized interface\n- **Network Tunneling Support**: Optional Cloudflare tunnel integration for remote access\n- **Dynamic Tool Extension**: Automatic MCP server discovery and intelligent tool installation\n- **Enterprise-Grade Security**: Secure audit mechanisms for dynamic tool additions\n- **Context-Aware Automation**: Leveraging Claude Code's complete context framework\n\n## Direct Revenue Scenarios\n\n**Affiliate Marketing Automation**\nDeploy marketing specialists that identify trending products daily, create compelling promotional content, and distribute across multiple platforms. Target autonomous income generation of $500+ daily through optimized affiliate campaigns.\n\n**Content Monetization Pipeline**\nLaunch editorial teams that research market trends, produce SEO-optimized articles, and maintain publishing schedules. Generate 20,000+ monthly website visitors and $5,000+ in advertising revenue without manual content creation.\n\n**E-commerce Operations Optimization**\nStation pricing analysts that monitor competitor pricing across hundreds of products, automatically adjust your pricing strategy, and optimize product listings. Achieve $1,000+ daily sales increases through data-driven market positioning.\n\n**Automated Lead Generation Systems**\nEmploy business development specialists that research prospect databases, craft personalized outreach campaigns, and qualify potential customers. Generate $50,000+ monthly sales pipelines with minimal human intervention.\n\n**Social Media Growth Automation**\nDeploy content strategists that analyze viral trends, create platform-specific content, and manage posting schedules across multiple channels. Build audiences of 100,000+ followers within quarterly periods.\n\n**Investment Research Operations**\nHire financial analysts that screen market data, analyze company fundamentals, and generate investment recommendations. Target portfolio outperformance of 30%+ through systematic research automation.\n\n## Technical Architecture\n\n- **Backend**: Python + FastAPI + WebSocket\n- **Frontend**: Native HTML/CSS/JavaScript with modular components\n- **Foundation**: Claude Code's context engineering framework\n- **Protocol**: MCP (Model Context Protocol) for tool integration\n- **License**: MIT License\n\n## Quick Start\n\n### Prerequisites\n\n**1. Install Claude Code CLI**\n\nVisit [claude.ai/code](https://claude.ai/code) and follow the official installation instructions for your platform.\n\n**2. Verify Installation**\n```bash\nclaude --version  # Should show version info\nclaude auth      # Follow prompts to authenticate\n```\n\n**3. Python Environment**\n```bash\npython --version  # Requires Python 3.8+\n```\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/HammerGPT/claude-co-desk.git\ncd claude-co-desk\n```\n\n2. Install dependencies:\n```bash\npip install -r requirements.txt\n```\n\n3. Start the application:\n```bash\npython app.py\n```\n\n4. **Access the application:**\n\n**Local Access:**\n```\nhttp://localhost:3005\n```\n\n**LAN Access:**\nReplace `localhost` with your machine's IP address to access from other devices on the same network:\n```\nhttp://YOUR_IP_ADDRESS:3005\n```\n\n**Internet Access via Cloudflare Tunnel:**\nThe system automatically provides public URLs when Cloudflare Tunnel is available. Best experience is achieved when deployed on a server.\n\n### Optional Components\n\n**Cloudflare Tunnel (for internet access)**\n```bash\n# macOS\nbrew install cloudflare/cloudflare/cloudflared\n\n# Other platforms: Visit https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation/\n```\n\nOnce installed, the system automatically generates public URLs for internet access.\n\n**Recommended: Server Deployment**\nFor the best experience, deploy Claude Co-Desk on a cloud server or VPS:\n- Ensures 24/7 availability for AI agents\n- Better network connectivity for real-time notifications\n- Optimal performance for continuous automation tasks\n- Reliable access from multiple devices\n\n### Business Configuration\n\n5. Configure your first revenue-generating digital employee:\n```bash\n# Access the digital employee management interface\n# Set business objectives and revenue targets\n# Deploy specialized agents for your chosen scenario\n```\n\n6. Monitor earnings and performance through mobile interface\n\n7. Scale successful operations by deploying additional digital employees\n\n## Key Differentiators\n\n- **Beyond Traditional RPA**: AI agents that understand context and adapt to changing requirements\n- **Complete System Access**: Agents can interact with files, networks, databases, and system resources\n- **True Multi-Agent Collaboration**: Coordinated task execution with intelligent work distribution\n- **MCP Protocol Integration**: Extensible tool ecosystem for unlimited capabilities\n- **Local Privacy**: All processing happens locally, ensuring complete data privacy\n\n## Success Metrics\n\n**Marketing Agency Case Study**\nReduced monthly content production costs by $8,000 while doubling output volume and improving client engagement rates by 150%.\n\n**E-commerce Platform Results**\nAutomated pricing optimization systems generated $2,000+ additional daily revenue within 30 days of deployment.\n\n**Consulting Firm Transformation**\nAI research teams deliver comprehensive market analysis reports 10x faster than traditional methods, increasing client capacity by 400%.\n\n**Content Creator Growth**\nAutomated social media management grew follower base from 5,000 to 150,000 within six months while maintaining 15%+ engagement rates.\n\n## Development Status\n\nActive development focusing on pushing the boundaries of AI agent automation capabilities.\n\n## Business Impact\n\n**Revenue Generation Focus**\nUnlike traditional AI tools that optimize existing workflows, Claude Co-Desk creates entirely new income streams through autonomous digital employees that operate with minimal supervision.\n\n**Scalability Without Hiring**\nDeploy specialized expertise without recruiting, training, or managing human employees. Scale operations based on market opportunities rather than HR constraints.\n\n**24/7 Operations**\nDigital employees maintain consistent performance around the clock, generating value during traditional downtime hours and across multiple time zones.\n\n**Risk Mitigation**\nDiversify revenue sources through multiple autonomous operations running simultaneously, reducing dependence on single income streams or manual processes.\n\n## FAQ\n\n### Why is this still Claude Code CLI mode instead of chat mode?\nThis tool aims to explore the limits of AI automated task execution. Chat mode is a nice-to-have feature that we may consider developing in the future.\n\n## Feedback and Support\n\n### Get in Touch\n\n\u003cdiv align=\"center\"\u003e\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\" width=\"140\"\u003e\n\u003cimg src=\"./static/assets/icons/social/github-color.png\" width=\"48\" height=\"48\" alt=\"GitHub\"\u003e\u003cbr\u003e\n\u003cstrong\u003e\u003ca href=\"https://github.com/HammerGPT/claude-co-desk\"\u003eGitHub\u003c/a\u003e\u003c/strong\u003e\u003cbr\u003e\n\u003csub\u003eFeedback issues\u003c/sub\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"140\"\u003e\n\u003cimg src=\"./static/assets/icons/social/twitter-color.png\" width=\"48\" height=\"48\" alt=\"Twitter\"\u003e\u003cbr\u003e\n\u003cstrong\u003e\u003ca href=\"https://x.com/GptHammer3309\"\u003eTwitter/X\u003c/a\u003e\u003c/strong\u003e\u003cbr\u003e\n\u003csub\u003eUpdates \u0026 news\u003c/sub\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"140\"\u003e\n\u003cimg src=\"./static/assets/icons/social/douyin-color.png\" width=\"48\" height=\"48\" alt=\"Douyin\"\u003e\u003cbr\u003e\n\u003cstrong\u003e\u003ca href=\"https://www.douyin.com/user/MS4wLjABAAAA3b9nQ5Ow1s0mOTERBjmQyVn0-WCvyT_FAK_LdMyVQuY\"\u003eDouyin\u003c/a\u003e\u003c/strong\u003e\u003cbr\u003e\n\u003csub\u003eVideo content\u003c/sub\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"140\"\u003e\n\u003cimg src=\"./static/assets/icons/social/wechat_qrcode.jpg\" width=\"80\" height=\"80\" alt=\"WeChat\"\u003e\u003cbr\u003e\n\u003cstrong\u003eWeChat\u003c/strong\u003e\u003cbr\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n\u003c/div\u003e\n\n### Show Your Support\n- Star this repository to show support\n- Watch for updates and new releases  \n- Follow the project for announcements\n\nThank you for your interest in Claude Co-Desk!\n\n## License\n\nMIT License - see the [LICENSE](LICENSE) file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhammergpt%2Fclaude-co-desk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhammergpt%2Fclaude-co-desk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhammergpt%2Fclaude-co-desk/lists"}