// agents · affaan-m/ECC

ECC

Agent harness optimization system with skills, memory and security for Claude Code, Codex and more

★ 275.2k stars⑂ 41.1k forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

ECC is an open-source ai agents project by affaan-m (affaan-m/ECC on GitHub). It has 275,200 GitHub stars and 41,075 forks, is released under the MIT license, and was last updated on GitHub on 5 October 2026.

Repository
affaan-m/ECC
GitHub stars
275,200
Forks
41,075
License
MIT
Last updated on GitHub
5 October 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide what you want from ECC and check the README and requirements to confirm it fits your setup and JavaScript environment.

  2. Get the code

    Clone the repository from GitHub (github.com/affaan-m/ECC) or use the documented install channel if you do not need the source.

  3. Install and configure

    Follow the README quickstart to install dependencies and set any required configuration or credentials.

  4. Run your first task

    Work through the README's first example end to end, then adapt it to your own project or data.

// features

Why people love it

Multi-harness support

Works across Claude Code, Codex, OpenCode, Cursor and other agent harnesses from one setup.

Guided universal setup

The ecc-universal installer walks you through scope, hooks and profile choices before writing anything.

Skills and instincts

Ships reusable skills and instinct-style behaviours that shape how the agent plans and writes code.

Memory system

Adds persistent memory so agent behaviour and project context carry across sessions.

Security checks

Includes security-oriented components for reviewing agent actions and code changes.

Research-first workflow

Promotes a research-first development flow before implementation begins.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Start by getting the source and entering the project directory.

    git clone https://github.com/affaan-m/ECC.git
    cd ECC
  2. Run the guided installer

    Use the published npm package; pick one install path per harness, as the README instructs.

    npx ecc-universal@2.2.3 setup
  3. Or install with explicit options

    The guided install command lets you select harnesses such as Claude and Codex and preview with a dry run.

    npx ecc-universal@2.2.3 install --guided
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains ECC?

It is maintained by affaan-m and contributors on GitHub, where the repository github.com/affaan-m/ECC is the canonical home for code, issues and releases.

Is ECC free to use?

Yes — it is open source under the MIT license. Read the license in the repository for what is permitted, including any conditions on redistribution or commercial use.

Does it need a paid API key?

No. ECC itself needs no API key, but the underlying harness (for example Claude Code or Codex) uses your own account or API key.

How does ECC compare to alternatives?

Compared with plain Claude Code configuration: ECC layers skills, memory, hooks and security on top of a stock harness setup instead of leaving each user to hand-tune config files.

How do I get started?

Clone github.com/affaan-m/ECC, follow the README quickstart to install it, and run the documented first example before adapting it to your own work.

// keep exploring

Similar tools

AI Agents

holaOS

Local-first agentic workspace where Claude Code, Codex and a built-in agent share memory, apps and tools.

★ 11.5k starsModified Apache-2.0
View guide →
AI Agents

omnigent

Omnigent is an open-source AI agent framework and meta-harness: orchestrate Claude Code, Codex, Cursor, Pi, and custom agents — swap harnesses without rewrit…

★ 10.4k starsApache-2.0
View guide →
AI Agents

open-cowork

Open Cowork: a desktop AI agent app with one-click Claude Code, MCP tools, skills, and VM sandboxing.

★ 2.2k starsMIT
View guide →
Agents

obsidian-agent-client

Bring Claude Code, Codex, and Gemini CLI into Obsidian via Agent Client Protocol.

★ 2.4k starsApache-2.0
View guide →
Agents

cli-agent-orchestrator

Orchestrate Claude Code, Kiro, and Codex together in isolated tmux sessions.

★ 1.4k starsApache-2.0
View guide →
AI Agents

ai-berkshire

AI 时代的伯克希尔:基于 Claude Code / Codex 的价值投资研究框架。巴菲特·芒格·段永平·李录四大师方法论 + 多Agent并行研究。| AI-era Berkshire: a value investing research framework built for Claude Code /…

★ 16.6k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if ECC is not the right fit.

Get ECC

Free and open — grab the source, star the repo, and start creating.