{"name":"ECC: The Agent Harness Performance Optimization System for LLMs","description":"ECC is an advanced agent harness performance optimization system, providing a coordinated engineering system and toolbox for LLM development. It enables agents to plan, test, implement, review, and learn effectively, enhancing productivity and security for AI-driven coding workflows across platforms like Claude Code, Codex, and Cursor.","github":"https://github.com/affaan-m/ECC","url":"https://osrepos.com/repo/affaan-m-ecc","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/affaan-m-ecc","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/affaan-m-ecc.md","json":"https://osrepos.com/repo/affaan-m-ecc.json","topics":["ai-agents","llm","developer-tools","productivity","javascript","claude-code","security","workflow-automation"],"keywords":["ai-agents","llm","developer-tools","productivity","javascript","claude-code","security","workflow-automation"],"stars":null,"summary":"ECC is an advanced agent harness performance optimization system, providing a coordinated engineering system and toolbox for LLM development. It enables agents to plan, test, implement, review, and learn effectively, enhancing productivity and security for AI-driven coding workflows across platforms like Claude Code, Codex, and Cursor.","content":"## Introduction\n\nECC is a comprehensive agent harness performance optimization system, designed to elevate the capabilities of large language models in coding environments. It provides a coordinated engineering system and toolbox, integrating skills, instincts, memory, and robust security features for a research-first development approach. ECC supports a wide range of platforms, including Claude Code, Codex, Opencode, Cursor, and other agent harnesses. This MIT-licensed open-source project, primarily written in JavaScript, offers a rich ecosystem of 68 specialized agents, 286 reusable skills, 94 command shims, and powerful hooks for runtime automation, continuous learning, and AgentShield security scanning.\n\n## Installation\n\nInstalling ECC is streamlined, but it is crucial to choose only one installation path per harness to avoid conflicts.\n\nFor **Claude Code**, the recommended approach is to use the guided package setup:\n\nbash\nnpx ecc-universal setup\n\n\nAlternatively, you can use the native Claude plugin commands:\n\nbash\n/plugin marketplace add https://github.com/affaan-m/ECC\n/plugin install ecc@ecc\n\n\nECC 2.2 also offers guided setup for Codex and Kimi Code via `npx ecc-universal install --guided`. For other agents and editors like Cursor, OpenCode, Gemini, Zed, and GitHub Copilot, specific selective installers or instruction layers are available, as detailed in the official documentation. Remember, do not stack installation methods for the same harness.\n\n## Examples\n\nECC empowers your agent with structured workflows for common development tasks:\n\n*   **Building a Feature:** Start with `/ecc:plan \"describe the feature\"` to create an implementation blueprint, then activate the `tdd-workflow` skill to enforce a test-driven approach.\n*   **Fixing a Bug:** Reproduce the bug with a failing test using the `tdd-workflow` skill, implement the fix, and verify the test passes.\n*   **Reviewing New Code:** Use `/code-review` for a fresh-context review, catching regressions and blind spots.\n*   **Repairing a Build:** The `/build-fix` command helps systematically resolve build errors.\n*   **Finding Security Vulnerabilities:** Run `/security-scan` to perform an OWASP Top 10 audit using AgentShield.\n\n## Why Use ECC?\n\nECC transforms unstructured agent interactions into a coordinated engineering process, offering significant advantages:\n\n*   **Structured Planning:** Plans become editable artifacts before implementation, rather than disappearing into chat history.\n*   **Enforced TDD:** Test-Driven Development is a gated RED -> GREEN -> REFACTOR workflow with clear evidence, not just an instruction the model might forget.\n*   **Fresh Context Review:** A dedicated, fresh-context reviewer identifies regressions and blind spots, improving code quality.\n*   **Intelligent Memory:** Sessions are distilled into summaries, instincts, and reusable skills, moving beyond enormous transcripts.\n*   **Automated Quality Checks:** Hooks enforce deterministic checks outside the prompt, ensuring consistent quality.\n*   **Agent Configuration Security:** AgentShield scans the harness itself as an attack surface, enhancing security.\n\nFurthermore, ECC's Memory Vault allows sharing context between different harnesses, providing a local, inspectable Markdown format for durable context and handoffs across Claude, Codex, Hermes, OpenClaw, and Kimi.\n\n## Links\n\n*   **GitHub Repository:** [https://github.com/affaan-m/ECC](https://github.com/affaan-m/ECC){:target=\"_blank\"}\n*   **Official Website:** [https://ecc.tools](https://ecc.tools){:target=\"_blank\"}\n*   **The Shorthand Guide:** [https://x.com/affaan/status/2012378465664745795](https://x.com/affaan/status/2012378465664745795){:target=\"_blank\"}\n*   **The Longform Guide:** [https://x.com/affaan/status/2014040193557471352](https://x.com/affaan/status/2014040193557471352){:target=\"_blank\"}\n*   **The Security Guide:** [https://github.com/affaan-m/ECC/blob/main/the-security-guide.md](https://github.com/affaan-m/ECC/blob/main/the-security-guide.md){:target=\"_blank\"}","metrics":{"detailViews":0,"githubClicks":0},"dates":{"published":null,"modified":"2026-08-27T23:24:57.000Z"}}