Andy
76d1d3b032
* fix: resolve Claude CLI not found on Windows - PATH merge, prompt size cap, and cwd (#1661) Three root causes addressed: 1. PATH overwrite: pythonEnv.PATH was overwriting the augmented PATH (with npm globals) in spawn env. Now merges PATH entries instead, prepending python-specific paths (pywin32_system32) while preserving all augmented entries. 2. System prompt size: On Windows, SDK passes system_prompt as --system-prompt CLI arg. Large CLAUDE.md files exceed CreateProcessW's 32,768 char limit, causing misleading "Claude Code not found" error. Now caps CLAUDE.md content on Windows to stay under the limit. 3. Cross-drive cwd: Agent processes were spawned with autoBuildSource as cwd. On Windows with cross-drive setups, this caused file access issues. Now uses projectPath as cwd since all script paths are absolute. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: address PR review findings - constants, logging, CI fixes (#1661) - Extract magic number 24000 into WINDOWS_MAX_SYSTEM_PROMPT_CHARS constant (set to 20000 for more conservative ~12KB CLI headroom) - Extract truncation suffix into WINDOWS_TRUNCATION_MESSAGE constant - Fix double-print when truncation occurs: only print "included in system prompt" when CLAUDE.md was NOT truncated (was_truncated flag) - Fix CI test failures: update subprocess-spawn tests to expect projectPath as cwd instead of autoBuildSource (matches the #1661 CWD change) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: normalize PATH key casing and fix truncation budget on Windows - Normalize env objects to a single uppercase 'PATH' key before merging to prevent duplicate PATH keys on Windows where process.env has 'Path' and getAugmentedEnv() writes 'PATH'. Without this, Object.keys().find() returns 'Path' first (insertion order), discarding augmented entries, and the final spread produces both 'Path' and 'PATH' keys. Follows the same pattern used in python-env-manager.ts. (#1661) - Subtract WINDOWS_TRUNCATION_MESSAGE length from the truncation budget so the final system prompt stays within WINDOWS_MAX_SYSTEM_PROMPT_CHARS. Addresses PR #1843 review findings NEW-001, NEW-002, NEW-003. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: address PR review findings for Windows PATH key casing and truncation budget - Finding 1 (MEDIUM): Prefer 'PATH' key directly when present in env to avoid insertion-order bug where Object.keys().find() returned 'Path' first on Windows - Finding 2 (MEDIUM): Normalization block (delete stale cased key, write 'PATH') already in place from previous commit; Finding 1 fix ensures envPathKey resolves correctly so normalization fires only when truly needed - Finding 3 (LOW): Subtract header template overhead from max_claude_md_chars to prevent ~44-char overshoot in Windows command-line truncation budget (#1661) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: remove stale 'Path' key after PATH normalization on Windows When getAugmentedEnv() spreads process.env on Windows, the resulting object contains both 'Path' (from process.env spread) and 'PATH' (explicitly written by getAugmentedEnv). The prior normalization block only removed non-'PATH' keys when 'PATH' was absent, leaving the stale 'Path' key when both coexisted. Add a cleanup loop to delete all case-variant PATH keys that differ from 'PATH' after the main normalization, ensuring the child process inherits a single canonical 'PATH' entry with the fully-augmented value. (#1661) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * refactor: extract shared PATH normalization utilities and add unit tests - Extract normalizeEnvPathKey() and mergePythonEnvPath() into env-utils.ts as shared, exported helpers to eliminate duplicated PATH key case-normalization logic across agent-process.ts and python-env-manager.ts (Finding 3) - Add PATH normalization call in agent-queue.ts spawnIdeationProcess and spawnRoadmapProcess to fix the same Windows PATH duplicate-key issue that was fixed in agent-process.ts (#1661) (Finding 1) - Add comprehensive unit tests for normalizeEnvPathKey() and mergePythonEnvPath() covering Windows-style 'Path' key renaming, duplicate key removal, PATH deduplication across merge, and Unix separator support (Finding 2) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Auto Claude
Autonomous multi-agent coding framework that plans, builds, and validates software for you.
Download
Stable Release
| Platform | Download |
|---|---|
| Windows | Auto-Claude-2.7.5-win32-x64.exe |
| macOS (Apple Silicon) | Auto-Claude-2.7.5-darwin-arm64.dmg |
| macOS (Intel) | Auto-Claude-2.7.5-darwin-x64.dmg |
| Linux | Auto-Claude-2.7.5-linux-x86_64.AppImage |
| Linux (Debian) | Auto-Claude-2.7.5-linux-amd64.deb |
| Linux (Flatpak) | Auto-Claude-2.7.5-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.5-win32-x64.exe |
| macOS (Apple Silicon) | Auto-Claude-2.7.6-beta.5-darwin-arm64.dmg |
| macOS (Intel) | Auto-Claude-2.7.6-beta.5-darwin-x64.dmg |
| Linux | Auto-Claude-2.7.6-beta.5-linux-x86_64.AppImage |
| Linux (Debian) | Auto-Claude-2.7.6-beta.5-linux-amd64.deb |
| Linux (Flatpak) | Auto-Claude-2.7.6-beta.5-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.
Roadmap
AI-assisted feature planning with competitor analysis and audience targeting.
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 |
Contributing
We welcome contributions! Please read CONTRIBUTING.md for:
- Development setup instructions
- Code style guidelines
- Testing requirements
- Pull request process
Community
- Discord - Join our community
- Issues - Report bugs or request features
- Discussions - Ask questions
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.
