* chore: update README version to 2.7.1
Updated the version badge and download links in the README to reflect the new release version 2.7.1, ensuring users have the correct information for downloading the latest builds.
* feat(releases): add beta release system with user opt-in
Implements a complete beta release workflow that allows users to opt-in
to receiving pre-release versions. This enables testing new features
before they're included in stable releases.
Changes:
- Add beta-release.yml workflow for creating beta releases from develop
- Add betaUpdates setting with UI toggle in Settings > Updates
- Add update channel support to electron-updater (beta vs latest)
- Extract shared settings-utils.ts to reduce code duplication
- Add prepare-release.yml workflow for automated release preparation
- Document beta release process in CONTRIBUTING.md and RELEASE.md
Users can enable beta updates in Settings > Updates, and maintainers
can trigger beta releases via the GitHub Actions workflow.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* workflow update
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
* fix(core): add task persistence, terminal handling, and HTTP 300 fixes
Consolidated bug fixes from PRs #168, #170, #171:
- Task persistence (#168): Scan worktrees for tasks on app restart
to prevent loss of in-progress work and wasted API credits. Tasks
in .worktrees/*/specs are now loaded and deduplicated with main.
- Terminal buttons (#170): Fix "Open Terminal" buttons silently
failing on macOS by properly awaiting createTerminal() Promise.
Added useTerminalHandler hook with loading states and error display.
- HTTP 300 errors (#171): Handle branch/tag name collisions that
cause update failures. Added validation script to prevent conflicts
before releases and user-friendly error messages with manual
download links.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(platform): add path resolution, spaces handling, and XDG support
This commit consolidates multiple bug fixes from community PRs:
- PR #187: Path resolution fix - Update path detection to find apps/backend
instead of legacy auto-claude directory after v2.7.2 restructure
- PR #182/#155: Python path spaces fix - Improve parsePythonCommand() to
handle quoted paths and paths containing spaces without splitting
- PR #161: Ollama detection fix - Add new apps structure paths for
ollama_model_detector.py script discovery
- PR #160: AppImage support - Add XDG Base Directory compliant paths for
Linux sandboxed environments (AppImage, Flatpak, Snap). New files:
- config-paths.ts: XDG path utilities
- fs-utils.ts: Filesystem utilities with fallback support
- PR #159: gh CLI PATH fix - Add getAugmentedEnv() utility to include
common binary locations (Homebrew, snap, local) in PATH for child
processes. Fixes gh CLI not found when app launched from Finder/Dock.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: address CodeRabbit/Cursor review comments on PR #185
Fixes from code review:
- http-client.ts: Use GITHUB_CONFIG instead of hardcoded owner in HTTP 300 error message
- validate-release.js: Fix substring matching bug in branch detection that could cause false positives (e.g., v2.7 matching v2.7.2)
- bump-version.js: Remove unnecessary try-catch wrapper (exec() already exits on failure)
- execution-handlers.ts: Capture original subtask status before mutation for accurate logging
- fs-utils.ts: Add error handling to safeWriteFile with proper logging
Dismissed as trivial/not applicable:
- config-paths.ts: Exhaustive switch check (over-engineering)
- env-utils.ts: PATH priority documentation (existing comments sufficient)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: address additional CodeRabbit review comments (round 2)
Fixes from second round of code review:
- fs-utils.ts: Wrap test file cleanup in try-catch for Windows file locking
- fs-utils.ts: Add error handling to safeReadFile for consistency with safeWriteFile
- http-client.ts: Use GITHUB_CONFIG in fetchJson (missed in first round)
- validate-release.js: Exclude symbolic refs (origin/HEAD -> origin/main) from branch check
- python-detector.ts: Return cleanPath instead of pythonPath for empty input edge case
Dismissed as trivial/not applicable:
- execution-handlers.ts: Redundant checkSubtasksCompletion call (micro-optimization)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
* fix: analyzer Python compatibility and settings integration
Fixes project index analyzer failing with TypeError on Python type hints.
Changes:
- Added 'from __future__ import annotations' to all analysis modules
- Fixed project discovery to support new analyzer JSON format
- Read Python path directly from settings.json instead of pythonEnvManager
- Added stderr/stdout logging for analyzer debugging
Resolves 'Discovered 0 files' and 'TypeError: unsupported operand type' issues.
* auto-claude: subtask-1-1 - Hide status badge when execution phase badge is showing
When a task has an active execution (planning, coding, etc.), the
execution phase badge already displays the correct state with a spinner.
The status badge was also rendering, causing duplicate/confusing badges
(e.g., both "Planning" and "Pending" showing at the same time).
This fix wraps the status badge in a conditional that only renders when
there's no active execution, eliminating the redundant badge display.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(ipc): remove unused pythonEnvManager parameter and fix ES6 import
Address CodeRabbit review feedback:
- Remove unused pythonEnvManager parameter from registerProjectContextHandlers
and registerContextHandlers (the code reads Python path directly from
settings.json instead)
- Replace require('electron').app with proper ES6 import for consistency
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* chore(lint): fix import sorting in analysis module
Run ruff --fix to resolve I001 lint errors after merging develop.
All 23 files in apps/backend/analysis/ now have properly sorted imports.
---------
Co-authored-by: Joris Slagter <mail@jorisslagter.nl>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
When a user drags a running task back to Planning (or any other column),
the process was not being stopped, leaving a "ghost" process that
prevented deletion with "Cannot delete a running task" error.
Now the task process is automatically killed when status changes away
from in_progress, ensuring the process state stays in sync with the UI.
* fix: Linear API authentication and GraphQL types
- Remove Bearer prefix from Authorization header (Linear API keys are sent directly)
- Change GraphQL variable types from String! to ID! for teamId and issue IDs
- Improve error handling to show detailed Linear API error messages
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: Radix Select empty value error in Linear import modal
Use '__all__' sentinel value instead of empty string for "All projects"
option, as Radix Select does not allow empty string values.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat: add CodeRabbit configuration file
Introduce a new .coderabbit.yaml file to configure CodeRabbit settings, including review profiles, automatic review options, path filters, and specific instructions for different file types. This enhances the code review process by providing tailored guidelines for Python, TypeScript, and test files.
* fix: correct GraphQL types for Linear team queries
Linear API uses different types for different queries:
- team(id:) expects String!
- issues(filter: { team: { id: { eq: } } }) expects ID!
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: refresh task list after Linear import
Call loadTasks() after successful Linear import to update the kanban
board without requiring a page reload.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* cleanup
* cleanup
* fix: address CodeRabbit review comments for Linear integration
- Fix unsafe JSON parsing: check response.ok before parsing JSON to handle
non-JSON error responses (e.g., 503 from proxy) gracefully
- Use ID! type instead of String! for teamId in LINEAR_GET_PROJECTS query
for GraphQL type consistency
- Remove debug console.log (ESLint config only allows warn/error)
- Refresh task list on partial import success (imported > 0) instead of
requiring full success
- Fix pre-existing TypeScript and lint issues blocking commit
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* version sync logic
* lints for develop branch
* chore: update CI workflow to include develop branch
- Modified the CI configuration to trigger on pushes and pull requests to both main and develop branches, enhancing the workflow for development and integration processes.
* fix: update project directory auto-detection for apps/backend structure
The project directory auto-detection was checking for the old `auto-claude/`
directory name but needed to check for `apps/backend/`. When running from
`apps/backend/`, the directory name is `backend` not `auto-claude`, so the
check would fail and `project_dir` would incorrectly remain as `apps/backend/`
instead of resolving to the project root (2 levels up).
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: use GraphQL variables instead of string interpolation in LINEAR_GET_ISSUES
Replace direct string interpolation of teamId and linearProjectId with
proper GraphQL variables. This prevents potential query syntax errors if
IDs contain special characters like double quotes, and aligns with the
variable-based approach used elsewhere in the file.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(ui): correct logging level and await loadTasks on import complete
- Change console.warn to console.log for import success messages
(warn is incorrect severity for normal completion)
- Make onImportComplete callback async and await loadTasks()
to prevent potential unhandled promise rejections
Applies CodeRabbit review feedback across 3 LinearTaskImportModal usages.
* fix(hooks): use POSIX-compliant find instead of bash glob
The pre-commit hook uses #!/bin/sh but had bash-specific ** glob
pattern for staging ruff-formatted files. The ** pattern only works
in bash with globstar enabled - in POSIX sh it expands literally
and won't match subdirectories, causing formatted files in nested
directories to not be staged.
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Removes the legacy 'auto-claude' path from the possiblePaths array
in agent-process.ts. This path was from before the monorepo
restructure (v2.7.2) and is no longer needed.
The legacy path was causing spec_runner.py to be looked up at the
wrong location:
- OLD (wrong): /path/to/auto-claude/auto-claude/runners/spec_runner.py
- NEW (correct): /path/to/apps/backend/runners/spec_runner.py
This aligns with the new monorepo structure where all backend code
lives in apps/backend/.
Fixes#147
Co-authored-by: Joris Slagter <mail@jorisslagter.nl>
Implemented promise queue pattern in PythonEnvManager to handle
concurrent initialization requests. Previously, multiple simultaneous
requests (e.g., startup + merge) would fail with "Already
initializing" error.
Also fixed parsePythonCommand() to handle file paths with spaces by
checking file existence before splitting on whitespace.
Changes:
- Added initializationPromise field to queue concurrent requests
- Split initialize() into public and private _doInitialize()
- Enhanced parsePythonCommand() with existsSync() check
Co-authored-by: Joris Slagter <mail@jorisslagter.nl>
* feat(ollama): add real-time download progress tracking for model downloads
Implement comprehensive download progress tracking with:
- NDJSON parsing for streaming progress data from Ollama API
- Real-time speed calculation (MB/s, KB/s, B/s) with useRef for delta tracking
- Time remaining estimation based on download speed
- Animated progress bars in OllamaModelSelector component
- IPC event streaming from main process to renderer
- Proper listener management with cleanup functions
Changes:
- memory-handlers.ts: Parse NDJSON from Ollama stderr, emit progress events
- OllamaModelSelector.tsx: Display progress bars with speed and time remaining
- project-api.ts: Implement onDownloadProgress listener with cleanup
- ipc.ts types: Define onDownloadProgress listener interface
- infrastructure-mock.ts: Add mock implementation for browser testing
This allows users to see real-time feedback when downloading Ollama models,
including percentage complete, current download speed, and estimated time remaining.
* test: add focused test coverage for Ollama download progress feature
Add unit tests for the critical paths of the real-time download progress tracking:
- Progress calculation tests (52 tests): Speed/time/percentage calculations with comprehensive edge case coverage (zero speeds, NaN, Infinity, large numbers)
- NDJSON parser tests (33 tests): Streaming JSON parsing from Ollama, buffer management for incomplete lines, error handling
All 562 unit tests passing with clean dependencies. Tests focus on critical mathematical logic and data processing - the most important paths that need verification.
Test coverage:
✅ Speed calculation and formatting (B/s, KB/s, MB/s)
✅ Time remaining calculations (seconds, minutes, hours)
✅ Percentage clamping (0-100%)
✅ NDJSON streaming with partial line buffering
✅ Invalid JSON handling
✅ Real Ollama API responses
✅ Multi-chunk streaming scenarios
* docs: add comprehensive JSDoc docstrings for Ollama download progress feature
- Enhanced OllamaModelSelector component with detailed JSDoc
* Documented component props, behavior, and usage examples
* Added docstrings to internal functions (checkInstalledModels, handleDownload, handleSelect)
* Explained progress tracking algorithm and useRef usage
- Improved memory-handlers.ts documentation
* Added docstring to main registerMemoryHandlers function
* Documented all Ollama-related IPC handlers (check-status, list-embedding-models, pull-model)
* Added JSDoc to executeOllamaDetector helper function
* Documented interface types (OllamaStatus, OllamaModel, OllamaEmbeddingModel, OllamaPullResult)
* Explained NDJSON parsing and progress event structure
- Enhanced test file documentation
* Added docstrings to NDJSON parser test utilities with algorithm explanation
* Documented all calculation functions (speed, time, percentage)
* Added detailed comments on formatting and bounds-checking logic
- Improved overall code maintainability
* Docstring coverage now meets 80%+ threshold for code review
* Clear explanation of progress tracking implementation details
* Better context for future maintainers working with download streaming
* feat: add batch task creation and management CLI commands
- Handle batch task creation from JSON files
- Show status of all specs in project
- Cleanup tool for completed specs
- Full integration with new apps/backend structure
- Compatible with implementation_plan.json workflow
* test: add batch task test file and testing checklist
- batch_test.json: Sample tasks for testing batch creation
- TESTING_CHECKLIST.md: Comprehensive testing guide for Ollama and batch tasks
- Includes UI testing steps, CLI testing steps, and edge cases
- Ready for manual and automated testing
* chore: update package-lock.json to match v2.7.2
* test: update checklist with verification results and architecture validation
* docs: add comprehensive implementation summary for Ollama + Batch features
* docs: add comprehensive Phase 2 testing guide with checklists and procedures
* docs: add NEXT_STEPS guide for Phase 2 testing
* fix: resolve merge conflict in project-api.ts from Ollama feature cherry-pick
* fix: remove duplicate Ollama check status handler registration
* test: update checklist with Phase 2 bug findings and fixes
---------
Co-authored-by: ray <ray@rays-MacBook-Pro.local>
* refactor: restructure project to Apps/frontend and Apps/backend
- Move auto-claude-ui to Apps/frontend with feature-based architecture
- Move auto-claude to Apps/backend
- Switch from pnpm to npm for frontend
- Update Node.js requirement to v24.12.0 LTS
- Add pre-commit hooks for lint, typecheck, and security audit
- Add commit-msg hook for conventional commits
- Fix CommonJS compatibility issues (postcss.config, postinstall scripts)
- Update README with comprehensive setup and contribution guidelines
- Configure ESLint to ignore .cjs files
- 0 npm vulnerabilities
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
* feat(refactor): clean code and move to npm
* feat(refactor): clean code and move to npm
* chore: update to v2.7.0, remove Docker deps (LadybugDB is embedded)
* feat: v2.8.0 - update workflows and configs for Apps/ structure, npm
* fix: resolve Python lint errors (F401, I001)
* fix: update test paths for Apps/backend structure
* fix: add missing facade files and update paths for Apps/backend structure
- Fix ruff lint error I001 in auto_claude_tools.py
- Create missing facade files to match upstream (agent, ci_discovery, critique, etc.)
- Update test paths from auto-claude/ to Apps/backend/
- Update .pre-commit-config.yaml paths for Apps/ structure
- Add pytest to pre-commit hooks (skip slow/integration/Windows-incompatible tests)
- Fix Unicode encoding in test_agent_architecture.py for Windows
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
* feat: improve readme
* fix: new path
* fix: correct release workflow and docs for Apps/ restructure
- Fix ARM64 macOS build: pnpm → npm, auto-claude-ui → Apps/frontend
- Fix artifact upload paths in release.yml
- Update Node.js version to 24 for consistency
- Update CLI-USAGE.md with Apps/backend paths
- Update RELEASE.md with Apps/frontend/package.json paths
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* refactor: rename Apps/ to apps/ and fix backend path resolution
- Rename Apps/ folder to apps/ for consistency with JS/Node conventions
- Update all path references across CI/CD workflows, docs, and config files
- Fix frontend Python path resolver to look for 'backend' instead of 'auto-claude'
- Update path-resolver.ts to correctly find apps/backend in development mode
This completes the Apps restructure from PR #122 and prepares for v2.8.0 release.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(electron): correct preload script path from .js to .mjs
electron-vite builds the preload script as ESM (index.mjs) but the main
process was looking for CommonJS (index.js). This caused the preload to
fail silently, making the app fall back to browser mock mode with fake
data and non-functional IPC handlers.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* - Introduced `dev:debug` script to enable debugging during development.
- Added `dev:mcp` script for running the frontend in MCP mode.
These enhancements streamline the development process for frontend developers.
* refactor(memory): make Graphiti memory mandatory and remove Docker dependency
Memory is now a core component of Auto Claude rather than optional:
- Python 3.12+ is required for the backend (not just memory layer)
- Graphiti is enabled by default in .env.example
- Removed all FalkorDB/Docker references (migrated to embedded LadybugDB)
- Deleted guides/DOCKER-SETUP.md and docker-handlers.ts
- Updated onboarding UI to remove "optional" language
- Updated all documentation to reflect LadybugDB architecture
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat: add cross-platform Windows support for npm scripts
- Add scripts/install-backend.js for cross-platform Python venv setup
- Auto-detects Python 3.12 (py -3.12 on Windows, python3.12 on Unix)
- Handles platform-specific venv paths
- Add scripts/test-backend.js for cross-platform pytest execution
- Update package.json to use Node.js scripts instead of shell commands
- Update CONTRIBUTING.md with correct paths and instructions:
- apps/backend/ and apps/frontend/ paths
- Python 3.12 requirement (memory system now required)
- Platform-specific install commands (winget, brew, apt)
- npm instead of pnpm
- Quick Start section with npm run install:all
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* remove doc
* fix(frontend): correct Ollama detector script path after apps restructure
The Ollama status check was failing because memory-handlers.ts
was looking for ollama_model_detector.py at auto-claude/ but the
script is now at apps/backend/ after the directory restructure.
This caused "Ollama not running" to display even when Ollama was
actually running and accessible.
* chore: bump version to 2.7.2
Downgrade version from 2.8.0 to 2.7.2 as the Apps/ restructure
is better suited as a patch release rather than a minor release.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* chore: update package-lock.json for Windows compatibility
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs(contributing): add hotfix workflow and update paths for apps/ structure
Add Git Flow hotfix workflow documentation with step-by-step guide
and ASCII diagram showing the branching strategy.
Update all paths from auto-claude/auto-claude-ui to apps/backend/apps/frontend
and migrate package manager references from pnpm to npm to match the
new project structure.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(ci): remove duplicate ARM64 build from Intel runner
The Intel runner was building both x64 and arm64 architectures,
while a separate ARM64 runner also builds arm64 natively. This
caused duplicate ARM64 builds, wasting CI resources.
Now each runner builds only its native architecture:
- Intel runner: x64 only
- ARM64 runner: arm64 only
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---------
Co-authored-by: Alex Madera <e.a_madera@hotmail.com>
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
- Add comprehensive branching strategy documentation
- Explain main, develop, feature, fix, release, and hotfix branches
- Clarify that all PRs should target develop (not main)
- Add release process documentation for maintainers
- Update PR process to branch from develop
- Expand table of contents with new sections
* feat(memory): replace FalkorDB with LadybugDB embedded database
Remove Docker dependency for Graphiti memory integration by switching
to LadybugDB, an embedded graph database that works via monkeypatch
with graphiti-core's KuzuDriver.
Changes:
- Remove all FalkorDB configuration and connection code
- Simplify config to use GRAPHITI_DB_PATH for local storage
- Update requirements to use real_ladybug + graphiti-core
- Update documentation for Python 3.12+ requirement
This makes the memory system much simpler to set up - no Docker needed.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* chore: remove docker-compose.yml (FalkorDB no longer used)
FalkorDB has been replaced with LadybugDB embedded database,
so Docker is no longer required for the memory integration.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat: add automated release workflow with code signing
- Add release.yml workflow triggered on version tags (v*)
- Support manual dry-run builds via workflow_dispatch
- Build for macOS (arm64 + x64), Windows, and Linux
- macOS code signing with Developer ID certificate
- macOS notarization support for Gatekeeper approval
- Add entitlements.mac.plist for hardened runtime
- Generate SHA256 checksums for all release artifacts
- Auto-generate changelog from PR labels
- Add pnpm caching to CI workflow for faster builds
- Add lint, typecheck, and build steps to CI
- Update package.json with artifactName for consistent naming
- Fix extraResources filter to exclude test venvs
Artifacts will be named: Auto-Claude-{version}-{platform}-{arch}.{ext}
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* refactor: replace Docker/FalkorDB with embedded LadybugDB for memory system
This major refactoring eliminates the Docker dependency for the memory system
by switching from FalkorDB to LadybugDB (embedded graph database).
Backend changes:
- Add query_memory.py: Python CLI for memory queries via subprocess
- Add kuzu_driver_patched.py: Patched Kuzu driver with FTS index support
- Add ollama_model_detector.py: Auto-detect Ollama embedding models
- Update client.py to use patched driver for proper FTS functionality
- Fix parameter handling for LadybugDB compatibility
Frontend changes:
- Add memory-service.ts: Node.js service wrapping Python subprocess
- Add memory-handlers.ts: IPC handlers for memory operations
- Add api-validation-service.ts: Validate LLM/embedder API keys
- Remove docker-service.ts and falkordb-service.ts (no longer needed)
- Update MemoryBackendSection with multi-provider embedder support
- Update InfrastructureStatus to show LadybugDB status
- Simplify GraphitiStep onboarding (no Docker setup required)
Key improvements:
- Zero Docker dependency - fully embedded database
- Multi-provider embedder support (OpenAI, Gemini, Voyage, Ollama, Azure)
- Hybrid RAG with semantic search, FTS, and graph traversal
- Automatic FTS index creation via patched driver
- Python 3.12 compatibility (LadybugDB requirement)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: correct model name and release workflow conditionals
Bug fixes:
- Fix model ID: claude-sonnet-4-5-latest → claude-sonnet-4-5-20250514
(using dated version for stability)
- Fix release workflow: add github.event_name checks before accessing
inputs.dry_run to prevent errors on tag push events
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat: add Ollama embedding model support with auto-detected dimensions
- Add known model lookup table for popular Ollama embedding models:
- embeddinggemma (768 dim) - Google's lightweight model
- qwen3-embedding:0.6b/4b/8b (1024/2560/4096 dim) - Qwen3 series
- nomic-embed-text, mxbai-embed-large, bge-large, all-minilm
- Auto-detect embedding dimensions for known models (no need to set OLLAMA_EMBEDDING_DIM)
- Fix config validation to not require OLLAMA_EMBEDDING_DIM for known models
- Fix PatchedKuzuDriver to set _database attribute (required by Graphiti)
- Fix get_status_summary to use db_path instead of deprecated falkordb_host
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* refactor: rebrand memory system UI and simplify configuration
- Rename "Graphiti" to "Memory" throughout UI
- Remove LLM provider selection (Claude SDK handles RAG)
- Keep embedding provider selection (OpenAI, Ollama, Voyage, Google, Azure)
- Add Ollama model pull/download support
- Change default storage path from ~/.auto-claude/graphs to ~/.auto-claude/memories
- Make embedding provider fields conditional based on selection
- Add OllamaModelSelector component with auto-detection
- Create simplified MemoryStep for onboarding wizard
- Update SecuritySettings with provider-specific field rendering
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(ui): replace Unix shell syntax with cross-platform git commands
Fixes#90
Worktrees were showing "0" for all file changes on Windows because
Unix shell constructs (`2>/dev/null || echo`) are invalid in cmd.exe.
Changes:
- Replace `2>/dev/null || echo` with TypeScript try-catch
- Add `stdio: ['pipe', 'pipe', 'pipe']` to capture stderr
- Fix 7 locations in worktree-handlers.ts:
- git rev-list --count (2 locations)
- git diff --stat
- git diff --numstat
- git diff --name-status
- git diff --shortstat
- git merge-base --is-ancestor
The error "The system cannot find the path specified" was caused by
cmd.exe trying to interpret `/dev/null` as a literal file path.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* fix(cli): update graphiti status display for LadybugDB
After migrating from FalkorDB (Docker-based) to LadybugDB (embedded),
the validate_environment function tried to access 'host' and 'port'
keys that no longer exist in the graphiti status dictionary.
Changes:
- Replace host:port display with db_path for embedded database
- Use .get() for safe key access
This fixes a KeyError crash when running auto-claude builds with
Graphiti memory enabled.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* fix: improve Ollama UX in memory settings
- Replace manual Ollama config with OllamaModelSelector component
- Remove Base URL field (auto-detected from Ollama)
- Remove manual embedding dimension input (auto-detected from model)
- Show only installed models as selectable options
- Add download buttons for recommended models not yet installed
- Make embeddinggemma the recommended default model
- Remove qwen3-embedding from recommendations (focus on quality models)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* chore: update CI and release workflows, remove changelog config
- Removed the obsolete changelog configuration file.
- Updated CI workflow to use `pnpm run test` instead of `pnpm test`.
- Modified release workflow to use `pnpm install --frozen-lockfile` for consistent dependency installation.
- Enhanced artifact handling by validating the presence of build artifacts before proceeding.
These changes streamline the workflows and improve reliability in the build process.
* fix: resolve all CI failures in PR #100
Python lint fixes (ruff):
- Fix import sorting in kuzu_driver_patched.py, ollama_model_detector.py, query_memory.py
- Add noqa: F401 for kuzu import used only for availability check
Frontend:
- Update pnpm-lock.yaml to remove ioredis dependencies
Test fixes:
- Update test_graphiti.py to reflect new multi-provider architecture
- Embedder is now optional (keyword search fallback works)
- LLM provider validation removed (Claude SDK handles RAG)
- Fix FalkorDB references to LadybugDB (db_path instead of host/port)
Config consistency:
- Fix get_graphiti_status() to be consistent with is_valid()
- Embedder errors are now warnings, not blockers
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* refactor: update memory test suite for LadybugDB
Replace FalkorDB-based tests with LadybugDB (embedded database) tests:
- test_ladybugdb_connection() - Verify embedded DB works
- test_save_episode() - Save test data to graph
- test_keyword_search() - Keyword fallback (no embeddings needed)
- test_semantic_search() - Vector search with embeddings
- test_ollama_embeddings() - Direct Ollama embedding test
- test_graphiti_memory_class() - Full wrapper class test
- test_database_contents() - Debug view of DB contents
Usage:
python integrations/graphiti/test_graphiti_memory.py --test ollama
python integrations/graphiti/test_graphiti_memory.py --test connection
python integrations/graphiti/test_graphiti_memory.py # all tests
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: resolve remaining CI failures
Python:
- Add missing blank line after imports in query_memory.py (ruff I001)
TypeScript:
- Fix mock getBestAvailableProfile signature to accept optional parameter
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: remove f-string prefixes from strings without placeholders
Fixes ruff F541 errors in test_graphiti_memory.py
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* style: apply ruff formatting to 4 files
Auto-formatted kuzu_driver_patched.py and test_graphiti_memory.py
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: address CodeRabbit review comments from PR #100
- release.yml: Fix changelog output property (outputs.body not outputs.changelog)
- config.py: Update Anthropic model to generic claude-sonnet-4-5 identifier
- api-validation-service.ts: Fix error message to include both sk- and sess- prefixes
- ci.yml: Add quotes around command substitution for safety
- OllamaModelSelector.tsx: Add error logging to catch block
- OllamaModelSelector.tsx: Add AbortController cleanup pattern for unmount
- SecuritySettings.tsx: Add useEffect to sync showOpenAIKey prop changes
- SecuritySettings.tsx: Fix stale state in toggleShowApiKey
- SecuritySettings.tsx: Add aria-labels to password visibility buttons
Verified: nomic-embed-text uses 768 dimensions (CodeRabbit was incorrect about 1024)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs: add CodeRabbit review response tracking
Document rejected CodeRabbit suggestions with justification:
- nomic-embed-text uses 768 dims (not 1024 as claimed)
- MemoryStep checkmark UX is intentional design
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: sort imports in memory.py for ruff I001
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: address additional CodeRabbit review comments
Security fixes:
- kuzu_driver_patched.py: Add try/finally blocks for connection cleanup
- query_memory.py: Use parameterized queries to prevent Cypher injection
- query_memory.py: Use public get_validation_errors() instead of private method
- release.yml: Use ./* glob pattern to prevent option injection
Code quality:
- ollama_model_detector.py: Fix type annotation (str | None)
- cleanup-version-branches.sh: Fix empty tag count edge case
- config.py: Remove unused _validate_llm_provider method
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: update test and apply ruff formatting
- Remove test assertion for deleted _validate_llm_provider method
- Apply ruff format to query_memory.py
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: address CodeRabbit review feedback
- kuzu_driver_patched.py: Simplify multi-line f-string to single line
- config.py: Clarify LadybugDB requires Python 3.12+ in docstrings
- ci.yml: Fix pnpm store path echo command quoting
- test_graphiti.py: Use public API get_validation_errors() instead of private method
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat: add embedding provider change detection and fix import ordering
Graphiti improvements:
- Add provider change detection in GraphitiMemory.initialize()
- Warn users when embedding provider changes to prevent dimension mismatches
- Guide users to run migration script or reset state
- Add test_provider_naming.py demo script for provider-specific database naming
Code quality fixes:
- Move inline `import re` to module top in query_memory.py
- Alphabetically order standard library imports (PEP8 compliance)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(ci): quote GITHUB_OUTPUT for shell safety
Quote the $GITHUB_OUTPUT variable in the pnpm store path
echo command to safely handle paths containing spaces.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: add GH_TOKEN and homepage for release workflow
- Add GH_TOKEN to all package steps (required for electron-builder to download native prebuilds)
- Add homepage and repository fields to package.json (required for Linux builds)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: add author email for Linux builds
electron-builder FPM target requires author email for .deb packages
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: make macOS notarization optional
Notarization can fail due to certificate issues - don't block the build.
Unsigned DMGs still work, users just see a security warning.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: save notarization logs to private artifact instead of public logs
- Captures Apple notarization failure details in downloadable artifact
- Keeps sensitive paths and info out of public CI logs
- Only repo collaborators can access the notarization-logs artifact
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: respect user's memory enabled flag in query_memory CLI
Remove the forced `config.enabled = True` override that ignored user's
explicit disable choice. The CLI tool should respect the enabled flag -
callers using the semantic-search command are explicitly requesting
memory functionality.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: improve migrate_embeddings robustness and correctness
- Add proper cleanup of source client when target initialization fails
- Fix database name derivation to use source provider's signature
instead of incorrectly using current config's signature
- Add validation to prevent no-op migration between same providers
- Remove unused imports (json, Optional, GraphitiState)
- Fix ruff formatting issues (line length)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* style: fix ruff linting errors in graphiti queries
- Remove f-string prefix from strings without placeholders
- Fix line length formatting issues
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: use shell guard for notarization credentials check
The step-level `if: env.APPLE_ID != ''` condition was evaluated before
the step's env block was available, causing notarization to always be
skipped. Replace with a runtime shell guard that checks the environment
variable when the step actually runs.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: allow @lydell/node-pty build scripts in pnpm v10
pnpm v10 blocks dependency lifecycle scripts by default. Add
@lydell/node-pty to onlyBuiltDependencies array so its native
module build scripts can run during installation.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(ui): add project tab bar from PR #101
Cherry-picked from PR #101 for testing:
- Add tab state management to project store
- Create ProjectTabBar and SortableProjectTab components
- Remove project dropdown from Sidebar
- Add drag-and-drop tab reordering
- Include unit tests for tab functionality
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* chore: simplify notarization step after successful setup
Remove debug logging and notarization-logs artifact upload now that
Developer ID Application certificate is properly configured.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: check APPLE_ID in shell instead of workflow if condition
secrets context cannot be used directly in if expressions.
Check env var in shell script instead.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(ui): change agent profile fallback from 'Balanced' to 'Auto (Optimized)'
The getProfileDisplay() function in AgentProfileSelector had a defensive
fallback that incorrectly displayed "Balanced" when no profile was found.
Changed to display "Auto (Optimized)" to match the actual default profile
configured in DEFAULT_APP_SETTINGS.
This ensures consistency with the intended default behavior where fresh
users should see "Auto (Optimized)" as their agent profile selection.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* refactor(ui): simplify reference files and images handling in task modal
Remove separate reference files and images sections from the new task modal.
Images are now displayed as small clickable thumbnails directly below the
description field, and files can be referenced via @mentions in the description.
- Remove "Reference Images" toggle and dedicated ImageUpload section
- Remove "Referenced Files" section and ReferencedFilesSection component usage
- Add inline thumbnail display (64x64px) below description with remove buttons
- Update hint text to clarify drag & drop and paste functionality
- Clean up unused imports and state variables
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* chore: use GitHub noreply email for author field
Prevents spam while maintaining traceability for open source project.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: create Python venv in userData for packaged apps
On Linux AppImages, the bundled resources directory is read-only,
which prevented venv creation. Now packaged apps store the venv in
userData (~/.config/auto-claude-ui on Linux) which is always writable.
This follows XDG conventions and fixes the Arch Linux AppImage issue.
Fixes: venv creation failure on Linux AppImage
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(ui): add keyboard shortcuts and tooltips for project tabs
Add standard browser/editor-style keyboard shortcuts for tab navigation:
- Cmd/Ctrl+1-9 to switch to specific tabs
- Cmd/Ctrl+Tab/Shift+Tab to cycle through tabs
- Cmd/Ctrl+W to close current tab
Replace native title tooltips with Radix tooltips that:
- Show after 200ms instead of ~1s native delay
- Display shortcuts in styled kbd badges
- Match app design with smooth animations
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat: improve task creation UX with @ autocomplete and better drag-drop
Fixes three UX issues reported by users:
1. Add @ file autocomplete in task description
- Type @ to see file suggestions
- Filters files as you type
- Keyboard navigation (arrows, Enter, Escape)
- Shows file path for disambiguation
2. Fix file browser scroll in project explorer
- Remove conflicting ScrollArea wrapper
- Let virtualizer handle scrolling directly
- Files now visible after expanding deep folders
3. Add auto-scroll during drag-and-drop
- Scroll form container when dragging near edges
- Makes it possible to drag files to textarea when scrolled out of view
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(agent): enhance task restart functionality with new profile support
- Updated `restartTask` method to accept an optional `newProfileId` parameter, allowing for profile swapping during task restarts.
- Added logic to set the active profile if a new profile ID is provided.
- Adjusted event handling for `auto-swap-restart-task` to pass the new profile ID.
fix(agent): correct source type in rate limit info for spec creation
- Changed source type from 'task' to 'roadmap' in `createSDKRateLimitInfo` calls for better clarity in spec creation context.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
* fix(ui): fix tab persistence and scope terminal shortcuts
Two fixes:
1. Tab persistence on restart: Added explicit handling for when no tabs
are open after app restart. Now auto-opens the first project tab
instead of showing empty tab bar.
2. Keyboard shortcut scoping: Cmd/Ctrl+T now behaves contextually:
- On Agent Terminals view: Opens new terminal (existing behavior)
- On other views (Kanban, etc.): Opens Add Project dialog
Added isActive prop to TerminalGrid to scope shortcuts to when
the terminal view is active.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: unify default database path to ~/.auto-claude/memories
The default path was inconsistent across files:
- utils.ts used 'graphs'
- memory-service.ts used 'memories'
- .env.example documented 'graphs'
Unified all to use 'memories' to match Python backend config.py.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* auto-claude: subtask-1-1 - Add projectPath prop to PreviewPanel and implement custom img component
- Added projectPath prop to PreviewPanel interface
- Implemented custom img component for ReactMarkdown that converts relative paths
(like .github/assets/...) to file:// URLs for Electron
- Updated ChangelogDetails to get selected project and pass its path to PreviewPanel
- Images now display correctly in preview mode while markdown source remains unchanged
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(merge): use stored baseBranch from task metadata for merge operations
Previously, merge logic hardcoded 'main' as the comparison branch when
detecting what files changed in a task. This broke the workflow where:
- Tasks branch FROM the configured default (main) or user-specified branch
- Tasks merge INTO the user's current working branch
Now the merge system:
1. Reads baseBranch from task_metadata.json (set during task creation)
2. Passes --base-branch to Python CLI for merge and merge-preview
3. Uses this for refresh_from_git() comparisons throughout the merge pipeline
4. Falls back to auto-detection (main/master/develop) if not specified
Files modified across frontend (TypeScript) and backend (Python) to thread
the task_source_branch parameter through the entire merge flow.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(merge): increase AI merge timeout from 2 to 10 minutes
Large merge operations with many conflicting files were timing out
before completion. The AI merge resolution was processing files
successfully but hitting the 2-minute limit when handling 17+ files.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: use venv Python for terminal name generation
TerminalNameGenerator was using system Python which doesn't have
claude_agent_sdk installed. Now uses pythonEnvManager to get the
venv Python path where dependencies are installed.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: prevent task title from blocking edit/close buttons
Two issues were blocking the edit/close buttons in TaskDetailModal:
1. The title element was extending beyond its visual boundaries
- Added overflow-hidden to container and truncate to title
2. The Electron window's draggable region was capturing mouse events
- Added electron-no-drag class to the button container to allow
normal mouse interactions in that area
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: address CodeRabbit review issues
- memory-service.ts: Add app.getAppPath() path resolution for packaged
Electron apps. This ensures query_memory.py is found in both dev and
production builds, consistent with title-generator.ts pattern.
- MemoryStep.tsx: Make CheckCircle2 icon conditional on kuzuAvailable
state. Previously showed success checkmark even when database wasn't
available, misleading users.
- GitHubSetupModal.tsx: Fix incorrect API method name from
getStoredGitHubToken to getGitHubToken. Also adds existing auth
detection to skip already-completed authentication steps.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* Readme for installors
* Project tab persistence and github org init on project creation
* fix(ui): address CodeRabbit PR review issues
Fix actual bugs identified in PR #100 review:
- Fix race condition in memory-handlers.ts timeout handling by using
single timeout with proper cleanup and resolved flag
- Fix API key resolution in GraphitiStep.tsx to handle groq, azure_openai,
and ollama providers
- Add TabState interface and getTabState/saveTabState to ElectronAPI types
- Add mock implementations for browser development
Also includes:
- Exclude pnpm-lock.yaml from check-yaml (uses URLs with colons as keys)
- Auto-fixes from pre-commit hooks (trailing whitespace, EOF, ruff-format)
Note: nomic-embed-text dimension (768) and import ordering were verified
as correct - CodeRabbit suggestions were false positives.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(tests): update tab management tests for IPC-based persistence
The project store now uses IPC (saveTabState/getTabState) instead of
localStorage for tab state persistence. Updated tests to:
- Remove localStorage.setItem assertions (no longer used)
- Update restoreTabState test to reflect it's now a no-op (actual
loading happens via loadProjects → getTabState)
- Add getTabState/saveTabState mocks to test setup
This fixes the CI test failures where tests expected localStorage
calls but the implementation uses IPC.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Replace hardcoded 'python3' with findPythonCommand() to handle different Python installations (py -3, python, python3) across platforms. Fixes test failures on Windows and systems without python3 command.
Co-authored-by: danielfrey63 <daniel.frey@sbb.ch>
Fixes a critical bug where task specs were permanently deleted when a merge
operation failed, causing all tasks to disappear from the dashboard.
## Root Cause
When a merge fails or is rejected during human review, the cleanup code in
`execution-handlers.ts` ran `git clean -fd` to remove untracked files from
the failed merge. However, this command also deleted:
- `.auto-claude/specs/` - all task specifications and plans
- `.worktrees/` - isolated work environments
These directories are untracked (in .gitignore) and were being wiped out.
## Solution
Modified the `git clean` command to exclude critical Auto Claude directories:
```diff
- spawnSync('git', ['clean', '-fd'], ...)
+ spawnSync('git', ['clean', '-fd', '-e', '.auto-claude', '-e', '.worktrees'], ...)
```
This preserves:
- Task specs, plans, and QA reports in `.auto-claude/`
- Isolated worktree environments in `.worktrees/`
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: alpaslannbek <alpaslannbek@gmail.com>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Update start:packaged:mac and start:packaged:win scripts to use
'Auto-Claude' instead of 'Auto Claude' to match the productName change
from PR #65.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Format client.py to pass ruff line length check
- Consolidate redundant debug flag checks in index.ts
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Fix RoadmapFeatureStatus: default to 'under_review' not 'idea'
- Add target_audience type validation in roadmap phases
- Fix Puppeteer MCP logic: exclude Electron projects
- Unify debug flag to DEBUG (remove AUTO_CLAUDE_DEBUG)
- Fix drag overlay to show status instead of phase name
- Add test_roadmap_validation.py for type validation coverage
- Update .env.example documentation
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Bump the version of auto-claude-ui to 2.6.5 in both package.json and package-lock.json to reflect the latest release. This ensures consistency across the project dependencies.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
The Python backend now reads __version__ from auto-claude-ui/package.json
instead of hardcoding it. This ensures version consistency across the
entire project and simplifies the release process.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Fix Python import ordering in qa/loop.py and qa/reviewer.py
- Remove unused get_thinking_budget import from qa/loop.py
- Fix Python formatting in core/client.py, qa/loop.py, qa/reviewer.py
- Add version-manager mock in ipc-handlers.test.ts for consistent version testing
- Update roadmap-store tests to match current implementation behavior:
- updateFeatureLinkedSpec sets status to 'in_progress' not 'planned'
- getFeatureStats expects 'under_review' status (not deprecated 'idea')
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add UTF-8 encoding specification in project_context.py
- Fix TOCTOU race conditions by consolidating exists()/stat() calls
- Move re module import to top-level in prompts.py
- Remove duplicate IdeationConfig type, use shared types
- Add thinking level validation with warning logging
- Fix OAuth handler security: redact device codes from logs
- Remove redundant setTimeout in OAuth extraction flow
- Use explicit string replace instead of regex for clarity
Also adds test_thinking_level_validation.py for validation coverage.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Replace phase-based kanban columns with status workflow:
Under Review → Planned → In Progress → Done
- Add feature delete with confirmation dialog
- Add ROADMAP_STATUS_COLUMNS constant for column configuration
- Add useFeatureDelete and useRoadmapSave hooks
- Fix stale closure in useRoadmapSave to persist drag-drop changes
- Add ScrollArea to FeatureDetailPanel for proper scrolling
- Fix electron-no-drag on side panel headers to enable button clicks
- Add source tracking fields for future Canny.io integration
- Update SortableFeatureCard with phase badge and source indicators
- Add integration adapter interface for external feedback providers
- Update tests for new status-based architecture
The roadmap now uses a traditional status workflow while preserving
phase metadata for strategic planning views. This enables future
integration with feedback tools like Canny.io.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Bug 1: QA reviewer was using load_qa_reviewer_prompt() instead of
get_qa_reviewer_prompt(spec_dir, project_dir). This meant QA agents
never received dynamically-injected project-specific MCP tool docs
(e.g., Electron validation for Electron apps, Puppeteer for web).
Fix:
- Import get_qa_reviewer_prompt from prompts_pkg
- Add project_dir parameter to run_qa_agent_session()
- Update loop.py to pass project_dir to reviewer
- Remove redundant session context (now included in dynamic prompt)
Bug 2: Browser tool selection in client.py didn't check for
"not is_electron" when adding Puppeteer tools. If an Electron project
had ELECTRON_MCP_ENABLED=false, the elif would incorrectly add
Puppeteer tools to the Electron app.
Fix:
- Add "and not project_capabilities.get('is_electron')" to Puppeteer
condition, matching the pattern in permissions.py:138
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The QA agent was failing to update implementation_plan.json and the
system would retry up to 50 times with the same prompt, wasting API
calls and never making progress.
Root cause: When QA agent didn't update the file, we just retried
with the identical prompt - the agent had no idea what went wrong.
Changes:
- Add MAX_CONSECUTIVE_ERRORS limit (3) to prevent infinite loops
- Track consecutive errors and reset on valid responses
- Build error context with detailed instructions for self-correction
- Inject recovery prompt explaining exactly what went wrong and
what the agent must do (update implementation_plan.json with
qa_signoff object containing status: approved/rejected)
- Add diagnostic info to error messages (message count, tool count)
- Early exit after 3 consecutive errors with human escalation
Before: 50+ iterations, ~2 min wasted, no progress
After: Max 3 attempts with feedback, ~6s, agent knows what to fix
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add target_audience and target_audience.primary to roadmap validation
to prevent crash when this field is missing
- Unify all DEBUG environment variables to use DEBUG=true consistently
(removes AUTO_CLAUDE_DEBUG and DEBUG_UPDATER variants)
- Development mode (NODE_ENV=development) also enables debug logging
Closes#84🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The RoadmapHeader component crashed with "Cannot read properties of
undefined (reading 'primary')" when roadmap.targetAudience was not
yet populated. Added defensive null check to prevent black screen.
Closes#84🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add feature-specific model and thinking level configuration for Insights,
Ideation, and Roadmap features in the "Other Agent Settings" section.
Frontend changes:
- Add FeatureModelConfig and FeatureThinkingConfig types
- Add DEFAULT_FEATURE_MODELS and DEFAULT_FEATURE_THINKING constants
- Add feature settings UI in GeneralSettings "Other Agent Settings" section
- Remove redundant "Other Features" collapsible from AgentProfileSettings
Backend wiring:
- Update IPC handlers to read feature settings from settings.json
- Pass model/thinking-level args to ideation and roadmap Python runners
- Add RoadmapConfig type for passing config through agent manager
Python backend fixes:
- Fix hardcoded thinking levels in coder.py, planner.py, and qa/loop.py
to use phase-specific settings from task_metadata.json
- Add --thinking-level CLI arg to ideation_runner.py and roadmap_runner.py
- Update ideation and roadmap generators to use configured thinking budget
- Fix spec orchestrator to use user's configured thinking level
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Changed default phase models to use 'opus' for all phases, enhancing quality across spec creation, planning, coding, and QA.
- Updated thinking levels for each phase, introducing 'ultrathink' for spec creation and adjusting coding and QA levels to 'low' for faster iterations.
This refactor aims to optimize the overall performance and quality of the Auto profile.
- Remove unconditional auth logging in oauth-handlers.ts to prevent
sensitive device codes from appearing in production logs
- Add useEffect state sync in CustomModelModal to prevent stale values
when modal reopens with updated config
- Remove duplicate browser tool additions in client.py (already handled
by permissions._get_qa_mcp_tools)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Run pre-commit checks: fixed unused import in cli/utils.py,
sorted imports in prompts_pkg/__init__.py, and applied ruff
formatting to 6 Python files. All tests pass (1140 passed).
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Write conversation history to temp file instead of command-line arg
- Add --history-file argument to insights_runner.py
- Cleanup temp file after process completes
Fixes#58🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Refine DEVICE_CODE_PATTERN to require a separator (hyphen or space) between code segments to prevent false matches.
- Update parseDeviceCode function to normalize space-separated codes to the expected hyphen format (XXXX-XXXX) for consistency.
This change enhances the reliability of device code parsing in the GitHub OAuth flow.
Implements context-aware MCP tool injection for QA agents to optimize
context window usage. Instead of including all browser automation tools
and documentation for every project, the system now detects project
capabilities and injects only relevant tools.
Key changes:
- Add project_context.py with capability detection (Electron, web
frontend, API, database) from project_index.json
- Create modular MCP tool docs (prompts/mcp_tools/) that are injected
dynamically based on detected capabilities
- Update permissions.py to filter MCP tools by project type
- Update client.py to pass capabilities through tool chain
- Add smart cache for project index refresh at spec creation
Context window savings:
- Electron apps: Only 4 Electron tools (not 12+ browser tools)
- Web frontends: Only 8 Puppeteer tools
- CLI projects: No browser tools at all
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The CustomModelModal had a hardcoded `open={true}` prop on the Radix UI
Dialog, causing a rendering conflict when the parent unmounted it.
The overlay got stuck rendered, creating a black screen.
Fix: Use controlled `open` prop passed from parent instead of
conditional rendering with hardcoded dialog state.
Closes#79🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Remove ANTHROPIC_API_KEY from the authentication fallback chain.
Auto Claude is designed to use Claude Code OAuth tokens only.
Previously, if CLAUDE_CODE_OAUTH_TOKEN was empty or missing, the system
would silently fall back to ANTHROPIC_API_KEY from the environment,
causing unexpected API billing when users thought they were using OAuth.
Closes#76🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add ExistingCompetitorAnalysisDialog component for projects with
existing competitor analysis, offering three options:
- Use existing analysis (recommended)
- Run new analysis (fresh web searches)
- Skip competitor analysis
- Fix "exit code null" error when stopping roadmap generation quickly
by tracking intentionally stopped processes in agent-queue.ts
- Add --refresh-competitor-analysis CLI flag to backend to allow
independent refresh of competitor data
- Update IPC handlers, preload API, and store to support the new
refreshCompetitorAnalysis parameter
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add ExistingCompetitorAnalysisDialog component for projects with
existing competitor analysis, offering three options:
- Use existing analysis (recommended)
- Run new analysis (fresh web searches)
- Skip competitor analysis
- Fix "exit code null" error when stopping roadmap generation quickly
by tracking intentionally stopped processes in agent-queue.ts
- Add --refresh-competitor-analysis CLI flag to backend to allow
independent refresh of competitor data
- Update IPC handlers, preload API, and store to support the new
refreshCompetitorAnalysis parameter
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The coroutine was being created on the main thread before being passed
to ThreadPoolExecutor. This is incorrect as coroutines should be created
and run in the same thread. Use a lambda to defer coroutine creation
until execution inside the worker thread.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add visual affordances to make it clear that the Phase Configuration
section is clickable and editable:
- Add pencil icon and "Click to customize" text in collapsed state
- Improve hover state on the header
- Add labels for Model and Thinking columns in expanded state
- Better visual separation between collapsed and expanded states
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Security fixes:
- Fix Windows command injection vulnerability in terminal-handlers.ts
by adding escapeShellArgWindows() for proper cmd.exe escaping
- Fix OAuth race condition in device code extraction using mutex pattern
Bug fixes:
- Fix settings migration to preserve existing user profile selections
instead of unconditionally overwriting them
- Fix asyncio.run() to handle existing event loops by using ThreadPoolExecutor
- Add error logging for migration persistence failures
UX improvements:
- Add cleanup for copy feedback timeouts in GitHubOAuthFlow to prevent
setState on unmounted component warnings
- Add error handling for failed agent profile saves
Type safety:
- Add _migratedAgentProfileToAuto to AppSettings interface
- Fix GraphitiStep type to use Partial<Pick<AppSettings, ...>>
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Allow users to customize the model and thinking level for each phase
(Spec Creation, Planning, Coding, QA Review) when using the Auto profile.
These settings are persisted in app settings and used as defaults when
creating new tasks.
Changes:
- Add customPhaseModels and customPhaseThinking to AppSettings type
- Update AgentProfileSettings to show editable phase configuration
when Auto profile is selected
- Update TaskCreationWizard to initialize from custom settings
- Phase config can still be overridden per-task in task creation wizard
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Previously, clicking "Mark as Done" or "Delete Worktree & Mark Done"
would update the task status but leave the modal open, requiring an
extra click on "Close". Now the modal automatically closes after
successfully marking a task as done for better UX.
Add the ability to perform parallel merges using AI for conflict resolution. This includes the implementation of the `_run_parallel_merges` function, which processes multiple merge tasks concurrently, and the `_merge_file_with_ai_async` function for handling individual file merges.
Key changes:
- Introduced AI-based merging logic with a system prompt for 3-way merges.
- Added helper functions for inferring file types and building merge prompts.
- Updated tests to cover various scenarios for the new merging functionality.
This enhancement allows for more efficient handling of merge conflicts, leveraging AI to ensure accurate and context-aware resolutions.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Move the Agent Profiles configuration from a separate dashboard tab
to the Settings page under "Agent Settings". This provides a more
intuitive location for users to configure their default agent profile.
Changes:
- Create AgentProfileSettings component for settings page
- Add agent profiles to GeneralSettings 'agent' section
- Remove 'agent-profiles' from sidebar navigation
- Remove AgentProfiles view from App.tsx routing
- Update SidebarView type
The agent profiles are now accessible via Settings > Agent Settings,
alongside other agent-related configuration options.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add explicit Write tool instructions to planner.md prompt
- Clarify that agent must use Write tool, not just describe file contents
- Fix PROMPTS_DIR path in prompts.py to correctly reference prompts/ directory
- Add checkpoint reminder in Phase 4 to verify Write tool was used
- Add critical instructions for all file creation phases (init.sh, build-progress.txt)
Fixes#38🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add one-time migration to reset selectedAgentProfile to 'auto' for
existing users. This ensures the optimized per-phase model selection
is the default experience for everyone.
The migration:
- Runs once on settings load (tracked by _migratedAgentProfileToAuto flag)
- Sets selectedAgentProfile to 'auto'
- Persists the change to settings.json
- Users can still change their preference afterward
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Changed the default value for the selected agent profile from 'balanced' to 'auto' in the AgentProfiles component to improve user experience and align with expected behavior.
When the implementation_plan.json feature field contains the spec directory
name (e.g., "054-version-2-5-5-displays-version-2-5-0-in-updater") instead
of a human-readable title, the task card and modal showed the ugly spec ID.
Now detects when the feature field looks like a spec ID (starts with 3 digits
and a dash) and extracts the actual title from spec.md's first heading,
handling prefixes like "Quick Spec:" and "Specification:".
Example: "054-version..." → "Fix Version 2.5.5 Display in Updater"
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Tasks like spec 053 were missing descriptions in the kanban board and
task modal because the regex for extracting the overview from spec.md
required two newlines after "## Overview" (a blank line).
Specs generated with compact markdown (no blank line after headers)
were not matched, resulting in empty descriptions.
Changes:
- Fix regex to accept one or more newlines: /## Overview\s*\n+/
- Add fallback to read from requirements.json task_description field
- Extract meaningful content from GitHub issue descriptions
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Updated the styling of the "Stage only" option in the WorkspaceStatus component for improved user experience. Changes include a more visually appealing label with rounded corners and hover effects, as well as dynamic text color based on the checkbox state. This enhances the overall design consistency and interactivity of the UI.
The UI was showing "→ main" for all worktree merges because it checked
origin/HEAD (the remote's default branch) instead of the user's current
local branch.
This caused confusion since the actual merge logic in Python correctly
merges into the user's current branch (e.g., v2.6.0), but the UI
displayed "→ main".
Changed baseBranch detection from origin/HEAD to the current local
branch (git rev-parse --abbrev-ref HEAD) in three handlers:
- TASK_WORKTREE_STATUS
- TASK_WORKTREE_DIFF
- TASK_LIST_WORKTREES
Now the UI accurately reflects where changes will be merged.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Verify theme settings persist after app restart:
- Settings stored in settings.json via Electron IPC
- colorTheme included in DEFAULT_APP_SETTINGS
Add invalid colorTheme fallback to 'default':
- Added validation against COLOR_THEMES array
- Invalid stored values now fallback to 'default'
Verify system mode preference detection:
- Uses matchMedia API with event listener
- Correctly handles 'system' mode preference
Ensure no CSS flash on load:
- Default theme uses :root CSS (no data-theme attribute)
- Settings initialize with colorTheme: 'default'
- IPC loads fast (local process, not network)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Removed theme toggle functionality from sidebar header:
- Removed Sun/Moon toggle button from header section
- Removed toggleTheme function and isDark calculation
- Removed unused Moon, Sun icons from lucide-react imports
- Removed unused saveSettings import
Theme selection is now exclusively in Settings > Appearance via
the ThemeSelector component which provides full 7-theme support
with light/dark/system mode toggle.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Updated the theme application useEffect to set/remove the data-theme
attribute on document.documentElement based on settings.colorTheme.
- Default theme removes the data-theme attribute
- Other themes set data-theme="themeName"
- Added settings.colorTheme to useEffect dependency array
- Falls back to 'default' if colorTheme is undefined
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Updated ThemeSettings.tsx to use the new ThemeSelector component
- Removed old 3-button mode toggle in favor of full theme selector grid
- ThemeSelector provides both color theme selection (7 themes) and mode toggle
- Simplified ThemeSettings to act as a wrapper with consistent section layout
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Create ThemeSelector.tsx component in settings folder
- Display a grid of theme cards showing name, description, and preview color swatches
- Preview swatches show bg/accent colors based on current light/dark mode
- Include a 3-option mode toggle (Light/Dark/System)
- Handle selection via props callbacks (onSettingsChange pattern)
- Export component from settings barrel file
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add [data-theme="retro"] and [data-theme="retro"].dark CSS blocks with
warm amber/orange palette mapped to app variables:
Light mode:
- Background: #FEF3C7 (warm cream/amber)
- Primary accent: #D97706 (amber/orange)
- Text: #78350F (warm brown)
Dark mode:
- Background: #1C1917 (warm stone/charcoal)
- Primary accent: #FBBF24 (bright gold/amber)
- Text: #FEFCE8 (cream/off-white)
All color variables mapped to the app's variable naming convention,
following the same pattern as existing Dusk, Lime, and Ocean themes.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Added Ocean theme CSS variables for both light and dark modes:
- Light mode: sky blue background (#E0F2FE) with blue accent (#0284C7)
- Dark mode: deep ocean (#082F49) with bright sky blue (#38BDF8)
- All color variables mapped to app's variable naming convention
- Includes semantic colors, shadows, and focus states
Add lime theme CSS variables for both light and dark modes:
- Light: Fresh lime background (#E8F5A3) with purple accent (#7C3AED)
- Dark: Deep purple undertones (#0F0F1A) with bright purple (#8B5CF6)
- Maps design system color variables to app's variable naming convention
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Copy [data-theme="dusk"] and [data-theme="dusk"].dark CSS blocks from
.design-system/src/styles.css. Map design system variables to app's
existing variable structure (--background, --foreground, --primary, etc.).
Dusk Light: Warm, muted palette with olive/yellow accents (#B8B978)
Dusk Dark: Fey-inspired dark theme with pale yellow accents (#E6E7A3)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Added colorTheme: 'default' as const to DEFAULT_APP_SETTINGS in config.ts
to ensure new users start with the default theme.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add COLOR_THEMES constant array with all 7 theme definitions:
- Default: Oscura-inspired with pale yellow accent
- Dusk: Warmer variant with slightly lighter dark mode
- Lime: Fresh, energetic lime with purple accents
- Ocean: Calm, professional blue tones
- Retro: Warm, nostalgic amber vibes
- Neo: Modern cyberpunk pink/magenta
- Forest: Natural, earthy green tones
Each theme includes preview colors for light/dark mode variants.
Export added to constants/index.ts.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Added useEffect in FileTreeItem to clean up custom drag image on component unmount, preventing memory leaks.
- Enhanced drag image creation using safe DOM manipulation instead of innerHTML.
- Updated ClaudeOAuthFlow to manage auto-advance timeout with cleanup on unmount, ensuring onSuccess is not called after component unmount.
These changes enhance the reliability and performance of drag-and-drop functionality and OAuth flow handling.
Add multi-theme type definitions to settings.ts:
- ColorTheme union type with 7 theme options
- ThemePreviewColors interface for theme preview UI
- ColorThemeDefinition interface for theme metadata
- Optional colorTheme property in AppSettings interface
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Introduced shell escape utilities to prevent command injection in terminal commands.
- Updated terminal handlers to use safe command construction for profile switching and OAuth token initialization.
- Removed unnecessary console warnings, replacing them with debug logs for cleaner output.
- Implemented a wait mechanism to monitor terminal output for Claude exit, improving profile switching reliability.
This update improves the security and reliability of terminal command execution, ensuring user inputs are safely handled.
- Added useRef to manage custom drag image for better cleanup
- Updated drag image positioning to prevent display issues
- Enhanced cleanup process for drag image element on drag end
This update refines the drag-and-drop experience within the file tree, ensuring that custom drag images are handled more effectively.
- Implement default branch selection in GitHub integration settings
- Fetch and display available branches based on the project path
- Update TaskCreationWizard to support file reference drops in the description
- Improve drag-and-drop handling for file references and images
- Add console logging for agent process when DEBUG is enabled
- Refactor FileTreeItem to manage drag state and custom drag images
This update enhances user experience with Git operations and improves the task creation workflow by allowing users to easily reference files.
- Add collapsible Git Options section with base branch selector
- Allow per-task override of the worktree base branch
- Fetch and display available branches from the project repository
- Show project default branch in placeholder when available
- Use special placeholder value for Radix UI Select compatibility
- Move DndContext inside DialogContent for proper portal behavior
- Add drag-and-drop debugging logs
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
When switching Claude profiles via the UI, existing terminal sessions
now automatically restart with the new profile's OAuth token. This
fixes the issue where users had to manually restart Claude after
switching profiles.
Changes:
- Profile switch handler now iterates active terminals and restarts
Claude sessions that are in Claude mode
- Added clear terminal before profile switch to hide temp file command
- Fixed OAuth token regex to match 'default' profile ID (not just
profile-\d+)
- Hide "Authenticate" button when profile is already authenticated
- Add re-authenticate button (refresh icon) for authenticated profiles
- Added debug logging for profile switching (enabled with DEBUG=true)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Fix HTTP 415 error when downloading updates from GitHub API
- Use 'application/vnd.github+json' Accept header for API URLs
- Use 'application/octet-stream' only for CDN/direct download URLs
- Add getEffectiveVersion() to track installed source version
- Reads from .update-metadata.json written during updates
- Works in both dev mode and packaged app
- Falls back to app.getVersion() if no metadata found
- Update version display to persist after app reload
- APP_VERSION IPC now returns effective version
- Update checker uses effective version for comparison
- UI updates displayVersion from check result
- Add comprehensive DEBUG logging for update process
- Logs update stages: download, extract, apply
- Logs version resolution and metadata paths
- Shows clear success/failure banners
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Added defensive null check when saving OAuth tokens to active profile during
non-profile terminal flows (e.g., GitHub setup). Previously, if no active
profile existed, the code would crash when trying to access activeProfile.id.
Changes:
- Added null check for activeProfile before attempting to save token
- Send failure event to UI when no active profile is found
- Include profileId in failure event for consistency
- Added docstrings to fall
When users authenticate with Claude during the GitHub setup modal, the
OAuth token is now automatically saved to the active Claude profile
instead of being ignored.
Changes:
- Modified handleOAuthToken() to save tokens to active profile when not
in a profile-specific terminal (e.g., during GitHub OAuth flow)
- Added Claude authentication step to GitHub setup modal flow
- Renamed setup steps for clarity: 'auth' → 'github-auth',
Critical bug fix: The Python detector was returning 'py' instead of 'py -3'
on Windows, which could cause Python 2 to be invoked instead of Python 3.
Changes:
- Removed special case in findPythonCommand() that stripped the '-3' flag
- Added parsePythonCommand() helper to split space-separated commands
- Updated all 9 spawn() call sites to properly handle command parsing:
* agent-process.ts
* agent-queue.ts (2 locations)
* title-generator.ts
* terminal-name-generator.ts
* changelog/generator.ts
* changelog/version-suggester.ts
* ipc-handlers/task/worktree-handlers.ts (2 locations)
This ensures Windows systems using 'py -3' launcher correctly invoke
Python 3 instead of potentially defaulting to Python 2.
Fixes issue identified in PR review comment.
## Problem
Users couldn't access hidden directories like `.claude`, `.auto-claude`,
`.github`, `.vscode`, etc. when creating tasks or adding file references.
## Root Cause
File explorer filtered out ALL files/directories starting with `.` except `.env`,
making important configuration directories invisible.
## Solution
### 1. Allow hidden directories to be visible
- Changed filter to only hide hidden FILES, not directories
- Hidden directories like `.claude`, `.github`, `.vscode`, `.idea` now visible
### 2. Keep useful hidden files visible
- `.env`, `.gitignore`, `.env.example`, `.env.local` still shown
- Other random hidden files (`.DS_Store`, etc.) still filtered
### 3. Updated IGNORED_DIRS
- Removed `.auto-claude` (contains user specs/data)
- Removed `.vscode` and `.idea` (users may need IDE config)
- Kept truly problematic dirs: `.git`, `node_modules`, `.cache`, `.worktrees`
## User Impact
Users can now drag and reference files from `.claude`, `.auto-claude`,
`.github`, and other configuration directories when creating tasks.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
The fixer client for human feedback was hardcoding "sonnet" as the
fallback model instead of using the model parameter passed to
run_qa_validation_loop. This now correctly passes the user's chosen
model to get_phase_model.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add comprehensive unit tests for GitHub OAuth handlers:
- Device code parsing from gh CLI stdout/stderr output
- shell.openExternal success and failure handling
- Fallback URL provision when browser launch fails
- Error handling for gh CLI process errors and non-zero exit codes
- gh CLI check and auth status handlers
- Repository format validation for command injection prevention
21 new tests covering all critical OAuth flow paths.
Also updates vitest.config.ts to include *.spec.ts files.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add 5-minute authentication timeout using useCallback and useRef for cleanup
- Implement clearAuthTimeout helper to manage timeout lifecycle
- Start timeout when auth begins, clear on success/failure/unmount
- Add isTimeout state to track timeout vs other errors
- Display timeout-specific UI with Clock icon and warning colors
- Show clear error message with retry option on timeout
- Timeout set to 5 minutes (GitHub device codes expire after 15 minutes)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Added fallback URL card in error state when authUrl is available
- Shows "Complete Authentication Manually" instructions when browser fails to open
- Added copyable URL display with Copy button that tracks copy state separately
- Added "Open URL in Browser" button to attempt manual browser launch
- Shows device code reminder in fallback card if available
- Changed Retry button in error state to call handleStartAuth instead of
handleRetry for fresh auth attempt
- Added urlCopied state variable to track URL copy status independently
from device code copy status
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add device code, auth URL, and browser opened state variables to GitHubOAuthFlow
- Display prominent device code card during authentication with copy button
- Show manual auth URL link when browser fails to open
- Update IPC types to include deviceCode, authUrl, browserOpened, and fallbackUrl
- Add visual feedback for code copy (checkmark icon when copied)
- Instructions adapt based on whether browser opened successfully
- Added fallbackUrl field to GitHubAuthStartResult interface
- Updated success case to include fallbackUrl when browser fails to open
- Updated failure case to always provide fallbackUrl for manual recovery
- Updated gh process error handler to include fallbackUrl
- Updated catch block to include fallbackUrl for exception cases
This ensures users always have a way to manually navigate to the auth URL
when automatic browser opening fails (e.g., due to macOS security restrictions).
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Format Python code in qa/loop.py per ruff standards
- Add missing success property to WorktreeMergeResult data object
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Modify registerStartGhAuth to:
- Extract device code from gh CLI stdout/stderr as data streams in
- Use parseDeviceFlowOutput to get device code and auth URL
- Open browser via shell.openExternal (bypasses macOS restrictions)
- Return device code, auth URL, and browserOpened status in response
- Handle browser open failures gracefully (allows manual fallback)
Added GitHubAuthStartResult interface with deviceCode, authUrl,
and browserOpened fields for rich response data.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Import `shell` from Electron for browser launching capability
- Add DEVICE_CODE_PATTERN regex to parse device code (format: XXXX-XXXX) from gh CLI output
- Add DEVICE_URL_PATTERN regex and GITHUB_DEVICE_URL constant for device flow URL
- Add parseDeviceCode() helper to extract device code from output
- Add parseDeviceUrl() helper to extract or default to GitHub device flow URL
- Add DeviceFlowInfo interface for structured device flow output
- Add parseDeviceFlowOutput() helper to parse both stdout and stderr for device flow info
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Bug: Clicking "Request Changes" in Human Review caused the task to
immediately return to human_review without applying any fixes.
Root causes:
- QA_FIX_REQUEST.md was written to main project instead of worktree
- QA process ran against main project path (missing implementation_plan.json)
- Early return in qa_commands.py and loop.py if QA already approved,
ignoring pending human feedback
Fixes:
- Write QA_FIX_REQUEST.md to worktree spec directory
- Run QA process with worktree path where build files exist
- Check for human feedback before "already approved" early return
- Process human feedback by running QA fixer first
- Reset staged changes in main when going back to QA
- Add check for already-staged changes to prevent duplicate work
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
**Issue:**
The initialization popup would not close automatically after successful
initialization due to a race condition in the Dialog's onOpenChange handler.
The handler couldn't distinguish between user-initiated close and
programmatic close after success.
**Root Cause:**
When we programmatically closed the dialog after successful init, React's
state batching meant the onOpenChange handler couldn't reliably check if
pendingProject was null yet, causing it to trigger the "skip" logic instead
of completing successfully.
**Fixes:**
1. Added initSuccess state flag to track successful initialization
2. Updated handleInitialize to set flag before closing dialog
3. Modified onOpenChange condition to check !initSuccess before calling skip
4. Added error state and UI display for failed initializations
5. Added comprehensive debug logging throughout initialization flow
**Files Modified:**
- auto-claude-ui/src/renderer/App.tsx
- auto-claude-ui/src/renderer/stores/project-store.ts
**Behavior:**
- On success: Closes automatically and opens GitHub setup modal
- On failure: Stays open with clear error message for user to retry
- On skip: Closes and remembers skip preference
- Debug logs show exactly what's happening at each step
Fixes initialization popup staying open after successful project setup.
This commit fixes Python-related issues on Windows and other platforms:
**Python Detection Issues:**
- Fixed "spawn python3 ENOENT" errors on Windows
- All services were hardcoded to use 'python3' which doesn't exist on Windows
- Created python-detector.ts utility with intelligent detection:
- Windows: tries 'py -3', 'python', 'python3', 'py' (in order)
- Unix/Mac: tries 'python3', 'python' (in order)
- Verifies each candidate is actually Python 3.x
- Falls back to platform-specific default if none found
**Dependency Installation Issues:**
- Fixed PythonEnvManager failing to install dependencies
- Newer Python versions (3.13+) create pip3.exe instead of pip.exe
- Changed to use 'python -m pip' for universal compatibility
- Added automatic pip bootstrapping using 'python -m ensurepip'
- Works across all Python versions and platforms
**Files Modified:**
- Created: auto-claude-ui/src/main/python-detector.ts
- Updated: agent-process.ts, title-generator.ts, terminal-name-generator.ts,
changelog-service.ts, insights/config.ts, worktree-handlers.ts,
python-env-manager.ts
Fixes issues where Windows users couldn't run tasks, generate titles,
or install Python dependencies.
- Fix FalkorDB default port from 6379 to 6380
- Update provider list comment to include Google AI
- Fix requirements.txt comment to mention both LLM and embeddings
- Add logging and warning for unimplemented tool calling in GoogleLLMClient
- Fix overly broad exception handling (catch only JSONDecodeError)
- Add Azure deployment name validation (LLM and embedding deployments)
- Apply ruff formatting to Python files
- Fix ENV_GET handler to populate graphitiProviderConfig from .env
- Add Google AI to get_available_providers() function
- Fix type assertions to include google/groq/huggingface providers
- Fix asyncio deprecation: use get_running_loop() instead of get_event_loop()
Fixes#27
## Problem
Version 2.5.5 was displaying as 2.5.0 in the updater because package.json
wasn't updated when the git tag was created.
## Solution
This PR implements a comprehensive automated version management system:
### 1. Version Bump Script (scripts/bump-version.js)
- Automates version updates in package.json
- Creates git commits and tags automatically
- Prevents human error in version management
- Supports semver bumps (major/minor/patch) or specific versions
### 2. Version Validation Workflow (.github/workflows/validate-version.yml)
- Runs automatically on every git tag push
- Validates package.json version matches the git tag
- Fails CI if versions mismatch with clear error messages
- Prevents releases with incorrect versions
### 3. Documentation (RELEASE.md)
- Complete release process guide
- Troubleshooting for version issues
- Release checklist
### 4. Updated package.json
- Fixed current version from 2.5.0 to 2.5.5
## Impact
- ✅ Prevents version mismatch issues from happening again
- ✅ Automates release process
- ✅ CI validation catches manual errors
- ✅ Clear documentation for maintainers
Add full Google AI (Gemini) support for Graphiti memory system:
Backend:
- Add google-generativeai dependency to requirements.txt
- Create GoogleEmbedder class with text-embedding-004 default model
- Create GoogleLLMClient class with gemini-2.0-flash default model
- Add GOOGLE to LLMProvider and EmbedderProvider enums
- Add google_api_key, google_llm_model, google_embedding_model config
- Update factory to create Google LLM client and embedder
- Add validation for Google provider configuration
Frontend:
- Add 'google' to GraphitiLLMProvider and GraphitiEmbeddingProvider types
- Add Google AI option to LLM provider dropdown in Setup Wizard
- Add Google AI option to embedding provider dropdown
- Add Google API key input field with link to Google AI Studio
- Update MemoryBackendSection and SecuritySettings components
- Update env-handlers to save GOOGLE_API_KEY, GOOGLE_LLM_MODEL,
and GOOGLE_EMBEDDING_MODEL to .env files
This allows users to use Google's Gemini models for both LLM operations
(graph extraction, search, reasoning) and embeddings in Graphiti memory.
- Add globalAnthropicApiKey, globalGoogleApiKey, globalGroqApiKey to AppSettings
- Add graphitiLlmProvider and ollamaBaseUrl to AppSettings
- Use proper typed access instead of Record<string, unknown> casts
- Import AppSettings type in GraphitiStep component
- Add 'ollama' to GraphitiProviderType and GraphitiEmbeddingProvider
- Add Ollama-specific config fields (baseUrl, llmModel, embeddingModel, embeddingDim)
- Update GraphitiStep UI to show Base URL field instead of API key for Ollama
- Handle Ollama differently in validation, save, and load logic
- Ollama runs locally and doesn't require an API key
- Fix initial API key loading to use saved provider preference
- Update local settings store for all providers (not just OpenAI)
- Load saved API keys when switching between providers
- Add note for non-OpenAI providers about validation limitations
The previous commit (e1aee6a) updated package.json to use @lydell/node-pty
but the source files still imported from 'node-pty'. This caused the app
to fail on startup with "Cannot find module 'node-pty'" error.
This commit updates all imports and the vite external config to reference
@lydell/node-pty directly, completing the migration.
Files changed:
- src/main/terminal/pty-manager.ts
- src/main/terminal/pty-daemon.ts
- src/main/terminal/types.ts
- electron.vite.config.ts
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add provider dropdown to the Memory & Context onboarding step allowing
users to choose between OpenAI, Anthropic (Claude), Google (Gemini),
and Groq (Llama) for Graphiti memory operations.
Changes:
- Add provider selection dropdown with 4 LLM options
- Dynamic API key field that updates label, placeholder, and link
based on selected provider
- Update validation and save logic to handle multiple providers
- Fix node-pty imports to use @lydell/node-pty directly
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
## Summary
- Add visual indicator showing GitHub config is per-project, not global
- Users were confused thinking settings applied to all projects
## Changes Made
### 1. Added info box to GitHub Integration section
- Displays project name in configuration context
- Explains that each project can have its own repository
- Only shown when GitHub Integration is enabled
### 2. Component updates
- GitHubIntegrationSection: Added projectName prop and info box
- ProjectSettings: Pass project.name to GitHubIntegrationSection
## User Impact
Eliminates confusion about configuration scope - users now clearly understand
that GitHub repository settings are project-specific.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Upgraded various dependencies including node-pty (now using @lydell/node-pty@^1.1.0), @types/node, @eslint/js, @standard-schema/spec, @typescript-eslint, and several others. Also updated esbuild and rollup platform-specific packages to newer versions.
node-pty@1.1.0-beta9 fails to compile on Windows with node-gyp due to
MSBuild errors during native module compilation. This blocks installation
for Windows users without full Visual Studio Build Tools configured.
Solution:
- Replace node-pty with @lydell/node-pty which provides prebuilt binaries
- Add pnpm override to alias 'node-pty' imports to the new package
- Update extraResources path for electron-builder
- Remove node-pty from onlyBuiltDependencies (no compilation needed)
@lydell/node-pty@1.1.0 provides prebuilt binaries for:
- Windows x64 and ARM64
- macOS x64 (Intel) and ARM64 (Apple Silicon)
- Linux x64 and ARM64
This eliminates the need for node-gyp compilation and ensures
cross-platform compatibility without build tool dependencies.
- Added new features including GitHub setup flow, atomic log saving, and multi-auth token support.
- Improved agent behavior with a new default profile and enhanced issue tracking.
- Fixed multiple CI test failures and improved merge preview reliability.
- Implemented security measures to prevent command injection and enforced Python version requirements.
- Conducted code cleanup and removed redundant directory structures.
This release focuses on enhancing agent reliability and streamlining the build workflow.
Test fix:
- Mock getClaudeProfileManager in subprocess spawn tests to bypass
authentication checks that fail in CI (no auth token configured)
Merge preview improvements:
- Add _detect_default_branch() to properly detect main/master branch
- Add debug logging for git diff failures to aid troubleshooting
- Use detected default branch instead of hardcoded 'main'
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
## Summary
- Add support for organization repositories by including org members in repo list API
- Add repository reference normalization to handle full GitHub URLs, SSH URLs, and owner/repo format
- Apply normalization to all GitHub API calls to ensure consistent behavior
## Changes Made
### 1. Enhanced repo listing (repository-handlers.ts)
- Updated `/user/repos` endpoint to include affiliation parameter
- Now fetches: owner, collaborator, and organization_member repos
- Fixes#20: Organization repos now appear in repository list
### 2. Added URL normalization utility (utils.ts)
- New `normalizeRepoReference()` function handles:
- owner/repo format (already normalized)
- https://github.com/owner/repo URLs
- https://github.com/owner/repo.git URLs
- git@github.com:owner/repo.git SSH URLs
- Prevents 404 errors from malformed repository references
### 3. Applied normalization consistently
- Updated repository-handlers.ts to normalize repo refs before API calls
- Updated issue-handlers.ts to normalize repo refs before API calls
- All GitHub API calls now use normalized repository format
## Testing
- Verified with organization repository: imaginationeverywhere/ppsv-charities
- Tested with various URL formats
- GitHub CLI authentication continues to work seamlessly
## Related Issues
Fixes#20: Auto Claude doesn't work with GitHub Organization repositories
Update TaskCreationWizard to use 'auto' as the default agent profile
when no profile is explicitly selected.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Use execFileSync instead of execSync to avoid shell interpretation
- Add regex validation for repo format (owner/repo pattern)
- Reject requests with invalid characters that could enable injection
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Fix import sorting issues caught by ruff (I001)
- Apply ruff formatting to auto-claude modules
- Update test to match default model (sonnet-4-5 not opus-4-5)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The merge preview was showing incorrect file counts because it only
counted files tracked by the semantic evolution tracker. Many files
(test files, config files, etc.) weren't being tracked, leading to
misleading "Files to merge: 0" displays when there were actually
multiple files changed.
Changes:
- Add _get_changed_files_from_git() helper to get actual changed files
- Use git diff count as authoritative totalFiles instead of tracker count
- Use git diff file list for the files array in preview response
- Always compare against 'main' branch (worktrees are created from main)
This ensures the UI shows the correct number of files that will be
merged, matching the git diff stats shown elsewhere in the UI.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit improves the handling of stage-only merges by adding verification to ensure that actual changes are staged before proceeding. Key changes include:
- Implementation of checks to determine if there are staged changes or if the merge has already been committed.
- Updated status handling based on the verification results, allowing for more accurate task status updates.
- Enhanced debug logging for better traceability of merge outcomes.
These enhancements provide a more robust user experience by preventing false positives in stage-only scenarios and ensuring accurate task management.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
This commit adds a new phase configuration module that manages model and thinking level settings for different execution phases. It reads configurations from `task_metadata.json` and provides resolved model IDs for various phases, including spec creation, planning, coding, and QA.
Key changes include:
- New `phase_config.py` file to handle model ID mappings and thinking budgets.
- Updates to agent files (`coder.py`, `planner.py`, `loop.py`) to utilize phase-specific models and thinking levels.
- Modifications to the CLI and UI components to support per-phase configuration, enhancing the user experience for task creation and editing.
The new structure allows for optimized model selection and thinking depth based on the phase, improving overall task execution efficiency.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Previously, roadmap generation would stop or appear stopped when users
navigated between projects. This fix ensures generation continues in
the background and the UI properly reflects the generation state.
Changes:
- Add ROADMAP_GET_STATUS IPC endpoint to query if generation is running
- Update loadRoadmap() to query backend status when switching projects
- Restore generation UI state when returning to a project with active gen
- Remove aggressive stopRoadmap() call that killed generation on switch
The fix allows users to start roadmap generation, navigate to other
projects, and return to see the correct progress/completion state.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This ensures users properly configure GitHub before using Auto Claude,
which is necessary for the branch-based workflow to function correctly.
Changes:
- Add GitHubSetupModal component with 3-step flow:
1. GitHub OAuth authentication (via gh CLI)
2. Auto-detect repository from git remote
3. Select base branch for task worktrees (with recommended default)
- Add IPC handlers for detectGitHubRepo and getGitHubBranches
- Integrate modal into App.tsx to show after Auto Claude init
- Update ElectronAPI types and browser mocks
The flow now is:
1. User adds project
2. Git must be initialized (GitSetupModal if not)
3. Auto Claude initialized (creates .auto-claude folder)
4. GitHub setup required (new GitHubSetupModal)
5. Project ready for task creation
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Specs are stored in .auto-claude/specs/ (per-project, gitignored).
The auto-claude/specs/ folder was legacy and no longer used.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Added checks to ensure the initialization dialog does not trigger skip logic while a project is being initialized.
- Refactored project ID handling in the initialization process for consistency across components.
- Improved user experience by preventing unintended dialog closures during initialization.
This change enhances the reliability of the project initialization workflow in the application.
- Added functionality to detect the current Git branch before merging spec changes.
- Prevent merging into the same branch by providing user guidance to switch branches.
- Updated WorktreeManager initialization to use the detected branch as the merge target.
This improves the user experience by ensuring that merges are performed correctly and reduces the risk of accidental merges into the spec branch.
Updated the model IDs in the MODEL_ID_MAP to reflect the latest versions for Sonnet and Haiku. This change ensures that the application uses the correct identifiers for these models moving forward.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Enhance log storage functionality by saving logs to a temporary file first, followed by an atomic rename to the final log file. This change mitigates the risk of log corruption during concurrent reads, particularly when the UI accesses the log file mid-write. Additionally, update the log loading mechanism to return cached logs if the file is detected as corrupted.
Files updated:
- auto-claude/task_logger/storage.py: Implement atomic log saving
- auto-claude-ui/src/main/task-log-service.ts: Handle potential log file corruption by returning cached logs
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Eliminates the need for Visual Studio Build Tools on Windows by:
1. GitHub Actions workflow (.github/workflows/build-prebuilds.yml)
- Builds node-pty for Windows x64 with correct Electron ABI
- Uploads prebuilt binaries as release assets
- Triggered on releases and manual dispatch
2. Smart postinstall script (auto-claude-ui/scripts/postinstall.js)
- On Windows: tries to download prebuilts first
- Falls back to electron-rebuild if prebuilts unavailable
- Shows clear instructions if compilation fails
3. Download helper (auto-claude-ui/scripts/download-prebuilds.js)
- Fetches prebuilt binaries from GitHub releases
- Extracts and installs to node_modules/node-pty
Windows users can now run `npm install` without installing Visual Studio
Build Tools, as long as prebuilt binaries exist for their Electron version.
Fixes#8🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add model selector dropdown in Insights chat header with agent profiles:
- Complex (Opus + ultrathink)
- Balanced (Sonnet + medium) - new default
- Quick (Haiku + low)
- Custom option for direct model + thinking level selection
- Change default from slow Opus to Sonnet for faster responses
- Persist model configuration per-session
- Fix missing event forwarding from insightsService to renderer
(was causing responses to not appear without hard refresh)
- Fix insights_runner.py path (was looking in auto-claude/ instead of
auto-claude/runners/)
- Add --model and --thinking-level CLI args to insights_runner.py
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Adds validation in TASK_UPDATE_STATUS handler to prevent tasks from being
moved to human_review status prematurely when execution fails.
Changes:
- Check if spec.md exists and has meaningful content (at least 100 chars)
before allowing transition to human_review status
- Return error with actionable message if spec is missing or empty
- Log warning for debugging when blocked
This prevents the issue where tasks incorrectly appear in human_review
when spec creation fails silently (e.g., due to auth issues).
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Added authentication failure detection to the process exit handler in agent-process.ts:
- Import detectAuthFailure from rate-limit-detector
- In exit handler, when process fails (code !== 0) and is not rate limited,
check for authentication failures using detectAuthFailure(allOutput)
- If auth failure detected, emit 'auth-failure' event with taskId and
detection details (profileId, failureType, message, originalError)
This enables proper detection and reporting of authentication issues that
occur during spec creation or task execution.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Added pre-flight authentication checks before task execution:
- Import getClaudeProfileManager for auth validation
- Check hasValidAuth() in TASK_START handler before calling agentManager
- Check hasValidAuth() in TASK_UPDATE_STATUS handler before auto-starting tasks
- Check hasValidAuth() in TASK_RECOVER_STUCK handler before auto-restarting tasks
- Emit TASK_ERROR with actionable message when auth is missing
- Return early without changing task status when auth fails
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Added pre-flight authentication validation before spawning processes:
- Import getClaudeProfileManager from claude-profile-manager
- In startSpecCreation(): Check hasValidAuth() before spawning spec_runner.py
- In startTaskExecution(): Check hasValidAuth() before spawning run.py
- Emit clear error message if auth is missing, preventing task from starting
This ensures tasks cannot start without valid Claude authentication,
addressing GitHub Issue #11 where tasks would skip to human_review
when spec creation fails silently due to missing authentication.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add hasValidAuth(profileId?: string): boolean method to check if a profile
has valid authentication for starting tasks. A profile is considered
authenticated if it has a valid OAuth token (not expired) OR has an
authenticated configDir with credential files.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add AUTH_FAILURE_PATTERNS array with regex patterns to detect various
authentication error messages from Claude CLI/SDK output, including:
- Authentication required messages
- Invalid/expired token errors
- Unauthorized/access denied errors
- Login required messages
Also add:
- AuthFailureDetectionResult interface for structured detection results
- detectAuthFailure() function to detect auth failures in process output
- isAuthFailureError() helper for simple boolean checks
- classifyAuthFailureType() to categorize failures (missing/invalid/expired)
- getAuthFailureMessage() for user-friendly error messages
This enables detecting when tasks fail silently due to authentication
issues, allowing proper error feedback to users instead of incorrectly
skipping to human review status.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The codebase uses Python 3.10+ type hint syntax (e.g., `str | list[str]`)
which causes TypeError on Python 3.9 and earlier.
Changes:
- Update README.md to document Python 3.10+ requirement
- Add runtime version check in run.py and spec_runner.py
- Provides clear error message with upgrade instructions
Fixes#5🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add detection for when a branch named 'auto-claude' exists, which blocks
creating branches in the 'auto-claude/*' namespace due to Git's file-based
ref storage system.
Now provides a clear error message explaining the issue and how to fix it
by renaming the conflicting branch.
Fixes#3🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Implements support for multiple authentication environment variables:
- CLAUDE_CODE_OAUTH_TOKEN (original, highest priority)
- ANTHROPIC_AUTH_TOKEN (for proxies like CCR)
- ANTHROPIC_API_KEY (direct Anthropic API)
Also adds ANTHROPIC_BASE_URL and related env vars passthrough to SDK.
Changes:
- New core/auth.py with centralized auth logic
- Updated core/client.py to use auth helpers
- Updated cli/utils.py to show auth source and base URL
- Updated all modules using auth tokens
- Updated .env.example with documentation
Fix TypeScript errors by using correct property names from types:
- Replace userQuotes with source and frequency fields
- Change opportunityScore to opportunity
- Replace summary with insightsSummary structure
- Display top pain points, differentiator opportunities, and market trends
All properties now match the CompetitorPainPoint and CompetitorAnalysis
type definitions in roadmap.ts.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add comprehensive competitor analysis viewing capabilities:
- Create CompetitorAnalysisViewer component with detailed insights display
* Shows competitor names, descriptions, and market positions
* Displays pain points with severity badges (high/medium/low)
* Includes user quotes from reviews/forums
* Shows opportunity scores for prioritization
* Provides visit links to competitor products
- Make Competitor Analysis badge interactive
* Click to open detailed viewer modal
* Tooltip shows summary (competitor count, pain points)
* Visual feedback with hover state
- Enhance persona visibility in roadmap header
* Make "+N more personas" clickable with dotted underline
* Show all secondary personas in tooltip on hover
- Fix modal scrolling in CompetitorAnalysisViewer
* Add flex layout constraints for proper scrolling
* Set max-height with calculation for header space
* Add bottom padding to prevent content cutoff
This enables users to view detailed competitive insights generated
during roadmap creation, including specific pain points identified
in competitor products and opportunities to address market gaps.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Changes included:
1. **InvestigationDialog.tsx** - Prevent state updates after unmount:
- Add isMounted flag to prevent state updates after component unmounts
- Add fetchCommentsError state to surface API errors to the user
- Display error state in UI with styled error message
- Ensure cleanup function properly sets isMounted = false
2. **EnvConfigModal.tsx** - Improve type safety:
- Replace `any` type with proper `ClaudeProfile` type in filter callback
3. **GenerationProgressScreen.tsx** & **RoadmapGenerationProgress.tsx**:
- Add double-click prevention for stop button
- Add isStopping state with proper error handling
Replace array index keys with content-based stable keys in two mapped lists:
- Competitor analysis: use `comp.id` instead of index, and simplify
type annotation by relying on TypeScript inference
- Secondary personas: use `persona` string value instead of index
Using stable keys improves React's reconciliation efficiency and prevents
potential rendering issues when list items are reordered or modified.
Addresses CodeRabbit review feedback.
- http-client.ts: Limit error response data collection to 10KB and add error handlers
- RoadmapGenerationProgress.tsx, GenerationProgressScreen.tsx: Allow onStop to return Promise<void>
- insights_runner.py: Fix path resolution and load .env from auto-claude directory
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The WorktreeManager is designed to prefer main/master branches over the
current branch when detecting the base branch. Updated the test to
reflect this intended behavior:
- Renamed test_init_detects_current_branch to test_init_prefers_main_over_current_branch
- Added new test_init_falls_back_to_current_branch to verify fallback when main/master don't exist
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Fix Python formatting (ruff) in workspace.py, display.py, menu.py
- Fix TypeScript errors:
- Add missing CompetitorAnalysis import in types.ts
- Add type annotations to RoadmapHeader.tsx map callback
- Add cn import and fix EnvConfigModal OAuth token handling
- Add type annotations to InvestigationDialog.tsx
- Add missing stopRoadmap and onRoadmapStopped to browser-mock
- Add getIssueComments to ElectronAPI type and mocks
- Update investigateGitHubIssue to accept optional selectedCommentIds
- Fix CLAUDE_CODE_OAUTH_TOKEN access in agent-queue.ts
- Include pending bug fixes:
- Add .trim() to git status parsing in worktree-handlers.ts
- Change Accept header to application/octet-stream in http-client.ts
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Added stop functionality for roadmap generation, allowing users to halt the process.
- Implemented debug logging throughout the roadmap generation process for better traceability.
- Updated IPC channels to support stopping roadmap generation and added corresponding handlers.
- Enhanced UI components to include stop buttons and feedback for the stop action.
This update improves user control over the roadmap generation process and aids in debugging.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
The runners in auto-claude/runners/ were using incorrect relative paths
that only went up one directory level instead of two, causing:
- ModuleNotFoundError for 'debug' module
- Missing .env file (CLAUDE_CODE_OAUTH_TOKEN not found)
- Script not found errors for analyzer.py
- Prompt files not found for agent execution
Fixed paths in:
- roadmap_runner.py: sys.path and .env now resolve to auto-claude/
- ideation_runner.py: sys.path and .env now resolve to auto-claude/
- roadmap/executor.py: scripts_base_dir and prompts_dir now resolve
correctly from the nested roadmap/ subdirectory
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add explicit key to overflow count span that shows "+N" when more
than 10 subtasks exist (sibling to mapped elements needed a key)
- Add fallback key using index for subtask indicators in case
subtask.id is undefined
Fixes console warning: "Each child in a list should have a unique
'key' prop"
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Previously, stuck detection only checked tasks with status='in_progress',
causing tasks stuck in 'ai_review' status to never show the recovery option.
When a task enters QA review phase, its status changes to 'ai_review'. If
the process crashes during this phase, the status remains 'ai_review' with
no active process, but the stuck detection was skipped because isRunning
only checked for 'in_progress' status.
This fix extends the isRunning check to include both 'in_progress' and
'ai_review' statuses, ensuring stuck tasks in AI Review can be detected
and recovered.
Fixes: Task #838 stuck in AI Review with no recovery option
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
## Features
- Add comment selection UI when creating tasks from GitHub issues
- Fetch and display all comments with author, timestamp, and preview
- Allow users to select/deselect individual comments via checkboxes
- Include "Select All" / "Deselect All" toggle functionality
- Show selected comment count (e.g., "3/5 comments selected")
- Only selected comments are included in the task description
- Fix auto-start bug where GitHub issues were immediately executed
- Tasks now stay in "backlog" status after creation
- Users must manually start tasks from the Kanban board
## Implementation Details
### Backend
- Added `getIssueComments` IPC handler to fetch comments separately
- Modified `investigateGitHubIssue` to accept selectedCommentIds parameter
- Updated comment filtering logic in buildIssueContext
- Removed automatic startSpecCreation call to prevent auto-execution
### Frontend
- Enhanced InvestigationDialog with scrollable comment list UI
- Updated GitHubAPI interface with getIssueComments method
- Modified hooks and stores to pass selected comment IDs through the chain
- Added projectId prop to InvestigationDialog for comment fetching
### Files Changed
- Backend handlers: investigation-handlers.ts, issue-handlers.ts, types.ts
- API layer: github-api.ts
- UI components: InvestigationDialog.tsx, GitHubIssues.tsx
- State management: github-store.ts, useGitHubInvestigation.ts
- Type definitions: types/index.ts, ipc.ts
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Added a drop zone for file references and a separate drop zone for inline @mentions in the description textarea.
- Updated drag-and-drop handling to allow inserting @mentions directly into the description or adding files to the referenced files list.
- Implemented parsing of @mentions from the description to create ReferencedFile entries, avoiding duplicates.
- Improved visual feedback for drag-and-drop interactions, including indicators for maximum file capacity and drop zones.
Fixed parsing bug where .trim() on entire output removed leading space
from git status --porcelain format, causing filenames to be truncated.
- Removed .trim() from git status output (line 536)
- Check for empty status using gitStatus.trim() in condition
- Correctly parse XY<space>filename format without truncation
- Removed diagnostic logging
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Improved logging for app updates to help diagnose update issues:
- Added DEBUG_UPDATER env var for verbose electron-updater logging
- Better console output showing update check status
- Clear message when running in dev mode (updates disabled)
- Option to force updater init in dev mode for testing logs
When an app update is downloaded and ready to install, automatically opens the Settings dialog to the Updates section so users can easily install the update.
Changes:
- App.tsx: Listen for onAppUpdateDownloaded event and open settings
- AdvancedSettings.tsx: Add Electron app update UI with download/install buttons
- ipc.ts: Add app update methods to ElectronAPI interface
- settings-mock.ts: Add browser mocks for app update methods
Adds a streamlined release workflow that uses AI (Claude Haiku) to analyze git commits and suggest semantic version bumps (major/minor/patch). Automatically updates package.json, commits, and pushes using a safe git workflow that preserves user's current work.
New features:
- RELEASE_SUGGEST_VERSION IPC for AI-powered version suggestions
- bumpVersion() with safe git workflow (stash/checkout/commit/restore)
- VersionSuggestion type with bumpType and reasoning
- Updated ReleaseProgress to include bumping_version stage
Also replaces VERSION file detection with requirements.txt across the codebase.
- Enhanced detectAutoBuildSourcePath() to work across all platforms
- Separated dev vs production mode path resolution
- Added comprehensive path checking for Windows/Linux packaged apps
- Added debug logging (enable with AUTO_CLAUDE_DEBUG=1)
- Updated both settings-handlers.ts and project-handlers.ts
- Fixes 'Source path not configured' error on Windows/Linux
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Simplified main content area feedback to subtle background tint only
- Added dashed border hint when dragging but not over drop zone
- Made drop zone indicator more compact with smaller text/icons
- Added smooth transitions (150ms ease-out) for polish
- Reduced overlay opacity for less intrusive visual feedback
- Removed heavy ring effects that interfered with modal interactions
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Since the Referenced Files section is now always visible, remove the
conditional setShowFiles(true) in the useEffect that loads drafts.
Changes:
- Remove unused showFiles state variable
- Remove conditional that auto-expanded files section when restoring drafts
- Remove auto-expand call in handleDragEnd (section is always visible)
- Remove showFiles reset in resetForm
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Made referenced files section always visible in Create Task modal
- Added header with FolderTree icon and "Referenced Files" label
- Added count badge showing current/max files when files are present
- Added empty state hint: "Drag files from the file explorer to add references"
- Removed conditional showFiles rendering wrapper
- Section now shows before the Review Requirement Toggle
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Applied useDroppable ref to main form content div for drag-and-drop
- Added visual feedback (ring highlight, background change) when dragging files over the modal
- Visual states: blue ring when dragging over (can add), yellow ring when at max capacity
- Subtle ring indication when dragging but not over the drop zone
- Updated Referenced Files section to show visual feedback only during active drag
- Removed the compact collapsed drop zone (now redundant with main wrapper drop zone)
Remove the 'Reference Files (optional)' toggle button that controlled
the showFiles state for the collapsible section. The FolderTree icon
toggle with chevron is now removed from TaskCreationWizard.tsx.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Added instructions for initializing a git repository as a prerequisite for using Auto Claude.
- Included a section detailing the purpose of various folders created during the Auto Claude process, enhancing user understanding of the framework's structure.
- Reorganize layout for better visual hierarchy: title first, then description, then metadata
- Make badges more compact with smaller text (text-[10px]) and reduced padding (px-1.5 py-0)
- Separate priority badge in header from complexity/impact badges in footer
- Replace competitor insight text with icon-only badge (with tooltip)
- Reduce card padding from p-4 to p-3
- Change title from truncate to line-clamp-2 for better readability
- Move complexity and impact badges to dedicated metadata row at bottom
- Remove " impact" text suffix for cleaner look
- Shorten "Go to Task" button text to "Task"
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Introduced a new PTY Daemon to handle terminal processes, ensuring session continuity and efficient resource management.
- Added session persistence for terminal states, allowing recovery across app restarts.
- Implemented buffer management to optimize terminal output handling, reducing React re-renders.
- Enhanced flow control and scroll management for better user experience during high-velocity terminal output.
- Refactored terminal store to utilize the new buffer manager, improving performance and memory management.
- Added WebGL context management for enhanced rendering capabilities in terminals.
This update significantly improves terminal performance and reliability, especially during intensive operations.
- Add platform detection for terminal profile commands on Windows
- Set default selected agent profile to 'auto' across all users
- Fix display of correct merge target branch in worktree UI
- Add validation for invalid colorTheme fallback to prevent UI errors
- Remove outdated Sun/Moon toggle button from sidebar
---
## What's Changed
- feat: add customizable phase configuration in app settings by @AndyMik90 in aee0ba4
- feat: implement parallel AI merge functionality by @AndyMik90 in 458d4bb
- feat(graphiti): add Google AI as LLM and embedding provider by @adryserage in fe69106
- fix: create coroutine inside worker thread for asyncio.run by @AndyMik90 in f89e4e6
- fix: improve UX for phase configuration in task creation by @AndyMik90 in b9797cb
- fix: address CodeRabbit PR #69 feedback by @AndyMik90 in cc38a06
- fix: sort imports in workspace.py to pass ruff I001 check by @AndyMik90 in 9981ee4
- fix(ui): auto-close task modal when marking task as done by @AndyMik90 in 297d380
- fix: resolve Python lint errors in workspace.py by @AndyMik90 in 0506256
- refactor: move Agent Profiles from dashboard to Settings by @AndyMik90 in 1094990
- fix(planning): ensure planner agent writes implementation_plan.json by @AndyMik90 in 9ab5a4f
- fix(windows): add platform detection for terminal profile commands by @AndyMik90 in f0a6a0a
- fix: default agent profile to 'Auto (Optimized)' for all users by @AndyMik90 in 08aa2ff
- fix: update default selected agent profile to 'auto' by @AndyMik90 in 37ace0a
- style: enhance WorkspaceStatus component UI by @AndyMik90 in 3092155
- fix: display correct merge target branch in worktree UI by @AndyMik90 in 2b96160
- Improvement/refactor task sidebar to task modal by @AndyMik90 in 2a96f85
- fix: extract human-readable title from spec.md when feature field is spec ID by @AndyMik90 in 8b59375
- fix: task descriptions not showing for specs with compact markdown by @AndyMik90 in 7f12ef0
- Add comprehensive theme system with Forest, Neo, Retro, Dusk, Ocean, and Lime color schemes by @AndyMik90 in ba776a3, e2b24e2, 7589046, e248256, 76c1bd7, bcbced2
- Add ColorTheme type and configuration to app settings by @AndyMik90 in 2ca89ce, c505d6e, a75c0a9
- Implement device code authentication flow with timeout handling and fallback URL display by @AndyMik90 in 5f26d39, 81e1536, 1a7cf40, 4a4ad6b, 6a4c1b4, b75a09c, e134c4c
- fix(graphiti): address CodeRabbit review comments by @adryserage in 679b8cd
- fix(lint): sort imports in Google provider files by @adryserage in 1a38a06
## 2.6.0 - Multi-Provider Graphiti Support & Platform Fixes
### ✨ New Features
- **Google AI Provider for Graphiti**: Full Google AI (Gemini) support for both LLM and embeddings in the Memory Layer
- Add GoogleLLMClient with gemini-2.0-flash default model
- Add GoogleEmbedder with text-embedding-004 default model
- UI integration for Google API key configuration with link to Google AI Studio
- **Ollama LLM Provider in UI**: Add Ollama as an LLM provider option in Graphiti onboarding wizard
- Ollama runs locally and doesn't require an API key
- Configure Base URL instead of API key for local inference
- **LLM Provider Selection UI**: Add provider selection dropdown to Graphiti setup wizard for flexible backend configuration
- feat: add interactive competitor analysis viewer for roadmap by @AndyMik90 in 7ff326d
- fix: correct CompetitorAnalysisViewer to match type definitions by @AndyMik90 in 4f1766b
- fix: address multiple CodeRabbit review feedback items by @AndyMik90 in 48f7c3c
- fix: use stable React keys instead of array indices in RoadmapHeader by @AndyMik90 in 892e01d
- fix: additional fixes for http error handling and path resolution by @AndyMik90 in 54501cb
- fix: update worktree test to match intended branch detection behavior by @AndyMik90 in f1d578f
- fix: resolve CI lint and TypeScript errors by @AndyMik90 in 2e3a5d9
- feat: enhance roadmap generation with stop functionality and debug logging by @AndyMik90 in a6dad42
- fix: correct path resolution in runners for module imports and .env loading by @AndyMik90 in 3d24f8f
- fix: resolve React key warning in PhaseProgressIndicator by @AndyMik90 in 9106038
- fix: enable stuck task detection for ai_review status by @AndyMik90 in 895ed9f
- feat: map GitHub issue labels to task categories by @AndyMik90 in cbe14fd
- feat: add GitHub issue comment selection and fix auto-start bug by @AndyMik90 in 4c1dd89
- feat: enhance TaskCreationWizard with drag-and-drop support for file references and inline @mentions by @AndyMik90 in d93eefe
- cleanup docs by @AndyMik90 in 8e891df
- fix: correct git status parsing in merge preview by @AndyMik90 in c721dc2
- Update TaskReview component to refine conditional rendering for staged tasks, ensuring proper display when staging is unsuccessful by @AndyMik90 in 1a2b7a1
- auto-claude: subtask-2-3 - Refine visual drop zone feedback to be more subtle by @AndyMik90 in 6cff442
- auto-claude: subtask-2-1 - Remove showFiles auto-expand on draft restore by @AndyMik90 in 12bf69d
- auto-claude: subtask-1-3 - Create an always-visible referenced files section by @AndyMik90 in 3818b46
- auto-claude: subtask-1-2 - Add drop zone wrapper around main modal content area by @AndyMik90 in 219b66d
- auto-claude: subtask-1-1 - Remove Reference Files toggle button by @AndyMik90 in 4e63e85
## 2.4.0 - Enhanced Cross-Platform Experience with OAuth & Auto-Updates
### ✨ New Features
- Claude account OAuth implementation on onboarding for seamless token setup
- Integrated release workflow with AI-powered version suggestion capabilities
- Auto-upgrading functionality supporting Windows, Linux, and macOS with automatic app updates
- Git repository initialization on app startup with project addition checks
- Debug logging for app updater to track update processes
- Auto-open settings to updates section when app update is ready
### 🛠️ Improvements
- Major Windows and Linux compatibility enhancements for cross-platform reliability
- Enhanced task status handling to support 'done' status in limbo state with worktree existence checks
- Better handling of lock files from worktrees upon merging
- Improved README documentation and build process
- Refined visual drop zone feedback for more subtle user experience
- Removed showFiles auto-expand on draft restore for better UX consistency
- Created always-visible referenced files section in task creation wizard
- Removed Reference Files toggle button for streamlined interface
- Worktree manual deletion enforcement for early access safety (prevents accidental work loss)
### 🐛 Bug Fixes
- Corrected git status parsing in merge preview functionality
- Fixed ESLint warnings and failing tests
- Fixed Windows/Linux Python handling for cross-platform compatibility
- fix: correct git status parsing in merge preview by @AndyMik90 in c721dc2
- refactor: Update TaskReview component to refine conditional rendering for staged tasks by @AndyMik90 in 1a2b7a1
- feat: Enhance task status handling to allow 'done' status in limbo state by @AndyMik90 in a20b8cf
- improvement: Worktree needs to be manually deleted for early access safety by @AndyMik90 in 0ed6afb
- feat: Claude account OAuth implementation on onboarding by @AndyMik90 in 914a09d
- fix: Better handling of lock files from worktrees upon merging by @AndyMik90 in e44202a
- feat: GitHub OAuth integration upon onboarding by @AndyMik90 in 4249644
- chore: lock update by @AndyMik90 in b0fc497
- improvement: Improved README and build process by @AndyMik90 in 462edcd
- fix: ESLint warnings and failing tests by @AndyMik90 in affbc48
- feat: Major Windows and Linux compatibility enhancements with auto-upgrade by @AndyMik90 in d7fd1a2
- feat: Add debug logging to app updater by @AndyMik90 in 96dd04d
- feat: Auto-open settings to updates section when app update is ready by @AndyMik90 in 1d0566f
- feat: Add integrated release workflow with AI version suggestion by @AndyMik90 in 7f3cd59
- fix: Windows/Linux Python handling by @AndyMik90 in 0ef0e15
- feat: Implement Electron app auto-updater by @AndyMik90 in efc112a
- fix: Windows/Linux source path detection by @AndyMik90 in d33a0aa
- refactor: Refine visual drop zone feedback to be more subtle by @AndyMik90 in 6cff442
- refactor: Remove showFiles auto-expand on draft restore by @AndyMik90 in 12bf69d
- feat: Create always-visible referenced files section by @AndyMik90 in 3818b46
- feat: Add drop zone wrapper around main modal content by @AndyMik90 in 219b66d
- feat: Remove Reference Files toggle button by @AndyMik90 in 4e63e85
- docs: Update README with git initialization and folder structure by @AndyMik90 in 2fa3c51
- chore: Version bump to 2.3.2 by @AndyMik90 in 59b091a
## 2.3.2 - UI Polish & Build Improvements
### 🛠️ Improvements
- Restructured SortableFeatureCard badge layout for improved visual presentation
Bug Fixes:
- Fixed spec runner path configuration for more reliable task execution
---
## What's Changed
- fix: fix to spec runner paths by @AndyMik90 in 9babdc2
- feat: auto-claude: subtask-1-1 - Restructure SortableFeatureCard badge layout by @AndyMik90 in dc886dc
## 2.3.1 - Linux Compatibility Fix
### 🐛 Bug Fixes
- Resolved path handling issues on Linux systems for improved cross-platform compatibility
---
## What's Changed
- fix: Fix to linux path issue by @AndyMik90 in 3276034
## 2.2.0 - 2025-12-17
### ✨ New Features
- Add usage monitoring with profile swap detection to prevent cascading resource issues
- Option to stash changes before merge operations for safer branch integration
- Add hideCloseButton prop to DialogContent component for improved UI flexibility
### 🛠️ Improvements
- Enhance AgentManager to manage task context cleanup and preserve swapCount on restarts
- Improve changelog feature with version tracking, markdown/preview, and persistent styling options
- Refactor merge conflict handling to use branch names instead of commit hashes for better clarity
- Streamline usage monitoring logic by removing unnecessary dynamic imports
- Better handling of lock files during merge conflicts
- Refactor code for improved readability and maintainability
- Refactor IdeationHeader and update handleDeleteSelected logic
### 🐛 Bug Fixes
- Fix worktree merge logic to correctly handle branch operations
- Fix spec_runner.py path resolution after move to runners/ directory
- Fix Discord release webhook failing on large changelogs
- Fix branch logic for merge AI operations
- Hotfix for spec-runner path location
---
## What's Changed
- fix: hotfix/spec-runner path location by @AndyMik90 in f201f7e
- refactor: Remove unnecessary dynamic imports of getUsageMonitor in terminal-handlers.ts to streamline usage monitoring logic by @AndyMik90 in 0da4bc4
- feat: Improve changelog feature, version tracking, markdown/preview, persistent styling options by @AndyMik90 in a0d142b
- refactor: Refactor code for improved readability and maintainability by @AndyMik90 in 473b045
- feat: Enhance AgentManager to manage task context cleanup and preserve swapCount on restarts. Update UsageMonitor to delay profile usage checks to prevent cascading swaps by @AndyMik90 in e5b9488
- feat: Usage-monitoring by @AndyMik90 in de33b2c
- feat: option to stash changes before merge by @AndyMik90 in 7e09739
- refactor: Refactor merge conflict check to use branch names instead of commit hashes by @AndyMik90 in e6d6cea
- fix: worktree merge logic by @AndyMik90 in dfb5cf9
- test: Sign off - all verification passed by @AndyMik90 in 34631c3
- feat: Pass hideCloseButton={showFileExplorer} to DialogContent by @AndyMik90 in 7c327ed
- feat: Add hideCloseButton prop to DialogContent component by @AndyMik90 in 5f9653a
- fix: branch logic for merge AI by @AndyMik90 in 2d2a813
- fix: spec_runner.py path resolution after move to runners/ directory by @AndyMik90 in ce9c2cd
- refactor: Better handling of lock files during merge conflicts by @AndyMik90 in 460c76d
- fix: Discord release webhook failing on large changelogs by @AndyMik90 in 4eb66f5
- chore: Update CHANGELOG with new features, improvements, bug fixes, and other changes by @AndyMik90 in 788b8d0
- refactor: Enhance merge conflict handling by excluding lock files by @AndyMik90 in 957746e
- refactor: Refactor IdeationHeader and update handleDeleteSelected logic by @AndyMik90 in 36338f3
## What's New
### ✨ New Features
@@ -198,4 +924,4 @@
- **Draft Auto-Save**: Task creation state is now automatically saved when you navigate away, preventing accidental loss of work-in-progress.
### Bug Fixes
- Fixed task editing to support the same comprehensive options available in new task creation
- Fixed task editing to support the same comprehensive options available in new task creation
source .venv/bin/activate # On Windows: .venv\Scripts\activate
pip install -r requirements.txt
# Set up environment
cd apps/backend
cp .env.example .env
# Edit .env and add your CLAUDE_CODE_OAUTH_TOKEN (get it via: claude setup-token)
```
### Step 2: Run the Desktop UI
```bash
cd ../frontend
# Install dependencies
npm install
# Development mode (hot reload)
npm run dev
# Or production build
npm run build && npm run start
```
<details>
<summary><b>Windows users:</b> If installation fails with node-gyp errors, click here</summary>
Auto Claude automatically downloads prebuilt binaries for Windows. If prebuilts aren't available for your Electron version yet, you'll need Visual Studio Build Tools:
1. Download [Visual Studio Build Tools 2022](https://visualstudio.microsoft.com/visual-cpp-build-tools/)
2. Select "Desktop development with C++" workload
3. In "Individual Components", add "MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs"
4. Restart terminal and run `npm install` again
</details>
> **Note:** For regular usage, we recommend downloading the pre-built releases from [GitHub Releases](https://github.com/AndyMik90/Auto-Claude/releases). Running from source is primarily for contributors and those testing unreleased features.
## Pre-commit Hooks
We use [pre-commit](https://pre-commit.com/) to run linting and formatting checks before each commit. This ensures code quality and consistency across the project.
@@ -100,10 +200,10 @@ When you commit, the following checks run automatically:
| Check | Scope | Description |
|-------|-------|-------------|
| **ruff** | `auto-claude/` | Python linter with auto-fix |
# For features and bug fixes - ALWAYS branch from develop
git checkout develop
git pull origin develop
git checkout -b feature/my-new-feature
# For hotfixes only - branch from main
git checkout main
git pull origin main
git checkout -b hotfix/critical-fix
```
### Pull Request Targets
> ⚠️ **Important:** All PRs should target `develop`, NOT `main`!
| Your Branch Type | Target Branch |
|------------------|---------------|
| `feature/*` | `develop` |
| `fix/*` | `develop` |
| `docs/*` | `develop` |
| `refactor/*` | `develop` |
| `test/*` | `develop` |
| `chore/*` | `develop` |
| `hotfix/*` | `main` (maintainers only) |
| `release/*` | `main` (maintainers only) |
### Release Process (Maintainers)
When ready to release a new version:
```bash
# 1. Create release branch from develop
git checkout develop
git pull origin develop
git checkout -b release/v2.8.0
# 2. Update version numbers, CHANGELOG, final fixes only
# No new features allowed in release branches!
# 3. Merge to main and tag
git checkout main
git merge release/v2.8.0
git tag v2.8.0
git push origin main --tags
# 4. Merge back to develop (important!)
git checkout develop
git merge release/v2.8.0
git push origin develop
# 5. Delete release branch
git branch -d release/v2.8.0
git push origin --delete release/v2.8.0
```
### Beta Release Process (Maintainers)
Beta releases allow users to test new features before they're included in a stable release. Beta releases are published from the `develop` branch.
**Creating a Beta Release:**
1. Go to **Actions** → **Beta Release** workflow in GitHub
2. Click **Run workflow**
3. Enter the beta version (e.g., `2.8.0-beta.1`)
4. Optionally enable dry run to test without publishing
5. Click **Run workflow**
The workflow will:
- Validate the version format
- Update `package.json` on develop
- Create and push a tag (e.g., `v2.8.0-beta.1`)
- Build installers for all platforms
- Create a GitHub pre-release
**Version Format:**
```
X.Y.Z-beta.N (e.g., 2.8.0-beta.1, 2.8.0-beta.2)
X.Y.Z-alpha.N (e.g., 2.8.0-alpha.1)
X.Y.Z-rc.N (e.g., 2.8.0-rc.1)
```
**For Users:**
Users can opt into beta updates in Settings → Updates → "Beta Updates" toggle. When enabled, the app will check for and install beta versions. Users can switch back to stable at any time.
### Hotfix Workflow
For urgent production fixes that can't wait for the normal release cycle:
**1. Create hotfix from main**
```bash
git checkout main
git pull origin main
git checkout -b hotfix/150-critical-fix
```
**2. Fix the issue**
```bash
# ... make changes ...
git commit -m "hotfix: fix critical crash on startup"
```
**3. Open PR to main (fast-track review)**
```bash
gh pr create --base main --title "hotfix: fix critical crash on startup"
```
**4. After merge to main, sync to develop**
```bash
git checkout develop
git pull origin develop
git merge main
git push origin develop
```
```
main ─────●─────●─────●─────●───── (production)
↑ ↑ ↑ ↑
develop ──●─────●─────●─────●───── (integration)
↑ ↑ ↑
feature/123 ────●
feature/124 ──────────●
hotfix/125 ─────────────────●───── (from main, merge to both)
```
> **Note:** Hotfixes branch FROM `main` and merge TO `main` first, then sync back to `develop` to keep branches aligned.
### Commit Messages
@@ -326,17 +598,23 @@ git commit -m "WIP"
## Pull Request Process
1.**Fork the repository** and create your branch from `main`
1.**Fork the repository** and create your branch from `develop` (not main!)
```bash
git checkout develop
git pull origin develop
git checkout -b feature/your-feature-name
```
2. **Make your changes** following the code style guidelines
3. **Test thoroughly**:
```bash
# Python
pytest tests/ -v
# Python (from repository root)
npm run test:backend
# Frontend
cd auto-claude-ui && pnpm test && pnpm lint && pnpm typecheck
cd apps/frontend && npm test && npm run lint && npm run typecheck
```
4. **Update documentation** if your changes affect:
@@ -395,7 +673,7 @@ When requesting a feature:
Auto Claude consists of two main parts:
### Python Backend (`auto-claude/`)
### Python Backend (`apps/backend/`)
The core autonomous coding framework:
@@ -405,9 +683,9 @@ The core autonomous coding framework:
**Auto Claude is a desktop app that supercharges your AI coding workflow.** Whether you're a vibe coder just getting started or an experienced developer, Auto Claude meets you where you are.
- **Autonomous Tasks** — Describe what you want to build, and agents handle planning, coding, and validation while you focus on other work
- **Agent Terminals** — Run Claude Code in up to 12 terminals with a clean layout, smart naming based on context, and one-click task context injection
- **Safe by Default** — All work happens in git worktrees, keeping your main branch undisturbed until you're ready to merge
- **Self-Validating** — Built-in QA agents check their own work before you review
**The result?** 10x your output while maintaining code quality.
## Key Features
- **Parallel Agents**: Run multiple builds simultaneously while you focus on other work
- **Context Engineering**: Agents understand your codebase structure before writing code
- **Self-Validating**: Built-in QA loop catches issues before you review
- **Isolated Workspaces**: All work happens in git worktrees — your code stays safe
- **AI Merge Resolution**: Intelligent conflict resolution when merging back to main — no manual conflict fixing
- **Memory Layer**: Agents remember insights across sessions for smarter decisions
- **Cross-Platform**: Desktop app runs on Mac, Windows, and Linux
- **Any Project Type**: Build web apps, APIs, CLIs — works with any software project
## 🚀 Quick Start (Desktop UI)
The Desktop UI is the recommended way to use Auto Claude. It provides visual task management, real-time progress tracking, and a Kanban board interface.
- **Git repository** - Your project must be initialized as a git repo
- **Python 3.12+** - Required for the backend and Memory Layer
---
## 🎯 Features
## 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
| 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 |
| **Cross-Platform** | Native desktop apps for Windows, macOS, and Linux |
| **Auto-Updates** | App updates automatically when new versions are released |
---
## Interface
### Kanban Board
Plan tasks and let AI handle the planning, coding, and validation — all in a visual interface. Track progress from "Planning" to "Done" while agents work autonomously.
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.
Spawn up to 12 AI-powered terminals for hands-on coding. Inject task context with a click, reference files from your project, and work rapidly across multiple sessions.
**Power users:** Connect multiple Claude Code subscriptions to run even more agents in parallel — perfect for teams or heavy workloads.
### Insights
Have a conversation about your project in a ChatGPT-style interface. Ask questions, get explanations, and explore your codebase through natural dialogue.
### Ideation
Let AI help you create a project that shines. Rapidly understand your codebase and discover:
- Code improvements and refactoring opportunities
- Performance bottlenecks
- Security vulnerabilities
- Documentation gaps
- UI/UX enhancements
- Overall code quality issues
### Changelog
Write professional changelogs effortlessly. Generate release notes from completed Auto Claude tasks or integrate with GitHub to create masterclass changelogs automatically.
### Context
See exactly what Auto Claude understands about your project — the tech stack, file structure, patterns, and insights it uses to write better code.
### AI Merge Resolution
When your main branch evolves while a build is in progress, Auto Claude automatically resolves merge conflicts using AI — no manual `<<<<<<< HEAD` fixing required.
**How it works:**
1.**Git Auto-Merge First** — Simple non-conflicting changes merge instantly without AI
2.**Conflict-Only AI** — For actual conflicts, AI receives only the specific conflict regions (not entire files), achieving ~98% prompt reduction
4.**Syntax Validation** — Every merge is validated before being applied
**The result:** A build that was 50+ commits behind main merges in seconds instead of requiring manual conflict resolution.
### Additional Features
- **Insights** - Chat interface for exploring your codebase
- **Ideation** - Discover improvements, performance issues, and vulnerabilities
- **Changelog** - Generate release notes from completed tasks
---
## CLI Usage (Terminal-Only)
For terminal-based workflows, headless servers, or CI/CD integration, see **[guides/CLI-USAGE.md](guides/CLI-USAGE.md)**.
## ⚙️ How It Works
Auto Claude focuses on three core principles: **context engineering** (understanding your codebase before writing code), **good coding standards** (following best practices and patterns), and **validation logic** (ensuring code works before you see it).
### The Agent Pipeline
**Phase 1: Spec Creation** (3-8 phases based on complexity)
Before any code is written, agents gather context and create a detailed specification:
1.**Discovery** — Analyzes your project structure and tech stack
2.**Requirements** — Gathers what you want to build through interactive conversation
3.**Research** — Validates external integrations against real documentation
4.**Context Discovery** — Finds relevant files in your codebase
5.**Spec Writer** — Creates a comprehensive specification document
6.**Spec Critic** — Self-critiques using extended thinking to find issues early
7.**Planner** — Breaks work into subtasks with dependencies
8.**Validation** — Ensures all outputs are valid before proceeding
**Phase 2: Implementation**
With a validated spec, coding agents execute the plan:
1.**Planner Agent** — Creates subtask-based implementation plan
2.**Coder Agent** — Implements subtasks one-by-one with verification
3.**QA Reviewer** — Validates all acceptance criteria
4.**QA Fixer** — Fixes issues in a self-healing loop (up to 50 iterations)
Each session runs with a fresh context window. Progress is tracked via `implementation_plan.json` and Git commits.
**Phase 3: Merge**
When you're ready to merge, AI handles any conflicts that arose while you were working:
1.**Conflict Detection** — Identifies files modified in both main and the build
2.**3-Tier Resolution** — Git auto-merge → Conflict-only AI → Full-file AI (fallback)
4.**Staged for Review** — Changes are staged but not committed, so you can review before finalizing
### 🔒 Security Model
Three-layer defense keeps your code safe:
- **OS Sandbox** — Bash commands run in isolation
- **Filesystem Restrictions** — Operations limited to project directory
- **Command Allowlist** — Only approved commands based on your project's stack
### 🧠 Memory Layer
The Memory Layer is a **hybrid RAG system** combining graph nodes with semantic search to deliver the best possible context during AI coding. Agents remember insights from previous sessions, discovered codebase patterns persist and are reusable, and historical context helps agents make smarter decisions.
**Architecture:**
- **Backend**: FalkorDB (graph database) via Docker
- **Library**: Graphiti for knowledge graph operations
- **Providers**: OpenAI, Anthropic, Azure OpenAI, or Ollama (local/offline)
| Setup | LLM | Embeddings | Notes |
|-------|-----|------------|-------|
| **OpenAI** | OpenAI | OpenAI | Simplest - single API key |
| **Anthropic + Voyage** | Anthropic | Voyage AI | High quality |
We welcome contributions! Whether it's bug fixes, new features, or documentation improvements.
# Run in development mode
npm run dev
See **[CONTRIBUTING.md](CONTRIBUTING.md)** for guidelines on how to get started.
# Or build and run
npm start
```
## Acknowledgments
**System requirements for building:**
- Node.js 24+
- Python 3.12+
- npm 10+
This framework was inspired by Anthropic's [Autonomous Coding Agent](https://github.com/anthropics/claude-quickstarts/tree/main/autonomous-coding). Thank you to the Anthropic team for their innovative work on autonomous coding systems.
See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed development setup.
---
## 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
| 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 lint` | Run linter |
| `npm test` | Run frontend tests |
| `npm run test:backend` | Run backend tests |
---
## Contributing
We welcome contributions! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for:
**AGPL-3.0** - GNU Affero General Public License v3.0
This software is licensed under AGPL-3.0, which means:
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.
- **Attribution Required**: You must give appropriate credit, provide a link to the license, and indicate if changes were made. When using Auto Claude, please credit the project.
- **Open Source Required**: If you modify this software and distribute it or run it as a service, you must release your source code under AGPL-3.0.
- **Network Use (Copyleft)**: If you run this software as a network service (e.g., SaaS), users interacting with it over a network must be able to receive the source code.
- **No Closed-Source Usage**: You cannot use this software in proprietary/closed-source projects without open-sourcing your entire project under AGPL-3.0.
**In simple terms**: You can use Auto Claude freely, but if you build on it, your code must also be open source under AGPL-3.0 and attribute this project. Closed-source commercial use requires a separate license.
For commercial licensing inquiries (closed-source usage), please contact the maintainers.
Commercial licensing available for closed-source use cases.
This document describes how releases are created for Auto Claude.
## Overview
Auto Claude uses an automated release pipeline that ensures releases are only published after all builds succeed. This prevents version mismatches between documentation and actual releases.
Some files were not shown because too many files have changed in this diff
Show More
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
coderabbitai[bot]