Big News: Socket raises $60M Series C at a $1B valuation to secure software supply chains for AI-driven development.Announcement
Sign In

kodelyth-ecc

Package Overview
Dependencies
Maintainers
1
Versions
25
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

kodelyth-ecc

Production-grade AI coding toolkit — 70 agents (incl. devil-mode adversarial crew), 194 skills, 97 commands, parallel multi-agent commands, semantic intent routing, self-learning memory, and a built-in MCP server (16 tools / 6 prompts / 377 resources) tha

latest
Source
npmnpm
Version
1.8.1
Version published
Maintainers
1
Created
Source
Kodelyth ECC — AI Agent Toolkit

npm version npm downloads GitHub Stars License Tests Claude Code Windsurf Antigravity Cursor Codex Agents Devil Mode Skills Memory Auto Recall Parallel Agents Image Generation

Kodelyth ECC is a production-grade AI coding toolkit — 70 specialist agents (incl. an 8-agent devil-mode adversarial crew), 194 skills, 97 commands, a god-tier semantic intent-routing system, local self-learning memory, MCP server, swarm orchestrator, and an observability dashboard — all local, zero telemetry.

Works with Claude Code, Windsurf, Cursor, Codex CLI, Google Antigravity, OpenCode, Cline, Roo Code, Aider, Kimi, and Gemini CLI.

No telemetry. No cloud. Just rules, agents, skills, MCP server, and your own private memory store — all on your disk. The local dashboard gives you full visibility without sending anything anywhere.

Why ECC ≠ Another Agent Collection

Most "AI agent kits" are folders of markdown files you have to remember the names of. ECC is infrastructure — a layered system where intent routing, compound memory, parallel orchestration, and quality hooks all reinforce each other.

You:   "I've been staring at this NullPointerException for two hours,
        I'm losing my mind."

AI:    → Routing to debug-detective (your error + frustration matches the bug-tracking signal)

       That kind of bug is exhausting — let's trace it properly so we
       fix the root cause, not the symptom.

       First, can you share the full stack trace and...

You never typed use debug-detective. You didn't have to. The toolkit read the intent, picked the specialist, and announced the routing. Next time you can invoke it directly — but you don't have to remember names to get senior-grade help.

The Layer Stack

LayerWhat it doesOther kits
Intent routingPlain-language → right specialist via 10-tier priority rulesMostly missing — you memorize names
70 agentsSpecialists with playbooks, severity calibration, real commandsOften persona-only ("you are a senior engineer...")
194 skillsDomain knowledge files agents read on demandRarely separated from agents
97 commandsSlash workflows (/tdd, /devil-mode, /team-review)Limited or none
8 parallel commandsFire 3-8 agents simultaneously, aggregate resultsRare
Compound memoryBM25 local recall + auto-inject + project lessonsCloud-only or absent
22+ hooksQuality gates, secret scan, project-DNA detectionOften missing
11 IDE platformsClaude Code, Windsurf, Cursor, Codex, Antigravity, OpenCode, Cline, Roo Code, Aider, Kimi, Gemini CLI (13 install targets)1-2 platforms typical
Zero telemetryEverything stays on your disk; verifiableMany kits phone home

Quick Comparison vs Other Kits

FeatureKodelyth ECCagency-agentsawesome-claude-agentsGeneric prompt libs
Specialist agents70~30~20Varies
Skills as separate layer✅ 194
Slash commands✅ 97SomeSome
Parallel multi-agent commands✅ 8 (incl. /devil-mode)
Intent routing (plain language → agent)✅ 10-tier rule
Local BM25 self-learning memory
Compound learning from correctionstasks/lessons.md
Adversarial / red-team agents✅ 8 (devil-mode)
Quality hooks✅ 22+Some
IDE platforms11 (Claude Code, Windsurf, Cursor, Codex, Antigravity, OpenCode, Cline, Roo Code, Aider, Kimi, Gemini CLI)1-21Varies
Telemetry❌ noneVariesVaries
Test coverage✅ 373 tests
Distributed vianpx, curl, cloneManualManualManual

Install

