affaan-m/ECC

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Summary

ECC is an MIT-licensed open source toolkit that layers a coordinated engineering workflow on top of AI coding agents. It ships 68 agents, 293 skills, and 94 legacy commands, along with hooks, memory, and security scanning, giving an agent a plan, test, implement, review, verify, and remember loop rather than free-form code generation. It targets Claude Code as its primary harness, with a supported Codex path and capability-limited adapters for Cursor, OpenCode, Gemini, Zed, and others.

What it is useful for

ECC is useful when an AI agent needs to do more than emit code in a single turn. It enforces a research-first loop where planning, TDD, review, and self-verification happen before completion, and it persists session notes, instincts, and rules so context is not lost between runs. AgentShield scans prompts, hooks, MCP config, permissions, secrets, and agent files for unsafe patterns. The system helps teams standardize agent behavior across harnesses, since one install path works for Claude Code, Codex, and Kimi Code, and adapters exist for Cursor, OpenCode, Gemini, Zed, GitHub Copilot, Antigravity, and Qwen.

How engineers can use it

For Claude Code, the README recommends the guided installer:

npx [email protected] setup

This requires Node.js 18 or newer, Git, and Claude Code 2.1 or newer on PATH. The alternative is the native Claude plugin path:

/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

For Codex, the repo registers as a native marketplace plugin via codex plugin marketplace add affaan-m/ECC followed by codex plugin add ecc@ecc. Other harnesses (Cursor, OpenCode, Gemini, Zed, etc.) require cloning the repo and running ./install.sh --profile minimal --target <name>, with OpenCode additionally needing npm install && npm run build:opencode before the full install.

Documented limitations: the Kimi Code adapter writes managed project files under ./.kimi-code but does not configure ECC hooks, model/provider settings, or authentication. Claude Code plugins cannot distribute rule packs, so rules must be copied manually from rules/common plus a language-specific pack. The README also warns that third-party re-uploads are not maintained and may contain malware, so installs should come only from the GitHub repository, the ecc-universal and ecc-agentshield npm packages, the GitHub App, the ecc@ecc plugin slug, or the ecc.tools website. Setup details for less mainstream harnesses may evolve, so the README remains the source of truth.