How entireio/cli works
Entire is a Git-integrated CLI that captures AI-agent sessions, associates their context with commits through checkpoints stored outside branch history, and lets users inspect or resume that work. The main workflow is repository enablement and agent-hook setup, background session capture, commit-triggered checkpointing, then status/search or checkpoint-based resume. Separate product branches include historical transcript import, review, and collaborative Trails. The README establishes the workflow; sampled source is limited, so edges for unsampled subsystems are omitted where their wiring cannot be confirmed.
Main entry points: root.go Command handlers · checkpoint.go Checkpoint operations · hooks.go Lifecycle hooks · registry.go Agent adapters
Components 22
CLI and Setup
- Entire CLI
cmd/entire/main.go - Command handlers
cmd/entire/cli/root.go - Enable and hooks
cmd/entire/cli/setup.go
Agent Session Capture
- Agent adapters
cmd/entire/cli/agent/registry.go - Lifecycle hooks
cmd/entire/cli/hooks.go - Transcript parsing
cmd/entire/cli/transcript/parse.go - Session state
cmd/entire/cli/session/state.go - Transcript import
cmd/entire/cli/agentimport/agentimport.go
Checkpoint and Git
- Commit strategy
cmd/entire/cli/strategy/strategy.go - Checkpoint operations
cmd/entire/cli/checkpoint/checkpoint.go - Checkpoint storage
cmd/entire/cli/checkpoint/store.go - Git remote helper
cmd/git-remote-entire/main.go
Search and Review
- Session activity
cmd/entire/cli/activity_cmd.go - Session search
cmd/entire/cli/search_cmd.go - Session resume
cmd/entire/cli/resume.go - Code review
cmd/entire/cli/review/cmd.go
Trails and Services
- Collaborative Trails
cmd/entire/cli/trail_cmd.go - API client
cmd/entire/cli/api/client.go
Other components
- Developer
- Supported AI agents
- Git repository
- Entire service API
Connections 26
- Developer → Entire CLI: runs commands
- Entire CLI → Command handlers: dispatches
- Command handlers → Enable and hooks: configures hooks
- Enable and hooks → Agent adapters: installs integrations
- Supported AI agents → Lifecycle hooks: fires hooks
- Lifecycle hooks → Agent adapters: selects adapter
- Agent adapters → Transcript parsing: parses sessions
- Lifecycle hooks → Session state: updates state
- Transcript parsing → Session state: records session
- Command handlers → Transcript import: imports history
- Transcript import → Transcript parsing: parses transcripts
- Git repository → Commit strategy: runs hooks on commits
- Commit strategy → Checkpoint operations: captures checkpoint
- Checkpoint operations → Checkpoint storage: reads and writes
- Checkpoint operations → Git repository: uses Git metadata
- Command handlers → Session activity: shows activity
- Command handlers → Session search: searches sessions
- Command handlers → Session resume: resumes session
- Session resume → Checkpoint operations: restores metadata
- Command handlers → Code review: runs reviews
- Code review → Checkpoint storage: reads context
- Command handlers → Collaborative Trails: manages Trails
- Collaborative Trails → API client: calls API
- API client → Entire service API: sends requests
- Git repository → Git remote helper: invokes for entire URLs
- Git remote helper → Entire service API: transfers Git data