Install — One command, 11 platforms, any OS
npx kodelyth-ecc                              # Claude Code (default)
npx kodelyth-ecc --target windsurf-project    # Windsurf (per-project)
npx kodelyth-ecc --target windsurf-home       # Windsurf (global)
npx kodelyth-ecc --target cursor-project      # Cursor IDE
npx kodelyth-ecc --target codex-home          # Codex CLI
npx kodelyth-ecc --target antigravity         # Google Antigravity
npx kodelyth-ecc --target opencode            # OpenCode
npx kodelyth-ecc --target cline               # Cline (VS Code)
npx kodelyth-ecc --target roocode             # Roo Code (VS Code)
npx kodelyth-ecc --target aider               # Aider terminal agent
npx kodelyth-ecc --target kimi                # Kimi Code
npx kodelyth-ecc --target gemini-project      # Gemini CLI (project)
npx kodelyth-ecc --target gemini-home         # Gemini CLI (global)

Node.js 18+ required. Download Node if you don't have it.

Platform support at a glance

Feature depth varies by platform — hooks are a Claude Code native format, and some platforms have no agent/command concept:

PlatformAgentsSkillsCommandsHooksRules
Claude Code✓ 70✓ 194✓ 97✓ 22+
Roo Code
Codex CLI
Aider
Kimi
Windsurf
Antigravitypartial
Gemini CLI
Cursor
Cline
OpenCode

Hooks use Claude Code's JSON settings format — no equivalent exists on other platforms. Cursor reads rules and skills from .cursor/; its agent system uses a different format not yet compatible with ECC agents.

Memory & dashboard reality per IDE

Memory storage is a single shared file at ~/.kodelyth/memory/memories.jsonl — every IDE on the same machine reads and writes the same memories. The only thing that varies is how memories surface:

PlatformAuto-recall on every promptAuto-capture on successManual recall via MCP toolDashboard "Live IDE activity"
Claude Code✓ (hook)✓ (hook)✓ Claude session files
Windsurfrecall_memory✓ Windsurf + Windsurf-Next state
Cursorrecall_memory✓ workspace storage dirs
Codex CLIrecall_memory
Antigravityrecall_memory.agent/ in cwd
Roo Code / Aider / Kimi / Cline / Gemini CLI / OpenCode✓ if MCP-capable

What this means in practice:

  • A memory captured in Claude Code is recall-able from every other IDE the same day — the file is shared.
  • In Windsurf / Cursor / Codex / Antigravity, the AI does NOT auto-fire memory recall; the rules/common/memory-protocol.md rule (installed automatically) tells the AI to call the recall_memory MCP tool proactively at the start of substantive prompts.
  • The dashboard's Sessions → Live IDE activity tab surfaces session files for Claude Code, Windsurf, Windsurf-Next, Cursor, and Antigravity. Add custom paths via the KODELYTH_EXTRA_IDE_WATCH env var (comma-separated).
# Watch additional paths in the dashboard
export KODELYTH_EXTRA_IDE_WATCH="$HOME/my-agent-logs,$HOME/other-tool/state"
npx kodelyth-ecc dashboard

Option 2 — npx from GitHub (always latest commit)

npx github:sifxprime/kodelyth-ecc

Same --target flags work.

Option 3 — curl (macOS / Linux only)

curl -fsSL https://raw.githubusercontent.com/sifxprime/kodelyth-ecc/main/install.sh | bash

With a target:

curl -fsSL https://raw.githubusercontent.com/sifxprime/kodelyth-ecc/main/install.sh | bash -s -- --target windsurf-project

Power Bundles

Pre-configured for who you actually are:

npx kodelyth-ecc --bundle indie-hacker    # Solo founder / SaaS — ship fast, validate, harden
npx kodelyth-ecc --bundle red-team        # Security engineer — devil-mode + adversarial workflows
npx kodelyth-ecc --bundle enterprise      # Compliance / audit team — SBOM, license, supply chain

Each bundle installs the full ECC toolkit (all 70 agents, 194 skills, 97 commands, 22+ hooks), adds a BUNDLE.md cheat sheet, and biases the AI toward audience-fit workflows on every session.

Combine with any target:

npx kodelyth-ecc --bundle red-team --target windsurf-project
npx kodelyth-ecc --bundle enterprise --target codex-home
npx kodelyth-ecc --bundle indie-hacker --target antigravity

