How manuel-alvarez-alvarez/ariadne works
Ariadne orchestrates AI coding agents through goal planning, task workflows, isolated worktrees and ACP sessions, with users able to monitor and intervene through the CLI or desktop. The daemon exposes REST/SSE and persists operational state; forge automation and permissions are additional product branches. README statements establish the main runtime flows; sampled files confirm CLI startup, task endpoint storage calls and desktop provider wiring. Many domain modules are unsampled, so their internal links are omitted or marked unverified.
Main entry points: http/mod.rs REST and streams · commands/mod.rs CLI commands · App.tsx Desktop app · tasks.rs Task workflows
Components 17
User interfaces
- CLI commands
crates/ariadne-cli/src/commands/mod.rs - Desktop app
ui/src/App.tsx - Agent console
crates/ariadne-console/src/tui/mod.rs
Daemon services
- REST and streams
crates/ariadne-daemon/src/http/mod.rs
Agent execution
- Goal planning
crates/ariadne-daemon/src/scheduler/goals.rs - Task workflows
crates/ariadne-daemon/src/scheduler/tasks.rs - Task worktrees
crates/ariadne-daemon/src/launcher.rs - ACP sessions
crates/ariadne-daemon/src/acp.rs
State and integrations
- Persistent state
crates/ariadne-store/src/tasks.rs - Forge automation
crates/ariadne-daemon/src/forge/mod.rs - Webhook intake
crates/ariadne-daemon/src/webhooks.rs - AI permissions
crates/ariadne-daemon/src/ai_permissions/server.rs
Shared protocol
- HTTP client
crates/ariadne-client/src/lib.rs - API contracts
crates/ariadne-api/src/lib.rs
Other components
- User
- ACP agent
- GitHub forge
Connections 21
- User → CLI commands: issues commands
README.md - User → Desktop app: uses
README.md - CLI commands → HTTP client: sends requests
- HTTP client → REST and streams: calls REST
README.md - Desktop app → REST and streams: uses REST/SSE
README.md - REST and streams → API contracts: serves contracts
- REST and streams → Persistent state: reads and writes
- Goal planning → Task workflows: creates tasks
- Task workflows → Task worktrees: launches tasks
crates/ariadne-daemon/src/scheduler/tasks.rs - Task workflows → ACP sessions: runs workflow steps
- Task worktrees → ACP agent: isolates checkout
README.md - ACP sessions → ACP agent: speaks ACP
README.md - ACP agent → ACP sessions: reports events
README.md - Desktop app → Agent console: renders session console
- CLI commands → Agent console: attaches inline
README.md - REST and streams → Forge automation: exposes forge actions
- Forge automation → GitHub forge: reads and updates
README.md - GitHub forge → Webhook intake: delivers signed events
README.md - Webhook intake → REST and streams: wakes daemon
- REST and streams → AI permissions: serves permission APIs
- AI permissions → Persistent state: persists settings