Andy
8be0e6ff1a
* feat(sentry): add anonymous error reporting with privacy controls Integrate @sentry/electron for crash reporting in both main and renderer processes. Key features: - Enabled by default with clear privacy messaging during onboarding - Mid-session toggle via beforeSend hooks (no restart required) - Comprehensive path masking for macOS, Windows, and Linux usernames - Complete event sanitization: stack traces, breadcrumbs, tags, contexts, extra data, request info, and user info (cleared entirely) - Race condition prevention: events dropped until settings are loaded - Shared privacy utilities to eliminate code duplication - Settings toggle in Debug & Logs section with i18n support (en/fr) - New PrivacyStep in onboarding wizard explaining data collection Privacy approach: usernames masked from all paths, project paths remain visible for debugging (documented as intentional behavior). * feat(sentry): move DSN to environment variable for fork protection Previously the Sentry DSN was hardcoded, which caused forks to send errors to the original project's Sentry account. This created cost concerns and data pollution. Changes: - Remove hardcoded DSN from sentry-privacy.ts - Main process reads DSN from SENTRY_DSN env var - Add IPC handler to expose DSN to renderer process - Renderer fetches DSN via IPC (async initialization) - Add SENTRY_DSN and SENTRY_DEV documentation to .env.example Now forks without the env var have Sentry disabled, while official builds can inject it via CI/CD secrets. * fix(sentry): address PR review findings and add sample rate env vars PR Review fixes: - Fix path masking regex to handle paths at end of strings (lookahead) - Add error handling to PrivacyStep when save fails - Add user feedback when Sentry toggle fails in DebugSettings - Add .catch() handler for async Sentry initialization in main.tsx New features: - Add SENTRY_TRACES_SAMPLE_RATE env var (0.0-1.0, default 0.1) - Add SENTRY_PROFILES_SAMPLE_RATE env var (0.0-1.0, default 0.1) - Add getSentryConfig IPC to share config with renderer This allows controlling Sentry sampling via environment variables to prevent filling up error logs with duplicate issues. * fix(sentry): only mark settings loaded on successful load Fixes privacy violation where Sentry would send error reports even if user had opted out. Previously, markSettingsLoaded() was called in finally block regardless of success, causing the store to retain DEFAULT_APP_SETTINGS (sentryEnabled: true) on load failure while marking settings as "loaded". Now markSettingsLoaded() is only called inside the success condition, so if settings fail to load, Sentry's beforeSend drops all events (safe default).
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.2-win32-x64.exe |
| macOS (Apple Silicon) | Auto-Claude-2.7.2-darwin-arm64.dmg |
| macOS (Intel) | Auto-Claude-2.7.2-darwin-x64.dmg |
| Linux | Auto-Claude-2.7.2-linux-x86_64.AppImage |
| Linux (Debian) | Auto-Claude-2.7.2-linux-amd64.deb |
Beta Release
⚠️ Beta releases may contain bugs and breaking changes. View all releases
| Platform | Download |
|---|---|
| Windows | Auto-Claude-2.7.2-beta.10-win32-x64.exe |
| macOS (Apple Silicon) | Auto-Claude-2.7.2-beta.10-darwin-arm64.dmg |
| macOS (Intel) | Auto-Claude-2.7.2-beta.10-darwin-x64.dmg |
| Linux | Auto-Claude-2.7.2-beta.10-linux-x86_64.AppImage |
| Linux (Debian) | Auto-Claude-2.7.2-beta.10-linux-amd64.deb |
| Linux (Flatpak) | Auto-Claude-2.7.2-beta.10-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
- Python 3.12+ - Required for the backend and Memory Layer
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.
Configuration
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 |
GITLAB_TOKEN |
No | GitLab Personal Access Token for GitLab integration |
GITLAB_INSTANCE_URL |
No | GitLab instance URL (defaults to gitlab.com) |
LINEAR_API_KEY |
No | Linear API key for task sync |
Building from Source
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 start
System requirements for building:
- Node.js 24+
- Python 3.12+
- npm 10+
Installing dependencies by platform:
Windows
winget install Python.Python.3.12
winget install OpenJS.NodeJS.LTS
macOS
brew install python@3.12 node@24
Linux (Ubuntu/Debian)
sudo apt install python3.12 python3.12-venv
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
Linux (Fedora)
sudo dnf install python3.12 nodejs npm
See CONTRIBUTING.md for detailed development setup.
Building Flatpak
To build the Flatpak package, you need additional dependencies:
# Fedora/RHEL
sudo dnf install flatpak-builder
# Ubuntu/Debian
sudo apt install flatpak-builder
# Install required Flatpak runtimes
flatpak install flathub org.freedesktop.Platform//25.08 org.freedesktop.Sdk//25.08
flatpak install flathub org.electronjs.Electron2.BaseApp//25.08
# Build the Flatpak
cd apps/frontend
npm run package:flatpak
The Flatpak will be created in apps/frontend/dist/.
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 |
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.