Option 4 — Clone and run

git clone https://github.com/sifxprime/kodelyth-ecc.git
cd kodelyth-ecc

# macOS / Linux
./install.sh                              # Claude Code (default)
./install.sh --target windsurf-project    # Windsurf

# Windows (PowerShell)
.\install.ps1
.\install.ps1 -Target windsurf-project

MCP Server — Universal Adapter

MCP Server — universal adapter for any agent framework

Run ECC as a Model Context Protocol server and consume it from Claude Desktop, LangGraph, AutoGen, CrewAI, OpenAI Agents SDK, Cursor, Windsurf — anything that speaks MCP.

npx kodelyth-ecc mcp                         # stdio JSON-RPC server

What it exposes (all local, zero telemetry):

  • 16 toolsroute_intent, recall_memory, capture_memory, list_agents, get_skill, audit_skill_match, …
  • 6 prompts — full intent routing rule, agents/skills/commands overviews, handoff chains, devil-mode
  • 365 resources — every agent, skill, command, rule, and bundle addressable via kodelyth://... URIs

Drop into Claude Desktop in 30 seconds:

// claude_desktop_config.json
{
  "mcpServers": {
    "kodelyth-ecc": {
      "command": "npx",
      "args": ["-y", "kodelyth-ecc", "mcp"]
    }
  }
}

Full reference: docs/mcp.md.

How Intent Routing Works

Intent routing — plain language to the right specialist agent

The toolkit ships with a single rule file (rules/common/agent-intent-routing.md) that the AI loads automatically on every session. It maps what you say to the right specialist agent across 10 priority tiers.

Two activation paths

1. Explicit — type it directly:

use debug-detective
@code-reviewer
invoke security-reviewer

2. Implicit — just describe your problem; the AI routes you:

What you writeAuto-routed to
"I'm stuck, no idea where to start"kodelyth-advisor
"I've been debugging this for hours"debug-detective
"nothing works, driving me crazy"debug-detective
"Should I use Context or Zustand?"pair-programmer
"help me build a todo app"/project-launch
"I have this idea for a SaaS dashboard"/project-launch
"I'm starting a new side project"/project-launch
"can you review my code?"code-reviewer or /team-review
"review my project before I deploy"/team-review
"is my project ready to ship?"/team-review
"my site looks plain, needs visuals"image-architect
"I need an OG image for my app"image-architect
"remember we always use pnpm here"/lessons
"Build failed on Vercel"build-error-resolver
"Is this JWT signing secure?"security-reviewer
"Why is this so slow?"performance-optimizer
"Plan the v2 migration"planner + migration-guide
"Tests pass locally but fail on CI"flake-hunter + env-debugger
"I lost my commits after reset --hard"git-rescue
"npm install is failing"dependency-doctor
"Cut a 1.4 release"release-captain
"Add accessibility to this form"ux-reviewer
"Open-source this project"opensource-forker (chain)
[paste code with no text]code-reviewer
[paste stack trace with no text]debug-detective

The AI always announces which agent is taking over (→ Routing to <agent>) and always teaches you the explicit form for next time (Tip: type "use <agent>"). No silent personality changes.

Multi-agent chains

Real problems span multiple specialties. ECC ships standard handoff chains:

pair-programmer  →  tdd-guide  →  code-reviewer  →  security-reviewer
(approach)         (write tests)  (review impl)     (auth, validation)
debug-detective  →  tdd-guide        →  refactor-cleaner
(root cause)        (regression test)   (cleanup)
opensource-forker  →  opensource-sanitizer  →  opensource-packager  →  release-captain
(clean fork)          (strip secrets)            (README, license)        (cut v0.1.0)

See skills/agent-handoff/SKILL.md for the full handoff protocol and standard chains.

Parallel Agents — 8 Commands, Minutes Not Hours

Parallel agents — fire multiple specialists simultaneously

Eight commands fire multiple specialist agents simultaneously and aggregate their results into a single structured report.

