How quantumwake/parley works
Parley is an enrolled, multi-agent conversation-recording and coordination product. Agent hooks and transcript tailers capture lifecycle, prompts, tools, and assistant text; the daemon pushes those events into conversations that agents and people can read, post to, follow, and coordinate through. The same capabilities are exposed through CLI/MCP, a local browser console, and a terminal UI. The graph follows documented flows and sampled references; some feature-to-plugin internals are unsampled, so those links are documented at the subsystem level.
Main entry points: main.go Parley CLI · conversation.go Conversation operations · push.go Event pusher · console.go Local console API
Components 25
Capture and ingest
- Hook capture
pkg/capture/hooks.go - Transcript readers
pkg/capture/transcript.go - Capture daemon
pkg/plugin/daemon.go - Event pusher
pkg/capture/push.go - Local event spool
pkg/spool/spool.go
Conversation domain
- Event contract
pkg/event/event.go - Coordination commands
pkg/plugin/shared.go - Session discovery
pkg/plugin/sessions.go - Follow and wait
pkg/plugin/wait.go - Conversation operations
pkg/conversation/conversation.go
Agent and user interfaces
- Parley CLI
cmd/parley/main.go - Agent setup
cmd/parley/setup.go - MCP tools
pkg/mcp/tools.go - Local console API
pkg/console/console.go - Browser console
console/src/App.jsx - Console entry
console/src/main.jsx - Conversation pane
console/src/Pane.jsx - Terminal UI
pkg/tui/tui.go
Identity and storage
- Enrollment
pkg/enroll/enroll.go - Store interface
pkg/store/store.go - Statefs adapter
pkg/store/statefs/statefs.go - Offline file store
pkg/store/file.go
Other components
- People and admins
- Agent CLIs
- statefs.ai organization
Connections 31
- People and admins → Parley CLI: runs commands
README.md - Agent CLIs → Agent setup: registers integration
README.md - Parley CLI → Agent setup: dispatches setup
cmd/parley/main.go - Parley CLI → MCP tools: serves MCP
cmd/parley/main.go - Parley CLI → Local console API: starts console
cmd/parley/main.go - Parley CLI → Terminal UI: starts TUI
cmd/parley/main.go - People and admins → Enrollment: enrolls identity
README.md - statefs.ai organization → Enrollment: issues tokens
README.md - Agent setup → Agent CLIs: registers hooks and MCP
README.md - Agent CLIs → Hook capture: sends lifecycle events
README.md - Hook capture → Capture daemon: shares capture path
README.md - Capture daemon → Transcript readers: tails transcripts
README.md - Capture daemon → Event pusher: pushes captured events
- Event pusher → Local event spool: drains events
pkg/capture/push.go - Event pusher → Conversation operations: appends events
pkg/capture/push.go - Event pusher → Event contract: prepares events
pkg/capture/push.go - Conversation operations → Store interface: reads and writes
pkg/conversation/conversation.go - Statefs adapter → Store interface: implements port
pkg/store/statefs/statefs.go - Offline file store → Store interface: implements port
pkg/store/file.go - MCP tools → Coordination commands: calls coordination commands
pkg/mcp/tools.go - Coordination commands → Conversation operations: uses conversation operations
- Session discovery → Store interface: queries namespaces
pkg/plugin/sessions.go - People and admins → Console entry: opens viewer
README.md - Console entry → Browser console: renders
console/src/main.jsx - Browser console → Conversation pane: shows conversation detail
console/src/App.jsx - Browser console → Local console API: requests API data
README.md - Local console API → Conversation operations: reads and posts
pkg/console/console.go - Local console API → Coordination commands: uses plugin features
pkg/console/console.go - People and admins → Terminal UI: uses terminal viewer
README.md - Terminal UI → Coordination commands: lists and reads
pkg/tui/tui.go - Follow and wait → Conversation operations: subscribes to posts
pkg/plugin/wait.go