How atuinsh/atuin works
Atuin is a terminal history and agent-thread capture, search, resume, and synchronization product. Users invoke the CLI or shell search UI; recorded shell activity and supported agent sessions become searchable local history, while threads can be resumed across machines or harnesses. The README documents end-to-end encrypted sync and optional MCP access. The sampled sources show CLI dispatch, daemon RPC registration, search-engine selection, and agent-session persistence; several major feature links are documented in the README rather than verified in sampled implementation excerpts.
Main entry points: src/database.rs History database · ai_session/database.rs Thread storage and search · session.rs Thread commands · mcp.rs Agent MCP access
Components 22
User entry points
- Atuin CLI
crates/atuin/src/main.rs - Client commands
crates/atuin/src/command/client.rs
Shell history
- Interactive search
crates/atuin/src/command/client/search/engines.rs - History database
crates/atuin-client/src/database.rs - History capture
crates/atuin-client/src/history/capture.rs - Shell importers
crates/atuin-client/src/import/mod.rs
Agent threads
- Harness capture
crates/atuin-common/src/harnesstools/opencode/session.rs - Thread storage and search
crates/atuin-client/src/ai_session/database.rs - Thread commands
crates/atuin-ai/src/commands/session.rs - Resume workflow
crates/atuin-ai/src/commands/resume.rs - Resume interface
crates/atuin-ai/src/resume_tui/resumer.rs - Agent MCP access
crates/atuin-ai/src/mcp.rs
Local daemon
- Daemon event loop
crates/atuin-daemon/src/daemon.rs - Daemon RPC server
crates/atuin-daemon/src/server.rs - Daemon search
crates/atuin-daemon/src/search/mod.rs
Sync and service
- History sync engine
crates/atuin-daemon/src/octavo/client/active/engine.rs - Sync worker
crates/atuin-daemon/src/sync/engine/worker.rs - Sync service
crates/atuin-server/src/router.rs - Sync API client
crates/atuin-client/src/api_client.rs - Encrypted records
crates/atuin-common/src/encryption/paseto_v4.rs
Other components
- Terminal user
- AI agents
Connections 24
- Terminal user → Atuin CLI: runs
README.md - Atuin CLI → Client commands: dispatches
crates/atuin/src/main.rs - Terminal user → Interactive search: opens
README.md - Client commands → Interactive search: routes search
crates/atuin/src/command/client.rs - Interactive search → History database: queries
crates/atuin/src/command/client/search/engines.rs - History capture → History database: records commands
- Shell importers → History database: imports history
- Terminal user → Thread commands: runs threads
README.md - Harness capture → Thread storage and search: captures sessions
- Thread commands → Thread storage and search: searches threads
README.md - Thread commands → Resume workflow: routes resume
crates/atuin-ai/src/commands/session.rs - Resume workflow → Resume interface: opens interface
- AI agents → Agent MCP access: requests context
README.md - Agent MCP access → History database: searches history
- Agent MCP access → Thread storage and search: searches threads
- Daemon event loop → Daemon RPC server: serves RPCs
crates/atuin-daemon/src/server.rs - Daemon RPC server → Daemon search: registers search
crates/atuin-daemon/src/server.rs - Daemon search → History database: searches history
- History database → Sync worker: supplies history
- Thread storage and search → Sync worker: supplies threads
- Sync worker → History sync engine: coordinates sync
- History sync engine → Sync API client: uploads records
- Sync API client → Sync service: syncs remotely
README.md - History sync engine → Encrypted records: encrypts data
README.md