CommandAgents FiredTime Saved
/project-launcharchitect + pair-programmer + security-reviewer + tdd-guide + ux-reviewer45 min → 10 min
/team-reviewcode-reviewer + security-reviewer + performance-optimizer + api-guardian60 min → 15 min
/security-auditsecurity-reviewer + dependency-doctor + api-guardian30 min → 8 min
/debug-blitzdebug-detective + silent-failure-hunter + env-debugger60 min → 15 min
/refactor-sprintrefactor-cleaner + code-simplifier + type-design-analyzer + tdd-guide45 min → 12 min
/pre-releaserelease-captain + security-reviewer + code-reviewer30 min → 8 min
/onboardcode-explorer + architect + doc-updater45 min → 12 min
/devil-mode8 adversarial agents (see below)Hours → 20 min

Each command waits for all agents to complete, then returns a single Team Review Report with findings bucketed by severity: CRITICAL → HIGH → MEDIUM → LOW.

Devil Mode — 8 Adversarial Agents

Devil Mode — 8 adversarial agents, red-team your own code

8 adversarial agents that read your codebase the way an attacker would. Fire them in parallel with /devil-mode:

/devil-mode --pre-public    # before going open-source — full secret/license/IP sweep
/devil-mode --pre-launch    # before launch — adds AI red-team + chaos planning
/devil-mode --all           # all 8 adversarial agents in parallel

The crew: prompt-injection-hunter, supply-chain-auditor, secret-hunter, license-violation-finder, jailbreak-tester, code-stealer-detector, backdoor-hunter, chaos-engineer. Each ships with real bash-grep patterns, severity calibration, and remediation playbooks — not theatrical personas.

Live Dashboard — Full Visibility, Localhost Only

Dashboard — localhost observability, zero telemetry

You have a working, real-time dashboard. One command launches it:

npx kodelyth-ecc dashboard
# Opens http://127.0.0.1:5747 in your browser

What's inside:

TabWhat you see
OverviewAgent count, memory stats, session count, recent activity
MemoryBrowse, search, and manage your local BM25 memory store
EvolveSelf-improving memory — review AI-proposed refinements
CatalogFull searchable index of all 70 agents, 194 skills, 97 commands
SessionsLive IDE activity (Claude Code, Windsurf, Windsurf-Next, Cursor, Antigravity) + orchestration/swarm sessions

Real-time:

  • SSE push every 3 seconds, only when at least one browser tab is connected (zero CPU otherwise)
  • Watches memory writes, evolve signals, token-budget changes, and IDE session files
  • "Last activity" auto-updates without a page refresh
  • Set KODELYTH_EXTRA_IDE_WATCH=path1,path2 to watch additional paths

Security design:

  • GET-only — no write endpoints accessible from the UI
  • Localhost-bound — refuses connections from non-localhost Host headers (DNS rebinding protection)
  • Hardened headersContent-Security-Policy, X-Frame-Options, X-Content-Type-Options on every response
  • Zero telemetry — no external network calls ever leave your machine
  • Max 10 SSE clients — connection cap prevents resource exhaustion

Full reference: docs/dashboard.md.

Kodelyth Memory — Local Self-Learning

Kodelyth Memory — local BM25 self-learning memory

The first time you solve a hard problem, ECC remembers what worked. The next time you hit something similar, your AI surfaces the past solution before you ask.

Session 1 (March):
  You:  "Stripe webhook signatures are failing in production"
  AI:   [helps you debug, you discover raw body parser is required]
  You:  "Perfect, that worked, thanks"
  → ECC's Stop hook queues the lesson for review.
  → You confirm with /memory review-pending → stored locally.

Session 2 (August, new project):
  You:  "I need to add Stripe webhooks to checkout"
  AI:   I checked your memory — you solved this exact problem in March.
        Raw body parser before signature validation, test with stripe-cli
        not curl. Want me to apply the same pattern?
  You:  "Yes, do it"
  → 30 minutes of past debugging saved in 3 seconds.

How it works

