Andy
f41f15e592
* auto-claude: subtask-1-1 - Create atomic-file.ts utility with writeFileAtomic, writeFileWithRetry, and readFileWithRetry Implements cross-platform atomic file write utilities for TypeScript: - writeFileAtomic: temp file + rename pattern for atomic writes - writeFileWithRetry: exponential backoff for Windows file locking errors (EACCES/EBUSY) - readFileWithRetry: read with retry logic for transient errors - writeJsonAtomic/writeJsonWithRetry: convenience wrappers for JSON operations Follows pattern from apps/backend/core/file_utils.py Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * auto-claude: subtask-1-2 - Create unit tests for atomic file operations - Created comprehensive test suite with 32 passing tests - Tests cover writeFileAtomic, writeFileWithRetry, readFileWithRetry - Tests cover writeJsonAtomic, writeJsonWithRetry - Tests verify basic operations, retry logic, options handling - Tests verify temp file cleanup and error handling - Tests verify AtomicFileError custom error class - All tests use integration-style approach to avoid ES module mocking issues Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * auto-claude: subtask-2-1 - Replace json.dump() in phases.py with write_json_atomic() Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * auto-claude: subtask-2-2 - Replace json.dump() in competitor_analyzer.py with write_json_atomic() * auto-claude: subtask-2-3 - Replace json.dump() in graph_integration.py with write_json_atomic() - Added import for write_json_atomic from core.file_utils - Replaced all json.dump() calls in _create_disabled_hints_file(), _save_hints(), and _save_error_hints() - Removed json module import as it's no longer needed - All JSON writes now use atomic file operations to prevent corruption * auto-claude: subtask-3-1 - Replace writeFileSync() in roadmap-handlers.ts with writeFileWithRetry() * auto-claude: subtask-4-1 - Wrap persistRoadmapProgress() with debounce (300ms) - Created debounce utility with leading + trailing edge support - Wraps persistRoadmapProgress() with 300ms debounce - Limits file writes to ~3-4 per second (leading: true, trailing: true) - Ensures immediate first write and final state persistence after updates - Reduces file system contention during rapid progress updates * Fix file-locking race conditions and QA review findings - Extract duplicated transientErrors to module-level TRANSIENT_ERROR_CODES constant - Fix debounce double-invocation bug: single call with leading+trailing no longer fires twice - Convert persistRoadmapProgress to async with writeFileWithRetry instead of writeFileSync - Store debounce cancel handle; cancel pending writes before clearRoadmapProgress - Replace readFileSync with readFileWithRetry in roadmap IPC handlers - Add withFileLock mutex for read-modify-write operations (SAVE, UPDATE_FEATURE, CONVERT_TO_SPEC) - Add comprehensive debounce.test.ts with 12 tests covering all modes Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * Fix atomic-file test failure on Windows The 'should throw error when write fails' test used '/invalid/path/...' which on Windows resolves to the current drive root (e.g. D:\invalid\...) where mkdir({ recursive: true }) succeeds. Replace with a path inside a regular file, which fails cross-platform since you can't mkdir inside a file. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * Fix leading-only debounce state reset and add retry tests - Fix leading-only mode: schedule timeout to reset lastCallTime so subsequent bursts re-trigger leading edge (was 'invoke once ever') - Add test verifying leading-only mode fires again after wait expires - Add atomic-file-retry.test.ts with mocked transient error tests: EBUSY retry + succeed, EACCES exhaust retries, EAGAIN read retry, ENOENT non-transient immediate failure - Add afterEach(vi.useRealTimers) to debounce tests to prevent leaks Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Sonnet 4.5 <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.2-win32-x64.exe |
| macOS (Apple Silicon) | Auto-Claude-2.7.6-beta.2-darwin-arm64.dmg |
| macOS (Intel) | Auto-Claude-2.7.6-beta.2-darwin-x64.dmg |
| Linux | Auto-Claude-2.7.6-beta.2-linux-x86_64.AppImage |
| Linux (Debian) | Auto-Claude-2.7.6-beta.2-linux-amd64.deb |
| Linux (Flatpak) | Auto-Claude-2.7.6-beta.2-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.
