How mrcoolbay/trame works
Trame coordinates coding agents sharing one project directory: agent file reads and writes are observed, writes are admitted through a per-project registry, and stale-read verdicts can become notices before the agent’s prompt. Out-of-band filesystem changes are noticed after the fact. The README documents an observing daemon, append-only journal, shared display state, and TUI/GUI interfaces; VCS support and multi-project supervision are not yet implemented. Several subsystem links below rely on README descriptions because their wiring source was not sampled.
Main entry points: session.rs Project daemon · actor.rs Registry actor · state.rs Display state · acp.rs ACP adapter
Components 22
Coordination core
- Project and session model
crates/trame-core/src/session.rs - Prompt and notices
crates/trame-core/src/prompt.rs - Admission verdicts
crates/trame-core/src/verdict.rs - Registry actor
crates/trame-registry/src/actor.rs - Admission state
crates/trame-registry/src/state.rs - Registry messages
crates/trame-registry/src/msg.rs
Project runtime
- Project daemon
crates/trame-daemon/src/session.rs - Filesystem watcher
crates/trame-daemon/src/watcher.rs - Observation handling
crates/trame-daemon/src/observe.rs
Audit storage
- Journal actor
crates/trame-journal/src/actor.rs - SQLite journal
crates/trame-journal/src/store.rs
User interfaces
- Display state
crates/trame-view/src/state.rs - Terminal interface
apps/trame-tui/src/ui.rs - Desktop interface
apps/trame-gui/src/view.rs
External integrations
- ACP adapter
crates/trame-agent/src/acp.rs - Agent events
crates/trame-agent/src/event.rs - CLI hook bridge
crates/trame-hook/src/bash.rs - VCS boundary
crates/trame-vcs/src/lib.rs
Other components
- User
- Coding agent
- Shell / tools
- GitButler CLI
Connections 24
- Coding agent → ACP adapter: requests file tools
README.md - ACP adapter → Agent events: emits requests
crates/trame-agent/src/acp.rs - ACP adapter → Registry actor: routes writes
README.md - Registry actor → Admission state: dispatches messages
crates/trame-registry/src/actor.rs - Registry actor → Registry messages: handles messages
crates/trame-registry/src/actor.rs - Admission state → Admission verdicts: produces verdicts
README.md - Registry actor → Journal actor: journals activity
README.md - Journal actor → SQLite journal: writes records
crates/trame-journal/src/actor.rs - Filesystem watcher → Observation handling: reports changes
README.md - Observation handling → Registry actor: reports external writes
README.md - Project daemon → Filesystem watcher: starts watcher
- Project daemon → Prompt and notices: places notices
README.md - Registry actor → Project daemon: returns verdicts
- Shell / tools → Filesystem watcher: changes noticed after
README.md - User → CLI hook bridge: invokes hooks
README.md - CLI hook bridge → Project daemon: uses project socket
README.md - Project daemon → Display state: supplies observations
README.md - Display state → Terminal interface: feeds display
README.md - Display state → Desktop interface: feeds display
README.md - User → Terminal interface: observes coordination
README.md - User → Desktop interface: observes coordination
README.md - Project daemon → Project and session model: tracks project sessions
README.md - Project daemon → VCS boundary: VCS integration planned
README.md - GitButler CLI → VCS boundary: invoked externally
README.md