LayerMechanism
CaptureA Stop hook scans your session JSONL, extracts (problem, approach, gotchas, tags). Queues for your review — never auto-stores.
Storage~/.kodelyth/memory/memories.jsonl — append-only log on your disk only. Override with KODELYTH_MEMORY_DIR.
RetrievalBM25 keyword + tag search. Pure JS, sub-millisecond, no embeddings, no network.
Session-start injectionA SessionStart hook builds a cache-friendly context block: stable prefix (your patterns + recent project memories) → variable suffix (relevant to current task).
Auto chat detectionA UserPromptSubmit hook watches every message you type, runs BM25 search on it, and injects relevant memories before the AI responds. Per-session repeat suppression.
Cost winThe stable prefix sits in the prompt cache. Anthropic charges 10% on cached tokens (5-min TTL); OpenAI auto-caches prefixes ≥1024 tokens. Long sessions become dramatically cheaper.

Privacy

Every byte stays on your machine. Verify any time with ls -la ~/.kodelyth/memory/. Sync across machines is opt-in (Dropbox/iCloud/git on that folder).

Slash command

/memory                          # Stats and recent memories
/memory recall <query>           # BM25 search
/memory remember "<title>"       # Capture (interactive — confirms before storing)
/memory review-pending           # Review Stop-hook candidates
/memory forget <id>              # Soft-delete a memory
/memory inject [--query <text>]  # Print what your AI sees about you

Honest limits

  • It is not model fine-tuning. The LLM never changes. We give it smarter context.
  • Cache savings apply to Anthropic and OpenAI. Other models (Gemini, Llama, Mistral) get the recall quality without the discount.
  • Cloud-AI platforms (Windsurf, Antigravity, partial Cursor) store sessions server-side. Auto-extract from past sessions doesn't work there. Manual /memory remember still does.

See skills/kodelyth-memory/SKILL.md for the full design + CLI reference.

Compound Learning System — Self-Improvement Loop

Compound learning — every correction stacks, Claude matches your style

Every correction you give Claude gets encoded into your project permanently. The toolkit gets smarter every session without any effort from you.

Session 1:  You type "use pnpm not npm"
            → Session ends
            → capture-correction.js scans the JSONL
            → Writes to tasks/lessons.md: "- use pnpm not npm"

Session 2:  read-lessons.js fires at session start
            → Injects: "PROJECT LESSONS — HARD RULES: - use pnpm not npm"
            → Claude uses pnpm without being told

Month 1:    10+ corrections stacked
            → Claude knows your naming style, preferred patterns, tech opinions
            → Zero ramp-up time on any new task

Month 3:    You try another tool
            → It uses npm. It uses the wrong pattern. It asks basic questions.
            → You come back.

Three-layer compound memory architecture

LayerFileScopeHow it works
Project Lessonstasks/lessons.mdPer-projectHard rules from your corrections. Injected at session start as mandatory context.
Global Memory~/.kodelyth/memory/Cross-projectBM25 fuzzy recall of past solutions. Auto-fires on every prompt you type.
Intent Routing70 agentsAlways-onRoutes your message to the right specialist from the first word. No names needed.

How it works under the hood

capture-correction.js — Stop hook, runs async at session end:

  • Scans session JSONL for 12 correction signal patterns ("no don't", "use X instead", "stop doing Y", "we always", "wrong approach", etc.)
  • Extracts them as plain-language rules
  • Appends them to tasks/lessons.md with date grouping

read-lessons.js — SessionStart hook, fires first before any other hook:

  • Reads tasks/lessons.md and formats rules as PROJECT LESSONS — HARD RULES block
  • Detects project DNA automatically: Node.js + framework (Next.js, React, NestJS, etc.), Go, Rust, Python, Java/Gradle, package manager (pnpm/bun/yarn/npm), test runner
  • Surfaces open tasks/todo.md items into session context

tasks/lessons.md — your project's rulebook

Edit it freely. Add rules manually. Remove rules that no longer apply. It's a plain markdown file at tasks/lessons.md in your project root.

# Claude Lessons

Project: **my-app**

## 2026-05-06

- use pnpm not npm
- never add try/catch without logging the error first
- we use Zod for validation, not Yup
- component files go in src/components, not src/app

What's Inside

