How affaan-m/ecc works
ECC is a harness-native agent operating system: users configure and launch agent sessions, coordinate work, and inspect execution through a terminal dashboard. The Rust ecc2 runtime provides session management, persistence, communication, worktrees, notifications, and observability; the repository also includes evaluation tooling for measuring agent and Guard behavior. The graph emphasizes these supported runtime stages. Some subsystem wiring is inferred only from the SOURCE INDEX references, so unsampled implementation details and optional integrations are not expanded.
Main entry points: main.rs ECC CLI · manager.rs Session manager · store.rs State store · app.rs Terminal dashboard
Components 19
Session runtime
- ECC CLI
ecc2/src/main.rs - Configuration
ecc2/src/config/mod.rs - Session manager
ecc2/src/session/manager.rs - Session runtime
ecc2/src/session/runtime.rs - Session daemon
ecc2/src/session/daemon.rs - State store
ecc2/src/session/store.rs - Worktrees
ecc2/src/worktree/mod.rs
Agent coordination
- Agent messaging
ecc2/src/comms/mod.rs - Notifications
ecc2/src/notifications.rs - Observability
ecc2/src/observability/mod.rs
Operator interface
- Terminal dashboard
ecc2/src/tui/app.rs - Dashboard view
ecc2/src/tui/dashboard.rs
Evaluation tools
- Harness evaluator
ecc2/src/harness_eval.rs - AI evaluation library
docker/context-profiles/ai-eval-lib.js - Guard evaluation
docker/gateguard-effectiveness/lib.js - Guard variants
docker/gateguard-effectiveness/arms.js - Ticket service
docker/context-profiles/complex-eval/reference3/chained-tickets/src/service.js - Ticket routes
docker/context-profiles/complex-eval/reference3/chained-tickets/src/routes.js
Other components
- Operator
Connections 23
- Operator → ECC CLI: starts sessions
ecc2/src/main.rs - ECC CLI → Configuration: loads configuration
ecc2/src/main.rs - ECC CLI → Session manager: manages sessions
ecc2/src/main.rs - ECC CLI → State store: accesses state
ecc2/src/main.rs - ECC CLI → Agent messaging: uses messaging
ecc2/src/main.rs - ECC CLI → Notifications: uses notifications
ecc2/src/main.rs - ECC CLI → Observability: uses telemetry
ecc2/src/main.rs - ECC CLI → Terminal dashboard: launches dashboard
ecc2/src/main.rs - ECC CLI → Harness evaluator: runs evaluation
ecc2/src/main.rs - Session manager → Configuration: reads settings
ecc2/src/session/manager.rs - Session manager → Session runtime: starts runners
ecc2/src/session/manager.rs - Session manager → State store: persists sessions
ecc2/src/session/manager.rs - Session manager → Worktrees: manages worktrees
ecc2/src/session/manager.rs - Session manager → Agent messaging: coordinates agents
ecc2/src/session/manager.rs - Session manager → Notifications: sends notices
ecc2/src/session/manager.rs - Session manager → Observability: records activity
ecc2/src/session/manager.rs - Terminal dashboard → Dashboard view: renders view
ecc2/src/tui/app.rs - Terminal dashboard → State store: reads session state
ecc2/src/tui/app.rs - Observability → State store: logs tool calls
ecc2/src/observability/mod.rs - Agent messaging → State store: stores messages
ecc2/src/comms/mod.rs - Guard evaluation → AI evaluation library: runs scored checks
docker/gateguard-effectiveness/lib.js - Guard evaluation → Guard variants: compares variants
docker/gateguard-effectiveness/lib.js - Ticket routes → Ticket service: dispatches requests
docker/context-profiles/complex-eval/reference3/chained-tickets/src/routes.js