README

Auto Claude

Autonomous multi-agent coding framework that plans, builds, and validates software for you.

Auto Claude Kanban Board

Download

Stable Release

Platform	Download
Windows	Auto-Claude-2.7.6-win32-x64.exe
macOS (Apple Silicon)	Auto-Claude-2.7.6-darwin-arm64.dmg
macOS (Intel)	Auto-Claude-2.7.6-darwin-x64.dmg
Linux	Auto-Claude-2.7.6-linux-x86_64.AppImage
Linux (Debian)	Auto-Claude-2.7.6-linux-amd64.deb
Linux (Flatpak)	Auto-Claude-2.7.6-linux-x86_64.flatpak

Beta Release

⚠️ Beta releases may contain bugs and breaking changes. View all releases

Platform	Download
Windows	Auto-Claude-2.7.6-beta.6-win32-x64.exe
macOS (Apple Silicon)	Auto-Claude-2.7.6-beta.6-darwin-arm64.dmg
macOS (Intel)	Auto-Claude-2.7.6-beta.6-darwin-x64.dmg
Linux	Auto-Claude-2.7.6-beta.6-linux-x86_64.AppImage
Linux (Debian)	Auto-Claude-2.7.6-beta.6-linux-amd64.deb
Linux (Flatpak)	Auto-Claude-2.7.6-beta.6-linux-x86_64.flatpak

All releases include SHA256 checksums and VirusTotal scan results for security verification.

Requirements

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

Quick Start

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

Features

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
GitHub/GitLab Integration	Import issues, investigate with AI, create merge requests
Linear Integration	Sync tasks with Linear for team progress tracking
Cross-Platform	Native desktop apps for Windows, macOS, and Linux
Auto-Updates	App updates automatically when new versions are released

Interface

Kanban Board

Visual task management from planning through completion. Create tasks and monitor agent progress in real-time.

Agent Terminals

AI-powered terminals with one-click task context injection. Spawn multiple agents for parallel work.

Agent Terminals

Roadmap

AI-assisted feature planning with competitor analysis and audience targeting.

Roadmap

Additional Features

Insights - Chat interface for exploring your codebase
Ideation - Discover improvements, performance issues, and vulnerabilities
Changelog - Generate release notes from completed tasks

Project Structure

Auto-Claude/
├── apps/
│   ├── backend/     # Python agents, specs, QA pipeline
│   └── frontend/    # Electron desktop application
├── guides/          # Additional documentation
├── tests/           # Test suite
└── scripts/         # Build utilities

CLI Usage

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 --merge

See guides/CLI-USAGE.md for complete CLI documentation.

Development

Want to build from source or contribute? See CONTRIBUTING.md for complete development setup instructions.

For Linux-specific builds (Flatpak, AppImage), see guides/linux.md.

Security

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)

Available Scripts

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 package:flatpak`	Package as Flatpak (see guides/linux.md)
`npm run lint`	Run linter
`npm test`	Run frontend tests
`npm run test:backend`	Run backend tests