ComponentCountDescription
Agents70Specialist subagents — reviewers, planners, debuggers, architects, devil-mode adversarial crew, incident-commander, load-tester, memory, image-architect
Skills194Domain knowledge — patterns, testing, security, DevOps, intent routing, memory
Commands97Slash command workflows (/tdd, /plan, /memory, /devil-mode, /doctor, /update, etc.)
Parallel commands8/devil-mode, /team-review, /security-audit, /debug-blitz, /refactor-sprint, /pre-release, /onboard, /project-launch
Hooks22+Quality gates, secret scanning, branch checks, memory inject + capture + correction + project DNA
Rules14Always-on coding standards + intent routing + memory protocol + self-improvement workflow
MemorylocalBM25-indexed personal memory at ~/.kodelyth/memory/ (zero deps)

Agent Arsenal

70 specialist agents — one for every situation
70 specialist agents — agent grid preview

Kodelyth Exclusives — The 16 Agents That Make ECC

AgentOne-line job
kodelyth-advisorMaster guide — picks the right tool when you don't know where to start
kodelyth-memoryCurates your local memory — recalls past solutions, captures new ones
pair-programmerThe engineer who sits next to you before you write the code
debug-detectiveNever guesses — traces every bug to root cause
silent-failure-hunterFinds bugs that don't throw errors
incident-commanderRuns production incidents — triage, contain, postmortem. P0s only.
load-testerLoad and stress testing — k6, Locust, Artillery, capacity planning
ux-reviewerReviews UX behavior + WCAG 2.1 AA accessibility (never touches design)
api-guardianDetects breaking API changes before they ship
migration-guideFramework / language version upgrades, phase by phase
dependency-doctornpm/pip/cargo/maven hell — CVE triage, lockfile diagnosis
git-rescueRecovers from broken git states without destroying history
release-captainOwns the release ritual — semver, tagging, publishing, rollback
env-debugger"Works on my machine" hunter — env, config, secrets, layers
flake-hunterStabilizes flaky tests — never adds blind retries
image-architectAI image generation — Gemini/DALL-E/fal.ai/SVG, platform-aware

Agent Categories

CategoryAgents
Guidancekodelyth-advisor, pair-programmer, planner, architect, code-architect, chief-of-staff, migration-guide
Code Reviewcode-reviewer, typescript-reviewer, python-reviewer, go-reviewer, rust-reviewer, java-reviewer, kotlin-reviewer, cpp-reviewer, csharp-reviewer, flutter-reviewer, database-reviewer, healthcare-reviewer
Build Fixersbuild-error-resolver, go-build-resolver, rust-build-resolver, java-build-resolver, kotlin-build-resolver, cpp-build-resolver, dart-build-resolver, pytorch-build-resolver, dependency-doctor, env-debugger
Debuggingdebug-detective, silent-failure-hunter, flake-hunter
Incident & Loadincident-commander, load-tester
Security & APIsecurity-reviewer, api-guardian
Performanceperformance-optimizer
Qualityrefactor-cleaner, code-simplifier, type-design-analyzer
Testingtdd-guide, e2e-runner, pr-test-analyzer, flake-hunter
Documentationdoc-updater, docs-lookup, comment-analyzer
Release & Opsrelease-captain, git-rescue
Open Sourceopensource-forker, opensource-packager, opensource-sanitizer
Specializedseo-specialist, ux-reviewer, code-explorer

Hooks — Always Running in Background

22+ automated quality hooks — PreToolUse, PostToolUse, Stop

Once installed (Claude Code target), these hooks run automatically with zero configuration:

HookWhat it does
Session start — lessonsReads tasks/lessons.md and injects your hard rules + project DNA as context
Session start — memoryLoads relevant past solutions from global BM25 memory
Auto chat recallWatches every prompt, injects relevant memories before AI responds
Correction captureDetects when you correct Claude, encodes the rule to tasks/lessons.md
Pre-commitCatches console.log, secrets, bad commit messages
Quality gateRuns type checks and formatting after edits
Git push reminderPrompts review before pushing
Config protectionBlocks weakening of linter/formatter configs
Desktop notifymacOS notification when a long task finishes
MCP health checkValidates MCP servers before calling them
Test reminderPrompts to write tests when code is edited without tests
Branch name checkBlocks git branches that don't match naming convention

Usage After Install

Start here (new users)

/kodelyth-quickstart

Core workflows — explicit invocation

