How cmsued/gentle-ai works
Gentle-AI is a Go CLI and terminal application that adds deterministic configuration, memory, workflows, and review evidence to existing AI coding agents. The main user path enters through the CLI, then configures or synchronizes agent integrations; separate workflows support evidence-based review and persistent project context. Telemetry is a distinct collector service. The graph combines sampled call/reference evidence with README-documented capabilities; several subsystem internals were not sampled, so their connections are documented rather than asserted as inspected implementation calls.
Main entry points: install.go Install and sync · app.go Command dispatcher · review_lens_context.go Review workflow · main.go Gentle-AI CLI
Components 19
CLI and interaction
- Gentle-AI CLI
cmd/gentle-ai/main.go - Command dispatcher
internal/app/app.go - Terminal interface
internal/tui/router.go
Agent environment
- Install and sync
internal/cli/install.go - Install planning
internal/planner/resolver.go - Agent adapters
internal/agents/registry.go - Guidance injection
internal/components/agentguidance/orchestrator.go - User state
internal/state/state.go - Backup and restore
internal/backup/restore.go
Memory and review
- Review workflow
internal/cli/review_lens_context.go - Reviewer providers
internal/reviewerprovider/contract.go - Review transactions
internal/reviewtransaction/store.go - Engram memory
internal/components/engram/inject.go - ODD guidance
internal/components/agentguidance/routing.go
Telemetry services
- Agent telemetry
internal/telemetry/runtime.go - Telemetry collector
cmd/gentle-telemetry/main.go - Collector storage
internal/telemetrycollector/runtime_storage.go
Other components
- Developer
- Installed agents
Connections 18
- Developer → Gentle-AI CLI: runs
cmd/gentle-ai/main.go - Gentle-AI CLI → Command dispatcher: starts
cmd/gentle-ai/main.go - Command dispatcher → Terminal interface: launches
internal/app/app.go - Command dispatcher → Install and sync: dispatches
internal/app/app.go - Install and sync → Install planning: resolves plan
- Install and sync → Agent adapters: configures
- Install and sync → Guidance injection: installs components
- Install and sync → User state: persists selection
- Install and sync → Backup and restore: snapshots changes
- Guidance injection → Installed agents: injects guidance
- Developer → Review workflow: requests review
README.md - Review workflow → Reviewer providers: invokes provider
- Review workflow → Review transactions: records authority
internal/cli/review_lens_context.go - Engram memory → Installed agents: provides memory
README.md - ODD guidance → Installed agents: guides workflow
README.md - Installed agents → Agent telemetry: emits events
- Telemetry collector → Collector storage: stores events
cmd/gentle-telemetry/main.go - Agent telemetry → Telemetry collector: sends events