Documentation
Everything you need to know about Agent Context Relay (ACR).
Getting Started
Install ACR, set up your first project, and launch your first coding agent.
Terminal & PTY
Up to 50 concurrent PTY sessions, split panes, zoom, copy/paste, and command blocks.
Agent Context Relay
Capture, normalize, compact, and relay context between agents. The core ACR loop.
Git Worktrees
Automatic worktree creation, management, and cleanup. Per-branch terminal isolation.
Architecture
Rust backend (Tauri v2), SolidJS frontend, alacritty_terminal, MCP protocol.
Plugins & MCP
Plugin system with hot reload, MCP Proxy Hub, capability-gated runtime.
Getting Started
ACR (Agent Context Relay) is a cross-platform desktop application for running and managing multiple AI coding agents. It is built with Rust (Tauri v2) and SolidJS, providing a native-feeling terminal IDE with agent orchestration.
Installation
Pre-built binaries are coming soon. For now, build from source:
git clone https://github.com/AgentContextRelay/acr-tc.git cd acr-tc pnpm install pnpm tauri dev
Requirements: Rust 1.95+, Node.js 22+, pnpm 9+, macOS / Windows / Linux.
Terminal & PTY
ACR supports up to 50 concurrent PTY sessions, each running in its own terminal tab. Terminals are never unmounted — hidden tabs stay alive with full scroll history. Session state persists across app restarts.
- Split panes: up to 6 panes per tab, vertical and horizontal
- Zoom per-terminal: Cmd+= / Cmd+- / Cmd+0
- Copy/paste with trailing whitespace trimming
- Command blocks: navigable, collapsible terminal segments
- Auto-standby: SIGSTOP idle agent terminals to save CPU
- Foreground process detection on macOS and Windows
Agent Context Relay
The core innovation of ACR is the context relay loop:
- Capture — Record every agent session into a durable, append-only project record (
.acr/events.jsonl) - Normalize — Convert provider-specific transcripts into a provider-neutral model (supports Claude, Codex, Gemini)
- Compact — Generate a compact, inspectable handoff packet with decisions, open questions, and git state
- Relay — Deliver the packet to a target agent through the managed launch workflow
Handoff provenance events link source and target sessions, creating an auditable chain of agent continuity.
Git Worktrees
ACR fully manages Git worktrees: auto-creation on branch click, per-branch terminal isolation, and a Worktree Manager panel showing PR status, dirty file counts, and last commit at a glance.
Architecture
| Layer | Technology |
|---|---|
| Frontend | SolidJS + TypeScript + Vite |
| Backend | Tauri v2 (Rust) — ~190 Tauri commands |
| Terminal | alacritty_terminal (patched) + Canvas renderer |
| Editor | CodeMirror 6 |
| Speech | whisper-rs (local, GPU-accelerated) |
| Storage | JSON config + SQLite + JSONL (.acr/) |
| Agent Protocol | MCP + HTTP REST + WebSocket/SSE |
| Auth | OS keyring + OAuth 2.1 + bcrypt |
| Search | BM25 + text_rank |
Plugins & MCP
ACR supports plugins as ES modules with hot reload and crash isolation. The capability-gated runtime ensures plugins only access what they declare. The MCP Proxy Hub manages upstream MCP servers with credential management and OAuth support.