use kodelyth-advisor      # Not sure what to do? Start here
use pair-programmer       # Think through approach before writing code
use planner               # Plan a feature before writing code
use code-reviewer         # Review after writing code
use debug-detective       # Trace a bug to its root cause
use api-guardian          # Check API changes for breaking contracts
use security-reviewer     # Review security-sensitive code
use ux-reviewer           # Review frontend UX and accessibility
use migration-guide       # Upgrading a framework or language version
use tdd-guide             # Write tests the right way
use performance-optimizer # Diagnose and fix slowness
use dependency-doctor     # npm/pip/cargo dep hell
use git-rescue            # Broken git state, lost commits, bad rebase
use release-captain       # Cut a clean release with rollback plan
use env-debugger          # "Works on my machine" — env/config/secrets
use flake-hunter          # Stabilize flaky tests

Or just describe your problem

The intent router will route you to the right one. The AI announces who's taking over, helps you, and tells you the explicit name for next time.

Load language patterns (skills)

/typescript-patterns    # TypeScript + React + Next.js
/python-patterns        # Python best practices
/golang-patterns        # Go best practices
/postgres-patterns      # Database patterns
/docker-patterns        # Container patterns
/coding-standards       # Universal baseline

Advanced skills

/git-mastery            # Trunk-based dev, rebase, bisect, monorepos
/observability          # Structured logging, metrics, OpenTelemetry, SLOs
/smart-debug            # Systematic debugging framework
/intent-routing         # How the auto-routing system works
/agent-handoff          # Standard multi-agent handoff chains

What Gets Installed

Claude Code — ~/.claude/

SourceDestinationWhat it does
agents/~/.claude/agents/All 70 subagents available globally
skills/~/.claude/skills/All 194 skills loadable via commands
hooks/hooks.json~/.claude/hooks/Automated quality gates
rules/~/.claude/rules/Always-on standards + intent routing
commands/~/.claude/commands/Slash commands (/tdd, /plan, etc.)

Windsurf — .windsurf/ (project) or ~/.codeium/windsurf/ (global)

SourceDestinationNotes
agents/.windsurf/agents/Call with use <agent-name> in Cascade
skills/.windsurf/skills/Domain knowledge, loadable via chat
rules/.windsurf/rules/Flattened rule files
rules/common/.windsurfrulesConcatenated — Windsurf reads this automatically every session

Cursor — .cursor/ in project root

SourceDestination
rules/.cursor/rules/
skills/.cursor/skills/

Codex CLI — ~/.codex/

SourceDestination
agents/~/.codex/agents/
skills/~/.codex/skills/
commands/~/.codex/commands/
rules/~/.codex/rules/

Antigravity — .agent/ in project root

SourceDestination
agents/.agent/skills/
commands/.agent/workflows/
rules/.agent/rules/

OpenCode — .opencode/ in project root

SourceDestination
rules/.opencode/rules/

Install Profiles — Language Bundles

Works with any target:

npx kodelyth-ecc --profile nextjs                              # Claude Code
npx kodelyth-ecc --target windsurf-project --profile nextjs    # Windsurf
npx kodelyth-ecc --target antigravity --profile python-api     # Antigravity

Available profiles:

ProfileIncludes
nextjsTypeScript + React + Next.js rules
python-apiPython + Django/FastAPI rules
fullstackTypeScript + Python + Go rules
mobileKotlin + Swift rules
backendGo + Python + Java rules

Or specify languages directly:

npx kodelyth-ecc typescript python golang rust java kotlin php swift cpp dart ruby elixir

Multi-Platform Support

PlatformSupportedInstall targetWhat gets installed
Claude CodeFullclaude-home (default)Agents, skills, commands, hooks, rules
WindsurfFullwindsurf-project / windsurf-homeAgents, skills, rules, .windsurfrules
CursorFullcursor-projectRules, skills
Codex CLIFullcodex-homeAgents, skills, commands, rules
Google AntigravityFullantigravityAgents → skills, commands → workflows, rules
OpenCodeRules onlyopencodeRules (agents + skills not yet supported by OpenCode)

OS support: macOS, Linux (install.sh), Windows (install.ps1), or any OS with Node.js 18+ (npx).

Privacy & Philosophy

