agent-orchestrator/docs/architecture/phases.md

Implementation Phases

See overview.md for system architecture and decisions.md for design decisions.

---

Phase 1: Project Scaffolding [complete]

• Tauri 2.x + Svelte 5 frontend initialized
• Catppuccin Mocha CSS variables, dev scripts
• portable-pty (used by WezTerm) over tauri-plugin-pty for reliability

---

Phase 2: Terminal Pane + Layout [complete]

• CSS Grid layout with responsive breakpoints (ultrawide / standard / narrow)
• Pane resize via drag handles, layout presets (1-col, 2-col, 3-col, 2x2, master+stack)
• xterm.js with Canvas addon (no WebGL on WebKit2GTK), Catppuccin theme
• PTY spawn from Rust (portable-pty), stream via Tauri events
• Copy/paste (Ctrl+Shift+C/V), SSH via PTY shell args

---

Phase 3: Agent SDK Integration [complete]

• Node.js/Deno sidecar using @anthropic-ai/claude-agent-sdk query() function
• Sidecar communication: Rust spawns process, stdio NDJSON
• SDK message adapter: 9 typed AgentMessage types
• Agent store with session state, message history, cost tracking
• AgentPane: text, tool calls/results, thinking, init, cost, errors, subagent spawn
• Session resume (resume_session_id to SDK)

---

Phase 4: Session Management + Markdown Viewer [complete]

• SQLite persistence (rusqlite), session groups with collapsible headers
• Auto-restore layout on startup
• Markdown viewer with Shiki highlighting and live reload via file watcher

---

Phase 5: Agent Tree + Polish [complete]

• SVG agent tree visualization with click-to-scroll and subtree cost
• Terminal theme hot-swap, pane drag-resize handles
• StatusBar with counts, notifications (toast system)
• Settings dialog, ctx integration, SSH session management
• 4 Catppuccin themes, detached pane mode, Shiki syntax highlighting

---

Phase 6: Packaging + Distribution [complete]

• install-v2.sh build-from-source installer (Node.js 20+, Rust 1.77+, system libs)
• Tauri bundle: .deb (4.3 MB) + AppImage (103 MB)
• GitHub Actions release workflow on v* tags
• Auto-updater with signing key

---

Phase 7: Agent Teams / Subagent Support [complete]

• Agent store parent/child hierarchy
• Dispatcher subagent detection and message routing
• AgentPane parent navigation + children bar
• Subagent cost aggregation
• 28 dispatcher tests including 10 for subagent routing

---

Multi-Machine Support (Phases A-D) [complete]

Architecture in ../multi-machine/relay.md.

Phase A: Extract agor-core crate

Cargo workspace with PtyManager, SidecarManager, EventSink trait in shared crate.

Phase B: Build agor-relay binary

WebSocket server with token auth, rate limiting, per-connection isolation, structured command responses.

Phase C: Add RemoteManager to controller

12 Tauri commands, heartbeat ping, exponential backoff reconnection with TCP probing.

Phase D: Frontend integration

remote-bridge.ts adapter, machines.svelte.ts store, routing via Pane.remoteMachineId.

Remaining

• Real-world relay testing (2 machines)
• TLS/certificate pinning

---

Extras: Claude Profiles & Skill Discovery [complete]

Claude Profile / Account Switching

• Reads ~/.config/switcher/profiles/ with profile.toml metadata
• Profile selector dropdown, config_dir passed as CLAUDE_CONFIG_DIR env override

Skill Discovery & Autocomplete

• Reads ~/.claude/skills/ (dirs with SKILL.md or .md files)
• / prefix triggers autocomplete menu in AgentPane
• expandSkillPrompt() injects skill content as prompt

Extended AgentQueryOptions

• setting_sources, system_prompt, model, claude_config_dir, additional_directories
• CLAUDE_CONFIG_DIR env injection for multi-account support

---

System Requirements

• Node.js 20+ (for Agent SDK sidecar)
• Rust 1.77+ (for building from source)
• WebKit2GTK 4.1+ (Tauri runtime)
• Linux x86_64 (primary target)