back to home

AndyMik90 / Auto-Claude

Autonomous multi-session AI coding

12,394 stars
1,715 forks
314 issues
TypeScriptPythonJavaScript

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing AndyMik90/Auto-Claude in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind-ai.vercel.app/repo/AndyMik90/Auto-Claude)
Preview:Analyzed by RepoMind

Repository Summary (README)

Preview

Auto Claude

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

Auto Claude Kanban Board

License Discord YouTube CI Mentioned in Awesome Claude Code


Download

Stable Release

<!-- STABLE_VERSION_BADGE -->

Stable

<!-- STABLE_VERSION_BADGE_END --> <!-- STABLE_DOWNLOADS -->
PlatformDownload
WindowsAuto-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
LinuxAuto-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
<!-- STABLE_DOWNLOADS_END -->

Beta Release

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

<!-- BETA_VERSION_BADGE -->

Beta

<!-- BETA_VERSION_BADGE_END --> <!-- BETA_DOWNLOADS -->
PlatformDownload
WindowsAuto-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
LinuxAuto-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
<!-- BETA_DOWNLOADS_END -->

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

  1. Download and install the app for your platform
  2. Open your project - Select a git repository folder
  3. Connect Claude - The app will guide you through OAuth setup
  4. Create a task - Describe what you want to build
  5. Watch it work - Agents plan, code, and validate autonomously

Features

FeatureDescription
Autonomous TasksDescribe your goal; agents handle planning, implementation, and validation
Parallel ExecutionRun multiple builds simultaneously with up to 12 agent terminals
Isolated WorkspacesAll changes happen in git worktrees - your main branch stays safe
Self-Validating QABuilt-in quality assurance loop catches issues before you review
AI-Powered MergeAutomatic conflict resolution when integrating back to main
Memory LayerAgents retain insights across sessions for smarter builds
GitHub/GitLab IntegrationImport issues, investigate with AI, create merge requests
Linear IntegrationSync tasks with Linear for team progress tracking
Cross-PlatformNative desktop apps for Windows, macOS, and Linux
Auto-UpdatesApp 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:

  1. OS Sandbox - Bash commands run in isolation
  2. Filesystem Restrictions - Operations limited to project directory
  3. 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

CommandDescription
npm run install:allInstall backend and frontend dependencies
npm startBuild and run the desktop app
npm run devRun in development mode with hot reload
npm run packagePackage for current platform
npm run package:macPackage for macOS
npm run package:winPackage for Windows
npm run package:linuxPackage for Linux
npm run package:flatpakPackage as Flatpak (see guides/linux.md)
npm run lintRun linter
npm testRun frontend tests
npm run test:backendRun backend tests

Contributing

We welcome contributions! Please read CONTRIBUTING.md for:

  • Development setup instructions
  • Code style guidelines
  • Testing requirements
  • Pull request process

Community


License

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.


Star History

GitHub Repo stars

Star History Chart