How 19h/ratio works
Ratio is a browser- or terminal-driven team of coding agents that plans, executes, reviews, and records repository changes. The main workflow starts with a user request, proceeds through team onboarding and a frozen task plan, dispatches workers through model/tool interactions, then verifies and approves changes for publication. The graph also includes its journal, staged workspaces, control interface, and key extension capabilities. Edges use README statements and source-index references; unsampled subsystem details are kept at directory level.
Main entry points: orchestrator.rs Run orchestrator · tools.rs Agent tools · web.rs Web server · ui.rs Terminal UI
Components 22
User interfaces
- Web dashboard
crates/ratio/src/web/dashboard.js - Web server
crates/ratio/src/web.rs - Terminal UI
crates/ratio/src/ui.rs - Run control
crates/ratio/src/control.rs
Planning and coordination
- Configuration
crates/ratio-engine/src/config.rs - Run orchestrator
crates/ratio-engine/src/orchestrator.rs - Team onboarding
crates/ratio-engine/src/orchestrator/onboarding.rs - Triage
crates/ratio-engine/src/orchestrator/triage.rs - Task graph
crates/ratio-protocol/src/plan.rs
Agent execution
- Model API
crates/ratio-engine/src/api.rs - Agent context
crates/ratio-engine/src/context.rs - Agent tools
crates/ratio-engine/src/tools.rs - Workspace search
crates/ratio-engine/src/tools/search.rs - MCP extensions
crates/ratio-engine/src/tools/mcp.rs - Local skills
crates/ratio-engine/src/tools/skills.rs - Verification
crates/ratio-engine/src/orchestrator.rs
Workspace and records
- Run session
crates/ratio-engine/src/session.rs - Staged workspace
crates/ratio-engine/src/staging.rs - SQLite journal
crates/ratio-engine/src/journal.rs - Usage budgets
crates/ratio-engine/src/budget.rs
Other components
- User
- OpenAI-compatible provider
Connections 26
- User → Web dashboard: describes goal
- Web dashboard → Web server: uses dashboard
- User → Terminal UI: starts run
- Terminal UI → Run orchestrator: runs orchestration
crates/ratio/src/ui.rs - Web server → Run orchestrator: starts runs
- Web server → Web dashboard: serves interface
crates/ratio/src/web.rs - Terminal UI → Run control: binds controls
crates/ratio/src/ui.rs - Run control → Run orchestrator: steers run
- Configuration → Run orchestrator: configures run
- Run orchestrator → Team onboarding: admits workers
crates/ratio-engine/src/orchestrator.rs - Run orchestrator → Triage: defers triage
crates/ratio-engine/src/orchestrator.rs - Run orchestrator → Task graph: dispatches dependencies
- Run orchestrator → Model API: requests completions
crates/ratio-engine/src/orchestrator.rs - Model API → OpenAI-compatible provider: sends requests
crates/ratio-engine/src/api.rs - Run orchestrator → Agent context: uses dialogue
crates/ratio-engine/src/context.rs - Run orchestrator → Agent tools: dispatches calls
crates/ratio-engine/src/orchestrator.rs - Agent tools → Workspace search: offers search
crates/ratio-engine/src/tools.rs - Agent tools → MCP extensions: dispatches MCP
crates/ratio-engine/src/tools.rs - Agent tools → Local skills: dispatches skills
crates/ratio-engine/src/tools.rs - Run orchestrator → Verification: runs verification
crates/ratio-engine/src/orchestrator.rs - Run orchestrator → Run session: updates progress
- Run orchestrator → Staged workspace: stages changes
- Run orchestrator → SQLite journal: records activity
- Run orchestrator → Usage budgets: enforces limits
- Run session → SQLite journal: persists run state
- Staged workspace → Verification: verifies candidate