TheDocumentation 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.
ecc install family of commands handles everything from deploying a named profile to a specific AI harness, to inspecting what would be installed, to discovering all available component IDs. All four commands (install, plan, catalog, consult) read the same bundled manifest files — manifests/install-profiles.json and manifests/install-modules.json — and share the same harness target list.
ecc install
Deploy ECC content into a supported AI harness target. ecc install resolves a profile or explicit module list against the bundled manifests, adapts the file set for the chosen target, copies files into the correct target directory, and writes an install-state record so subsequent doctor, repair, and auto-update calls can track the installation.
Usage
ecc typescript), positional language names are routed to ecc install for legacy compatibility.
Flags
Named install profile to resolve. Profiles map to curated sets of modules.Available profiles:
| Profile | Description |
|---|---|
minimal | Smallest useful footprint — core rules only |
opencode | Tuned defaults for the OpenCode harness |
core | Standard rules, hooks, and baseline skills |
developer | Full developer workflow with TDD, hooks, and MCP patterns |
security | Security-focused rules, skills, and audit hooks |
research | Research and API documentation modules |
full | All available modules for the selected target |
The AI harness to install into. Determines the destination directory and
adapter used for file placement.
Defaults to
| Target | Install root |
|---|---|
claude | ~/.claude/ (global) |
claude-project | ./.claude/ (per-project) |
cursor | ./.cursor/ |
codex | ~/.codex/ |
gemini | ./.gemini/ |
opencode | ~/.opencode/ |
zed | ./.zed/ |
codebuddy | ./.codebuddy/ |
joycode | ./.joycode/ |
hermes | ~/.hermes/ |
kimi | ./.kimi/ |
qwen | ~/.qwen/ |
openclaw | ~/.openclaw/ |
antigravity | ./.agent/ |
claude when --target is omitted.Comma-separated list of explicit module IDs to install, bypassing profile
resolution. Use
ecc catalog or ecc plan --list-modules to discover
available module IDs.Include an additional user-facing component by its selector ID, such as
capability:security or lang:python. Repeatable (pass --with multiple
times). May be combined with --profile or --modules.Exclude a user-facing component by its selector ID. Repeatable. Use to strip
unwanted modules from an otherwise complete profile.
Install one or more skill directories by ID, e.g.
continuous-learning-v2. Comma-separated. IDs are automatically prefixed
with skill: if not already present.Install translated documentation to
~/.claude/docs/<locale>/ (or ./.claude/docs/<locale>/ for
claude-project). Supported only on claude and claude-project targets.
Can be combined with --profile or --modules.Load the install intent from an
ecc-install.json configuration file. When
ecc-install.json is present in the project root it is auto-detected;
--config overrides that path.Show the resolved install plan — file copy operations, target directory, and
install-state path — without writing any files. Equivalent to running
ecc plan for the same arguments.Emit a machine-readable JSON object containing either the dry-run plan or the
applied result instead of the human-readable summary.
Examples
Output
Human-readable output reports the resolved plan followed by the list of file operations and the path where install-state was written:ecc plan
Inspect what a profile or module set would install — including selected modules, skipped modules (excluded by the target adapter), and the full file-operation list — without writing any files or mutating targets.
Usage
Flags
Print all available install profiles with their module counts and descriptions.
Print all install modules with their kind, supported targets, default-install
flag, cost, and stability metadata.
Print all user-facing install components. Filter by
--family or --target.Filter
--list-components output by component family, such as language,
capability, or framework.Resolve a named profile and print the selected modules, skipped modules (for
the given
--target), and the operation plan.Resolve explicit comma-separated module IDs and print the plan.
Filter the resolved plan for a specific harness target so skipped modules
(those not supported by the adapter) are highlighted.
Emit machine-readable JSON instead of the human-readable plan summary.
Examples
ecc catalog
Discover all available profiles, components, and module IDs from the bundled manifests. No flags are required — catalog subcommands give you a browsable view of everything installable.
Usage
Examples
ecc consult
Recommend ECC components, profiles, and module IDs based on a plain-English description of your project or workflow. ecc consult reads the manifest metadata and returns a ranked list of matching components.
Usage
Examples
ecc consult is a recommendation tool — it does not install anything. Pass
the suggested profile or module IDs to ecc install to apply them.