ECC – Agent Harness Operating System

What it is

ECC (Agent Harness Operating System) is an open‑source framework that adds a full engineering workflow to AI coding agents such as Claude Code, Codex, and Kimi Code. It bundles a large library of agents (specialized AI assistants), skills (reusable actions like test‑driven development, security scanning, documentation, data handling, etc.), command shims, hooks, memory management, and a security scanner called AgentShield. Once installed, an agent can automatically plan → test → implement → review → verify → remember → improve without you having to script that loop in every prompt.

---

Key Features (as described in the README)

Feature	What you get
Agents	71 pre‑built agents for planning, code review, build repair, security, architecture, and domain‑specific work.
Skills	311 skill modules covering TDD, research, security, docs, front‑end, data, machine‑learning, ops, etc.
Commands	97 command‑line shims that expose the skills in a convenient surface.
Hooks & Memory	Runtime hooks for enforcement, session summaries, continuous learning, and context control; persistent memory that remembers important facts across sessions.
Rules	Selectable rule packs (e.g., language‑specific linting or style standards) that are always loaded.
AgentShield	Built‑in scanning for unsafe prompts, secret leakage, permission misuse, and malicious agent files.
Multi‑harness support	Native adapters for Claude Code, Codex, Kimi Code, and experimental adapters for Cursor, Antigravity, Gemini, Zed, GitHub Copilot, Qwen, and others.
Guided installation	npx ecc-universal@2.2.3 setup walks you through installing the ecc@ecc plugin for the chosen harness, handling scopes, hook profiles, and updates.
Pro version	Hosted GitHub App (ECC Pro) that enables private‑repo usage and additional enterprise features (paid per seat).

---

Installation (quick start)

1. Prerequisites – Node 18+, Git, and the target AI‑coding tool (e.g., claude CLI for Claude Code). Verify with:

   node --version
   git --version
   claude --version   # for Claude Code
   

2. Run the guided installer (works on Windows, macOS, Linux):

   npx ecc-universal@2.2.3 setup
   

   The wizard asks you which harness(es) to configure, which hook profile to use, and where to scope the plugin (global user, project, or local).
3. Verify – After setup, start a Claude Code session and run /plugin list to see ecc@ecc enabled, or use the Codex/​Kimi commands ecc-universal … for those platforms.
4. Optional – Install the GitHub App for private‑repo support (see the “ECC Pro + GitHub App” card in the README).

The README also provides alternative install paths: native Claude plugin commands (/plugin marketplace add …), manual rule‑pack copying, or declarative settings.json edits.

---

Supported Platforms / Harnesses

Harness	Installation method	Status
Claude Code	npx ecc-universal guided setup or native /plugin commands	Fully supported (v2.2)
Codex	Marketplace/plugin install via codex plugin marketplace …	Fully supported
Kimi Code	Managed files under ./.kimi-code (no automatic hook config)	Supported
Cursor, Antigravity, Gemini, Zed, OpenCode, etc.	Experimental adapters (ecc install --target <harness>)	Capability‑limited adapters

---

License & Funding

• License: MIT – the code remains free and open source forever.
• Funding model: The core project is maintained by a single maintainer who ships weekly updates across seven harnesses. Revenue comes from:
  • ECC Pro – a hosted GitHub App for private repositories (paid per seat).
  • Sponsorship – via GitHub Sponsors and corporate partners (Coderabbit, Greptile, Moonshot AI, Itô Markets, SerpApi, etc.).

---

Community & Resources

• Discord: https://discord.gg/36yGMHGFbR – Q&A, showcase, and support.
• Website: https://ecc.tools – documentation, pricing, and download links.
• GitHub: https://github.com/affian‑m/ECC – source, issue tracker, and contribution guide.
• NPM packages: ecc-universal (core installer) and ecc-agentshield (security scanner).
• GitHub App: https://github.com/apps/ecc-tools – for the Pro offering.
• Bug reports / feedback: Use the “install or runtime problem” issue template or run ecc feedback.

---

TL;DR

ECC is a comprehensive, MIT‑licensed toolbox that turns a raw LLM coding assistant into a disciplined engineering pipeline. Install it once (via npx ecc-universal@2.2.3 setup) and the agent will automatically plan, test, implement, review, verify, remember, and improve code across many programming languages and domains, with built‑in security checks and optional paid Pro features for private‑repo use.