How henomis/cicoria works
Cicoria is an interactive terminal workspace for supervising multiple coding-agent sessions, not an agent orchestrator. The main flow is user → CLI/workspace → session → agent process in a terminal; users inspect changes and status, send or queue messages, and persist workspace history. Separate branches provide backlog cards, timelines, worktrees, and an optional phone/browser cockpit. The excerpts show the workspace coordinating several layers; some capability links are documented by the README because their implementation was not sampled.
Main entry points: app.go Workspace model · session.go Session runtime · ipc.go Hook IPC · git.go Git operations
Components 24
Entry and workspace
- CLI entry
main.go - Workspace model
internal/app/app.go - Configuration
internal/config/config.go - Terminal workspace
internal/app/view.go
Agent sessions
- Session runtime
internal/session/session.go - Claude adapter
internal/agent/claude.go - Copilot adapter
internal/agent/copilot.go - Codex adapter
internal/agent/codex.go - Generic adapter
internal/agent/generic.go - PTY terminal
internal/term/term.go - Hook IPC
internal/ipc/ipc.go
Review and planning
- Git operations
internal/git/git.go - Diff review
internal/app/fullview.go - Message queue
internal/app/queue.go - Backlog board
internal/app/board.go - Worktree sessions
internal/app/commands.go - Activity timeline
internal/app/timeline.go - Timeline log
internal/app/timeline_log.go
Workspace state
- Session storage
internal/session/store.go - Event history
internal/session/ledger.go
Web cockpit
- Cockpit control
internal/app/web.go - Cockpit server
internal/web/web.go - Cockpit page
internal/web/page/app.js
Other components
- User
Connections 31
- User → CLI entry: opens workspace
- CLI entry → Configuration: loads settings
main.go - CLI entry → Workspace model: starts
main.go - Workspace model → Session runtime: manages sessions
internal/app/app.go - Workspace model → Terminal workspace: renders workspace
internal/app/app.go - Workspace model → Configuration: uses settings
internal/app/app.go - Workspace model → Hook IPC: listens for events
internal/app/app.go - Session runtime → PTY terminal: starts agent command
internal/session/session.go - Session runtime → Claude adapter: launches adapter
- Session runtime → Copilot adapter: launches adapter
- Session runtime → Codex adapter: launches adapter
- Session runtime → Generic adapter: launches adapter
- Claude adapter → Hook IPC: reports hook events
internal/agent/claude.go - Copilot adapter → Hook IPC: reports hook events
internal/agent/copilot.go - Codex adapter → Hook IPC: reports hook events
- Hook IPC → Workspace model: forwards events
- Workspace model → Git operations: reads repository state
internal/app/app.go - Diff review → Git operations: gets diffs
- Workspace model → Message queue: routes queued messages
- Backlog board → Session runtime: starts card session
- Worktree sessions → Git operations: creates worktrees
internal/app/commands.go - Activity timeline → Timeline log: shows activity log
- Workspace model → Session storage: remembers sessions
- Workspace model → Event history: records activity
- Workspace model → Cockpit control: controls sharing
internal/app/app.go - Cockpit control → Cockpit server: publishes cockpit
internal/app/web.go - Cockpit page → Cockpit server: receives snapshots
- Cockpit server → Git operations: serves change diffs
internal/web/web.go - User → Diff review: reviews changes
- User → Backlog board: writes backlog cards
- User → Activity timeline: inspects activity