André Mikalsen
3f8e16edb2
* fix: skip Claude Code onboarding for authenticated profiles When CLAUDE_CONFIG_DIR points to a profile directory, Claude Code reads .claude.json from that directory instead of ~/.claude.json. Profile configs created by `claude auth login` don't include hasCompletedOnboarding, causing the onboarding wizard to appear every time Claude Code is launched. Set hasCompletedOnboarding: true in the profile's .claude.json after successful authentication and before each Claude Code invocation. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * chore: clean up dead onboarding code paths and add tests Remove dead `needsOnboarding` UI branch from AuthTerminal.tsx and stale type declarations from types.ts, ipc.ts, terminal-api.ts. Remove unreachable `ensureOnboardingComplete` call from `handleOnboardingComplete` (guard prevents execution). Export `ensureOnboardingComplete` and add 9 unit tests covering all branches. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: allow project-switching shortcuts when terminal is focused xterm.js uses a hidden <textarea> (xterm-helper-textarea) for keyboard input. ProjectTabBar's keydown handler skipped all HTMLTextAreaElement targets, which prevented Cmd/Ctrl+1-9 project switching from working when a terminal had focus. Exclude xterm's textarea from the skip-filter since xterm already passes these shortcuts through via attachCustomKeyEventHandler. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: use atomic write to satisfy CodeQL insecure-temporary-file rule Write .claude.json via temp file + rename instead of direct writeFileSync to address CodeQL js/insecure-temporary-file false positive. The temp file is created with mode 0o600 (owner-only) and atomically renamed. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: prevent duplicate provider accounts and clean up dead onboarding API surface Add backend gate in PROVIDER_ACCOUNTS_SAVE to reject duplicate email+provider combinations with a user-friendly error. Clean up dead onTerminalOnboardingComplete IPC surface (preload, types, constants, mock) that was never fired after the onboarding flow was made proactive. Fix i18n compliance (hardcoded strings in handleFallbackTerminal, orphaned translation keys) and Codex OAuth silent error swallowing. Correct vi.mock paths in onboarding test file. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Aperant (formerly 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.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.8.0-beta.5-win32-x64.exe |
| macOS (Apple Silicon) | Auto-Claude-2.8.0-beta.5-darwin-arm64.dmg |
| macOS (Intel) | Auto-Claude-2.8.0-beta.5-darwin-x64.dmg |
| Linux | Auto-Claude-2.8.0-beta.5-linux-x86_64.AppImage |
| Linux (Debian) | Auto-Claude-2.8.0-beta.5-linux-amd64.deb |
| Linux (Flatpak) | Auto-Claude-2.8.0-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
Aperant/
├── apps/
│ └── desktop/ # Electron desktop application (TypeScript AI agent layer + UI)
├── guides/ # Additional documentation
└── scripts/ # Build utilities
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
Aperant 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 all 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 |
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
Aperant 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.