ECC is 100% local files. No telemetry, no cloud, no account, no tracking. Everything is markdown your AI reads on every session.

  • No phoning home — install scripts copy files and exit. MCP server, dashboard, swarm, and replay all stay on localhost.
  • You own everything — fork the repo, edit any agent, write your own.
  • Verifiablenpx kodelyth-ecc verify checks your install against the sha256 manifest.

Contributing

We welcome new agents, skills, hooks, and intent routing patterns that meet the Kodelyth Standard — specialist personas, model-agnostic, production-grade examples.

When adding a new agent, also update rules/common/agent-intent-routing.md with your trigger patterns so the intent router knows when to call you.

See CONTRIBUTING.md for templates, checklists, and the full Kodelyth Standard.

Changelog

See CHANGELOG.md. v1.8.0 highlights:

  • Visual system overhaulgithub-social-preview.svg and og-image.svg fully redesigned with two-panel layout: brand left, 2×2 stat cards right, dot grid texture, amber accent
  • SVG overflow fixes — KODELYTH wordmark, bottom bar text, and stats numerals all corrected to stay within canvas bounds across all 31 social assets
  • Test count update — 373 tests across 25 test files (up from 348)
  • 4K PNG exports — all 31 social assets regenerated at 4× scale; fullhd exports removed

v1.7.3 highlights:

  • Social hype pack — 5 X/Twitter SVG cards + 5 thread scripts, full SVG version sync, GitHub issue templates, repo polish

v1.7.0 highlights:

  • MCP Server — 16 tools, 6 prompts, 377 resources; stdio JSON-RPC; zero telemetry; works with Claude Desktop, LangGraph, AutoGen, CrewAI, OpenAI Agents SDK
  • Dashboard hardening — DNS rebinding protection, shell injection fix (execFileSync), CSP on all responses, SSE client cap (max 10), TOCTOU fixes
  • Devil Mode — 8 adversarial agents, --pre-public / --pre-launch / --all flags, real bash-grep patterns and remediation playbooks
  • 336 tests passing across 25 test files (now 373 at v1.8.0)

v1.5.8 highlights:

  • zsh inline comment fixnpx kodelyth-ecc --target windsurf-home # comment no longer crashes.
  • Dynamic install counts — agent/skill/command counts computed from filesystem at install time.
  • Ruby + Elixir language rules — coding-style, patterns, testing, security, and hooks.
  • /doctor command — health check on your ECC install without leaving your IDE.
  • /update command — upgrade to the latest version automatically.
  • 5 new parallel commands (/security-audit, /pre-release, /debug-blitz, /refactor-sprint, /onboard).

v1.5.2 highlights:

  • Added: image-architect agent — platform-aware AI image generation (Gemini Imagen 3, DALL-E 3, fal.ai, SVG)
  • Added: /project-launch — 5 founding-team agents fire in parallel (45 min → 10 min)
  • Added: /team-review — 4 audit agents fire in parallel (60 min → 15 min)
  • Added: /lessons command — cross-platform lesson loading

v1.5.1 highlights:

  • Added: capture-correction.js Stop hook — auto-encodes corrections to tasks/lessons.md
  • Added: read-lessons.js SessionStart hook — injects lessons + project DNA before first message
  • Added: rules/common/self-improvement-workflow.md — 6-pattern self-improvement loop

v1.5.0 highlights:

  • Added: incident-commander — production incident response
  • Added: load-tester — load/stress testing with k6, Locust, Artillery

v1.4.0 highlights:

  • Added: kodelyth-memory — local self-learning memory (BM25, zero deps, cache-friendly)
  • Added: Auto chat detection hook, SessionStart injection, Stop hook queue

Author

Shofiqul Islam — Creator of Kodelyth ECC

Kodelyth ECC is designed and maintained by Shofiqul Islam — full-stack engineer and AI tooling builder.

PlatformLink
GitHub@sifxprime
X / Twitter@sifxprime
Facebookfacebook.com/sifxprime
Instagram@sifxprime
npmnpmjs.com/package/kodelyth-ecc

npm GitHub License Node

Built with craft. Zero telemetry. All yours.

Keywords

claude-code

FAQs

Package last updated on 30 May 2026

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts