Autonomous multi-agent coding framework that plans, builds, and validates software for you.
Get the latest pre-built release for your platform:
| Platform | Download | Notes |
|---|---|---|
| Windows | Auto-Claude-2.7.2-beta.10.exe | Installer (NSIS) |
| macOS (Apple Silicon) | Auto-Claude-2.7.2-beta.10-arm64.dmg | M1/M2/M3 Macs |
| macOS (Intel) | Auto-Claude-2.7.2-beta.10-x64.dmg | Intel Macs |
| Linux | Auto-Claude-2.7.2-beta.10.AppImage | Universal |
| Linux (Debian) | Auto-Claude-2.7.2-beta.10.deb | Ubuntu/Debian |
All releases include SHA256 checksums and VirusTotal scan results for security verification.
- Claude Pro/Max subscription - Get one here
- Claude Code CLI -
npm install -g @anthropic-ai/claude-code - Git repository - Your project must be initialized as a git repo
- Python 3.12+ - Required for the backend and Memory Layer
- Download and install the app for your platform
- Open your project - Select a git repository folder
- Connect Claude - The app will guide you through OAuth setup
- Create a task - Describe what you want to build
- Watch it work - Agents plan, code, and validate autonomously
| Feature | Description |
|---|---|
| Autonomous Tasks | Describe your goal; agents handle planning, implementation, and validation |
| Parallel Execution | Run multiple builds simultaneously with up to 12 agent terminals |
| Isolated Workspaces | All changes happen in git worktrees - your main branch stays safe |
| Self-Validating QA | Built-in quality assurance loop catches issues before you review |
| AI-Powered Merge | Automatic conflict resolution when integrating back to main |
| Memory Layer | Agents retain insights across sessions for smarter builds |
| Cross-Platform | Native desktop apps for Windows, macOS, and Linux |
| Auto-Updates | App updates automatically when new versions are released |
Visual task management from planning through completion. Create tasks and monitor agent progress in real-time.
AI-powered terminals with one-click task context injection. Spawn multiple agents for parallel work.
AI-assisted feature planning with competitor analysis and audience targeting.
- Insights - Chat interface for exploring your codebase
- Ideation - Discover improvements, performance issues, and vulnerabilities
- Changelog - Generate release notes from completed tasks
Auto-Claude/
├── apps/
│ ├── backend/ # Python agents, specs, QA pipeline
│ └── frontend/ # Electron desktop application
├── guides/ # Additional documentation
├── tests/ # Test suite
└── scripts/ # Build utilities
For headless operation, CI/CD integration, or terminal-only workflows:
cd apps/backend
# Create a spec interactively
python spec_runner.py --interactive
# Run autonomous build
python run.py --spec 001
# Review and merge
python run.py --spec 001 --review
python run.py --spec 001 --mergeSee guides/CLI-USAGE.md for complete CLI documentation.
Create apps/backend/.env from the example:
cp apps/backend/.env.example apps/backend/.env| Variable | Required | Description |
|---|---|---|
CLAUDE_CODE_OAUTH_TOKEN |
Yes | OAuth token from claude setup-token |
GRAPHITI_ENABLED |
No | Enable Memory Layer for cross-session context |
AUTO_BUILD_MODEL |
No | Override the default Claude model |
For contributors and development:
# Clone the repository
git clone https://github.com/AndyMik90/Auto-Claude.git
cd Auto-Claude
# Install all dependencies
npm run install:all
# Run in development mode
npm run dev
# Or build and run
npm startSystem requirements for building:
- Node.js 24+
- Python 3.12+
- npm 10+
See CONTRIBUTING.md for detailed development setup.
Auto Claude uses a three-layer security model:
- OS Sandbox - Bash commands run in isolation
- Filesystem Restrictions - Operations limited to project directory
- Dynamic Command Allowlist - Only approved commands based on detected project stack
All releases are:
- Scanned with VirusTotal before publishing
- Include SHA256 checksums for verification
- Code-signed where applicable (macOS)
| Command | Description |
|---|---|
npm run install:all |
Install backend and frontend dependencies |
npm start |
Build and run the desktop app |
npm run dev |
Run in development mode with hot reload |
npm run package |
Package for current platform |
npm run package:mac |
Package for macOS |
npm run package:win |
Package for Windows |
npm run package:linux |
Package for Linux |
npm run lint |
Run linter |
npm test |
Run frontend tests |
npm run test:backend |
Run backend tests |
We welcome contributions! Please read CONTRIBUTING.md for:
- Development setup instructions
- Code style guidelines
- Testing requirements
- Pull request process
- Discord - Join our community
- Issues - Report bugs or request features
- Discussions - Ask questions
AGPL-3.0 - GNU Affero General Public License v3.0
Auto Claude is free to use. If you modify and distribute it, or run it as a service, your code must also be open source under AGPL-3.0.
Commercial licensing available for closed-source use cases.


