Agentrove

Agentrove (formerly Claudex) is a self-hosted AI coding workspace that runs Claude Code, Codex, Copilot, Cursor, and OpenCode via ACP (Agent Communication Protocol) adapters in per-workspace sandboxes. It provides a multi-panel workspace (chat, editor, terminal, diff, PR review side-by-side) with per-chat model selection and permission control.

Core Capabilities#

Multi-Agent Management

• Unified interface for Claude Code, Codex, Copilot, Cursor, OpenCode
• Per-chat model selection with different agents and permission modes per chat
• Claude permission modes: default / acceptEdits / plan / bypassPermissions
• Claude thinking modes: low / medium / high / max
• Codex permission modes: default / read-only / full-access
• Codex reasoning modes: low / medium / high / xhigh

Workspace & Sandboxing

• Per-workspace sandbox isolation (Docker container or Host mode)
• Chats within the same workspace share filesystem, tools, and authentication
• Git Worktree support: isolated implementation directories per chat
• Sub-threads: branch from existing chats

Editor & Terminal

• Built-in Monaco editor with multi-file search
• Built-in xterm.js terminal
• File attachment inline preview (images, PDFs, spreadsheets)

Chat Experience

• SSE streaming event output
• Support for cancellation and message queuing
• Permission prompt mechanism

Git & GitHub Integration

• Repository search, PR review, comments, collaborator management, reviewer selection
• Branch management, commit/PR description generation, PR creation, diff restore

Customization & Configuration

• Configurable Personas (reusable system prompts)
• Custom Skills
• Custom environment variable injection into agent runs
• Account-level global custom instructions

Authentication & Security

• Built-in registration, login, password reset, optional email verification
• Self-hosted with all data stored locally
• Local auth/config files syncable to sandboxes

Architecture Overview#

React/Vite Frontend (React 19, TypeScript, TailwindCSS, Zustand, React Query, Monaco, xterm.js)
        │
        ▼
   FastAPI Backend (SQLAlchemy, async)
        │
   ┌────┴────┐
   ▼         ▼
Web Mode: PostgreSQL + Redis    Desktop Mode: SQLite + In-memory cache/pubsub
        │                              │
        ▼                              ▼
   Workspace Sandbox (Docker or Host)
        │
   ┌────┼──────────┬────────────┬──────────┐
   ▼    ▼          ▼            ▼          ▼
claude-agent-acp  codex-acp  copilot-acp  cursor-agent  opencode
   │               │          │            │             │
   ▼               ▼          ▼            ▼             ▼
Claude Code CLI  Codex CLI  Copilot CLI  Cursor CLI  OpenCode CLI

Key Mechanisms:

• ACP Adapter Layer: Unifies agent CLI startup and communication via ACP adapters as the core abstraction
• Dual-Mode Storage: Web mode uses PostgreSQL + Redis; desktop mode uses SQLite + in-memory cache/pubsub (Python sidecar on localhost:8081)
• Sandbox Image: Published as ghcr.io/mng-dev-ai/agentrove-sandbox (GitHub Packages)
• Desktop Shell: Tauri (Rust, ~0.4% of codebase)
• Deployment Topology: Production frontend at /, API at /api/*, supports VPS/Coolify deployment

Installation & Deployment#

Web Mode (Docker Compose)#

Prerequisites: Docker, Docker Compose

git clone https://github.com/Mng-dev-ai/agentrove.git
cd agentrove
cp .env.example .env
openssl rand -hex 32  # Set as SECRET_KEY in .env
docker compose up -d
# Access http://localhost:3000

Default ports: Frontend 3000, Backend API 8080, PostgreSQL 5432, Redis 6379.

macOS Desktop Mode#

• Pre-built Apple Silicon DMG available from GitHub Releases
• Architecture: Tauri → React frontend → bundled Python backend sidecar (localhost:8081) → SQLite

Build from source (requires Node.js + Rust):

cd frontend
npm install
npm run desktop:dev    # Development
npm run desktop:build  # Production build

API Endpoints#

• API docs: http://localhost:8080/api/v1/docs
• Admin panel: http://localhost:8080/admin
• Health check: GET /health
• Readiness check: GET /api/v1/readyz

Unconfirmed Information#

• Discord invite link: mentioned in README but specific URL not shown
• Independent website/docs site: currently only GitHub README and docs/ directory
• Windows/Linux desktop support: currently macOS only, other platforms unknown
• ACP protocol specification: not linked to specification document
• API stability: v0.1.32, noted "Expect breaking changes between releases"
• Agent CLI prerequisites and version dependencies not detailed