How woonyong-choi/saturn works
Saturn is a terminal chat tool that preserves one local conversation across Codex and Claude Code sessions. The user starts or resumes a chat in the CLI/TUI, sends requests that the engine records and routes to a provider, then sees results and can switch providers while retaining context. Other documented capabilities include follow-up routing, queued tasks, context handoff, permission prompts, chat export/pruning, and router training/version management. Edges follow the README’s designed workflow and the shown CLI/TUI excerpts; unsampled implementation details are not treated as verified calls.
Main entry points: src/main.rs CLI commands · src/main.rs Engine runtime · rpc.rs Protocol messages · app.rs Chat TUI
Components 22
User interface
- CLI commands
saturn-terminal/cli/src/main.rs - Chat TUI
saturn-terminal/tui/src/app.rs - TUI screens
saturn-terminal/tui/src/view - Key handling
saturn-terminal/tui/src/keymap/mod.rs - Localization
saturn-terminal/tui/src/i18n.rs
Engine workflow
- Protocol messages
saturn-protocol/src/rpc.rs - Protocol IDs
saturn-protocol/src/ids.rs - Input types
saturn-protocol/src/input.rs - Engine runtime
saturn-terminal/engine/src/main.rs - Input intake
saturn-terminal/engine/src/intake.rs - Request dispatch
saturn-terminal/engine/src/dispatch.rs
Context and policy
- Follow-up router
saturn-terminal/core/src/routers/mod.rs - Task queue
saturn-terminal/core/src/queue/tasks.rs - Context packets
saturn-terminal/core/src/sessions/context.rs - Permission rules
saturn-terminal/core/src/permission/mod.rs - Provider sessions
saturn-terminal/engine/src/sessions.rs - Router training
saturn-terminal/engine/src/training/trainer.rs
Provider integration
- Provider adapters
saturn-terminal/engine/src/providers/adapter.rs
Local records
- SQLite record store
saturn-terminal/engine/src/store/records.rs
Other components
- Developer
- Codex CLI
- Claude Code
Connections 24
- Developer → CLI commands: runs commands
README.md - CLI commands → Engine runtime: starts and connects
README.md - CLI commands → Chat TUI: opens chat
saturn-terminal/cli/src/main.rs - Chat TUI → TUI screens: renders screens
saturn-terminal/tui/src/app.rs - Chat TUI → Key handling: resolves keys
saturn-terminal/tui/src/app.rs - CLI commands → Protocol messages: sends requests
saturn-terminal/cli/src/main.rs - Chat TUI → Protocol messages: sends attach
saturn-terminal/tui/src/app.rs - Engine runtime → Protocol messages: serves requests
- Protocol messages → Protocol IDs: uses IDs
saturn-protocol/src/rpc.rs - Protocol messages → Input types: uses input types
saturn-protocol/src/rpc.rs - Engine runtime → Input intake: accepts input
- Input intake → SQLite record store: records input
README.md - Input intake → Follow-up router: routes follow-ups
README.md - Input intake → Task queue: queues tasks
README.md - Engine runtime → Request dispatch: dispatches work
- Request dispatch → Provider adapters: sends requests
README.md - Provider adapters → Codex CLI: invokes provider
README.md - Provider adapters → Claude Code: invokes provider
README.md - Request dispatch → Permission rules: checks permissions
README.md - Request dispatch → Provider sessions: manages sessions
README.md - Provider sessions → Context packets: builds handoff
README.md - Context packets → SQLite record store: reads conversation record
README.md - CLI commands → Router training: requests training
- Engine runtime → SQLite record store: persists records
README.md