Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/affaan-m/ECC/llms.txt

Use this file to discover all available pages before exploring further.

The ecc binary is the single entry point for every ECC operation — installing content into AI harnesses, inspecting manifests, diagnosing drift, querying the SQLite state store, and managing multi-agent orchestration. It is exposed as the ecc bin field in the ecc-universal npm package (scripts/ecc.js) and is also reachable without a global install via npx ecc.

​
Requirements

  • Node.js ≥ 18 — required for the ecc binary and all sub-scripts.
  • No other runtime dependencies are required for basic install and diagnostic operations; the SQLite state store commands require the bundled better-sqlite3 package shipped with ecc-universal.

​
Installation

npm install -g ecc-universal
After installation, ecc, ecc-install (legacy compat), and ecc-control-pane are all available on PATH.

​
Usage

ecc <command> [options]
ecc [install args...]         # args without a command name route to "install"
ecc --dry-run <command> [args] # global dry-run prefix
Get help at any level: 
ecc --help
ecc help <command>
ecc <command> --help

​
Global Flag

​
--dry-run
flag
Preview the actions a command would take without executing any mutations. Sets the ECC_DRY_RUN=1 environment variable internally and is respected by all mutating commands (install, repair, auto-update, uninstall).

​
Command Reference

CommandDescription
installInstall ECC content into a supported target
planInspect selective-install manifests and resolved plans
catalogDiscover install profiles and component IDs
consultRecommend ECC components and profiles from a natural language query
control-paneRun the local ECC2 operator control pane
list-installedInspect install-state files for the current context
doctorDiagnose missing or drifted ECC-managed files
repairRestore drifted or missing ECC-managed files
auto-updatePull latest ECC changes and reinstall the current managed targets
statusQuery the ECC SQLite state store status summary
platform-auditAudit GitHub queues, discussions, roadmap, release, and security evidence
security-ioc-scanScan dependency and AI-tool persistence surfaces for active supply-chain IOCs
sessionsList or inspect ECC sessions from the SQLite state store
work-itemsTrack linked Linear, GitHub, handoff, and manual work items
session-inspectEmit canonical ECC session snapshots from dmux or Claude history targets
loop-statusInspect Claude transcripts for stale loop wakeups and pending tool results
uninstallRemove ECC-managed files recorded in install-state

​
install

Install ECC content into a supported harness target. See the full install reference for all flags and supported harnesses. 
ecc install --profile developer --target claude
ecc install --profile minimal --target cursor
ecc install --modules security,research-apis --target codex

​
plan

Inspect what a given profile or module set would install without writing any files. See the install reference for full usage. 
ecc plan --profile core --target cursor
ecc plan --list-profiles
ecc plan --list-modules

​
catalog

List every available install profile, component ID, and module ID from the bundled manifests. Useful for building custom --modules or --include selectors. 
ecc catalog profiles
ecc catalog components --family language
ecc catalog show framework:nextjs

​
consult

Recommend ECC components and profiles based on a natural language description of your project. 
ecc consult "security reviews"
ecc consult "TypeScript monorepo with React" --target cursor
ecc consult "I work on security-sensitive Python APIs"

​
control-pane

Launch the local ECC2 operator control pane — a loopback HTTP server serving a real-time dashboard of active sessions, worktree status, install health, and work items. See the orchestration reference. 
ecc control-pane --port 8765
ecc control-pane --read-only

​
list-installed

Show all ECC-managed harness targets and their installed modules by reading install-state files for the current home/project context. 
ecc list-installed
ecc list-installed --json
ecc list-installed --target claude

​
doctor

Diagnose missing or drifted ECC-managed files by comparing the installed files against the install-state record. Read-only — no files are changed. See the doctor / repair reference. 
ecc doctor
ecc doctor --target cursor
ecc doctor --json
Exits with code 1 when warnings or errors are found.

​
repair

Restore drifted or missing files by re-applying from the source manifest. See the doctor / repair reference. 
ecc repair
ecc repair --dry-run
ecc repair --target claude --json

​
auto-update

Pull the latest ECC repo changes and reinstall all currently managed targets using their original install-state request. Safe to run in CI. 
ecc auto-update
ecc auto-update --dry-run
ecc auto-update --target claude

​
status

Query the ECC SQLite state store for a full system snapshot: active sessions, recent skill run stats, install health, pending governance events, and linked work items. See the sessions reference. 
ecc status
ecc status --json
ecc status --markdown --write status.md
ecc status --exit-code

​
platform-audit

Operator readiness audit that checks GitHub PR/issue queues, GitHub Discussions, roadmap evidence, release pipeline state, and security signals across one or more repositories. 
ecc platform-audit
ecc platform-audit --json --allow-untracked docs/drafts/
ecc platform-audit --exit-code --repo affaan-m/ECC

​
security-ioc-scan

Scan dependency manifests, lockfiles, and AI-tool configuration surfaces for active supply-chain IOC (indicators of compromise) signatures. 
ecc security-ioc-scan
ecc security-ioc-scan --home

​
sessions

List recent ECC sessions or inspect a single session with worker, skill-run, and decision detail. See the sessions reference. 
ecc sessions
ecc sessions <session-id>
ecc sessions --json --limit 20

​
work-items

Track linked Linear issues, GitHub issues/PRs, handoff items, and manual roadmap items in the ECC state store. 
ecc work-items list
ecc work-items upsert linear-ecc-20 --source linear --source-id ECC-20 \
  --title "Review control-plane contract" --status blocked
ecc work-items sync-github --repo affaan-m/ECC

​
session-inspect

Emit canonical ECC session snapshots from dmux orchestration plans or Claude session history targets — useful for debugging, exporting context, or skill health analysis. 
ecc session-inspect claude:latest
ecc session-inspect .claude/plan/workflow.json
ecc session-inspect skills:health

​
loop-status

Inspect Claude transcript .jsonl files for stale ScheduleWakeup tool results and pending Bash tool calls, helping diagnose stuck or looping agent sessions. See the sessions reference. 
ecc loop-status
ecc loop-status --json
ecc loop-status --transcript ~/.claude/projects/-repo/session.jsonl
ecc loop-status --watch --watch-count 5

​
uninstall

Remove all ECC-managed files recorded in install-state for the current context. 
ecc uninstall
ecc uninstall --target antigravity --dry-run
ecc uninstall --json
ecc uninstall permanently removes ECC-managed files from the target harness directory. Always run with --dry-run first to preview what will be deleted.

​
Compatibility Aliases

AliasRoutes to
ecc-install <args>ecc install <args> — legacy entrypoint preserved for existing CI flows
ecc <language>ecc install <language> — legacy language-based implicit install
ecc-control-paneecc control-pane — direct bin alias

Build docs developers (and LLMs) love

Get started for freeTalk to us