kodelyth-ecc 1.2.2 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -4,57 +4,69 @@
4
4
 
5
5
  [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
6
6
  ![Claude Code](https://img.shields.io/badge/Claude%20Code-Ready-8A2BE2)
7
+ ![Windsurf](https://img.shields.io/badge/Windsurf-Ready-06b6d4)
7
8
  ![Antigravity](https://img.shields.io/badge/Antigravity-Ready-00ADD8)
8
- ![Version](https://img.shields.io/badge/version-1.2.0-orange)
9
- ![Agents](https://img.shields.io/badge/Agents-53-brightgreen)
10
- ![Skills](https://img.shields.io/badge/Skills-185-brightgreen)
9
+ ![Cursor](https://img.shields.io/badge/Cursor-Ready-3b82f6)
10
+ ![Codex](https://img.shields.io/badge/Codex-Ready-10b981)
11
+ ![Version](https://img.shields.io/badge/version-1.3.0-orange)
12
+ ![Agents](https://img.shields.io/badge/Agents-58-brightgreen)
13
+ ![Skills](https://img.shields.io/badge/Skills-187-brightgreen)
11
14
 
12
15
  </div>
13
16
 
14
- **Kodelyth ECC** is a battle-tested, production-ready AI coding toolkit — 53 specialist agents, 185 skills, 79 commands, automated quality gates, and a real-time usage dashboard built in. Built and maintained by **Kodelyth**.
17
+ **Kodelyth ECC** is a production-grade AI coding toolkit — **58 specialist agents, 187 skills, 79 commands**, and a god-tier **intent-routing system** that auto-detects what you need and hands you the right specialist before you finish typing.
15
18
 
16
- Works with **Claude Code**, **Google Antigravity**, **Cursor**, **Codex CLI**, and **OpenCode**.
19
+ Works with **Claude Code**, **Windsurf**, **Cursor**, **Codex CLI**, **Google Antigravity**, and **OpenCode**.
20
+
21
+ > No dashboard. No telemetry. No cloud. Just rules, agents, and skills your AI loads on every session.
17
22
 
18
23
  ---
19
24
 
20
- ## Install
25
+ ## What Makes ECC Different
21
26
 
22
- ### Option 1 npx from npm (Node.js 18+, any platform)
27
+ Most "AI agent kits" are folders of markdown files you have to remember the names of. ECC has **intent routing** baked into the rules layer — you describe your problem in plain words, the AI announces which specialist is taking over, and you get senior-grade help without memorizing a directory.
23
28
 
24
- The simplest install. Node.js is the only requirement.
29
+ ```
30
+ You: "I've been staring at this NullPointerException for two hours,
31
+ I'm losing my mind."
25
32
 
26
- ```bash
27
- npx kodelyth-ecc
33
+ AI: → Routing to debug-detective (your error + frustration matches the bug-tracking signal)
34
+
35
+ That kind of bug is exhausting — let's trace it properly so we
36
+ fix the root cause, not the symptom.
37
+
38
+ First, can you share the full stack trace and...
28
39
  ```
29
40
 
30
- Install for a specific platform:
41
+ You never typed `use debug-detective`. You didn't have to.
42
+
43
+ ---
44
+
45
+ ## Install
46
+
47
+ ### Option 1 — npx from npm (recommended, any platform)
31
48
 
32
49
  ```bash
33
- npx kodelyth-ecc --target windsurf-project # Windsurf (project)
50
+ npx kodelyth-ecc # Claude Code (default)
51
+ npx kodelyth-ecc --target windsurf-project # Windsurf (per-project)
34
52
  npx kodelyth-ecc --target windsurf-home # Windsurf (global)
35
- npx kodelyth-ecc --target antigravity # Google Antigravity
36
53
  npx kodelyth-ecc --target cursor-project # Cursor IDE
37
54
  npx kodelyth-ecc --target codex-home # Codex CLI
55
+ npx kodelyth-ecc --target antigravity # Google Antigravity
38
56
  npx kodelyth-ecc --target opencode # OpenCode
39
57
  ```
40
58
 
41
- > Node.js not installed? Download it from [nodejs.org](https://nodejs.org) LTS version recommended.
42
-
43
- ---
59
+ Node.js 18+ required. [Download Node](https://nodejs.org) if you don't have it.
44
60
 
45
61
  ### Option 2 — npx from GitHub (always latest commit)
46
62
 
47
- Use this if you want the very latest unreleased version directly from the main branch.
48
-
49
63
  ```bash
50
64
  npx github:sifxprime/kodelyth-ecc
51
65
  ```
52
66
 
53
- Same `--target` flags apply.
54
-
55
- ---
67
+ Same `--target` flags work.
56
68
 
57
- ### Option 3 — curl (macOS / Linux)
69
+ ### Option 3 — curl (macOS / Linux only)
58
70
 
59
71
  ```bash
60
72
  curl -fsSL https://raw.githubusercontent.com/sifxprime/kodelyth-ecc/main/install.sh | bash
@@ -66,81 +78,76 @@ With a target:
66
78
  curl -fsSL https://raw.githubusercontent.com/sifxprime/kodelyth-ecc/main/install.sh | bash -s -- --target windsurf-project
67
79
  ```
68
80
 
69
- ---
70
-
71
- ### Option 4 — clone and run (all platforms)
81
+ ### Option 4 — Clone and run
72
82
 
73
83
  ```bash
74
84
  git clone https://github.com/sifxprime/kodelyth-ecc.git
75
85
  cd kodelyth-ecc
76
86
 
77
87
  # macOS / Linux
78
- ./install.sh # Claude Code (default)
79
- ./install.sh --target windsurf-project # Windsurf
80
- ./install.sh --target antigravity # Google Antigravity
88
+ ./install.sh # Claude Code (default)
89
+ ./install.sh --target windsurf-project # Windsurf
81
90
 
82
91
  # Windows (PowerShell)
83
92
  .\install.ps1
84
93
  .\install.ps1 -Target windsurf-project
85
- .\install.ps1 -Target codex-home
86
94
  ```
87
95
 
88
96
  ---
89
97
 
90
- The installer automatically starts **Kodelyth Lens** and opens your browser when done (Claude Code target only).
91
-
92
- ---
93
-
94
- ## Kodelyth Lens — AI Usage Dashboard
98
+ ## How Intent Routing Works
95
99
 
96
- <img src="social/readme-lens.svg" alt="Kodelyth Lens Dashboard" width="900"/>
100
+ 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.
97
101
 
98
- **Kodelyth Lens** is a zero-dependency real-time dashboard included with every ECC install. It reads directly from your AI coding platform data files — no cloud, no account, no npm install.
102
+ ### Two activation paths
99
103
 
100
- <img src="social/readme-savings.svg" alt="ECC Cost Savings" width="900"/>
104
+ **1. Explicit** type it directly:
105
+ ```
106
+ use debug-detective
107
+ @code-reviewer
108
+ invoke security-reviewer
109
+ ```
101
110
 
102
- ### What Lens tracks
111
+ **2. Implicit** just describe your problem; the AI routes you:
103
112
 
104
- | Signal | How it works |
113
+ | What you write | Auto-routed to |
105
114
  |---|---|
106
- | Agent invocations | Explicit: `use <agent>`, `@agent`, `invoke agent` |
107
- | Agent intent | 12 intent categories — "bug" debug-detective, "slow" → performance-optimizer |
108
- | Token usage | Reads session JSONL files per platform |
109
- | Cache savings | Cache read tokens cost 10% — ECC prompt structure maximizes hits |
110
- | Platform breakdown | Per-platform session count, tokens, and cost |
111
- | Cost comparison | Actual paid vs. estimated without-ECC cost |
112
-
113
- ### Supported platforms
115
+ | "I'm stuck, no idea where to start" | `kodelyth-advisor` |
116
+ | "I've been debugging this for hours" | `debug-detective` |
117
+ | "Should I use Context or Zustand?" | `pair-programmer` |
118
+ | "Build failed on Vercel" | `build-error-resolver` |
119
+ | "Is this JWT signing secure?" | `security-reviewer` |
120
+ | "Why is this so slow?" | `performance-optimizer` |
121
+ | "Plan the v2 migration" | `planner` + `migration-guide` |
122
+ | "Tests pass locally but fail on CI" | `flake-hunter` + `env-debugger` |
123
+ | "I lost my commits after `reset --hard`" | `git-rescue` |
124
+ | "npm install is failing" | `dependency-doctor` |
125
+ | "Cut a 1.4 release" | `release-captain` |
126
+ | "Add accessibility to this form" | `ux-reviewer` |
127
+ | "Open-source this project" | `opensource-forker` (chain) |
128
+
129
+ 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.
130
+
131
+ ### Multi-agent chains
132
+
133
+ Real problems span multiple specialties. ECC ships standard handoff chains:
114
134
 
115
- | Platform | Data source | Sessions |
116
- |---|---|---|
117
- | Claude Code | `~/.claude/projects/**/*.jsonl` | Full local logs |
118
- | Codex CLI | `~/.codex/state_5.sqlite` | SQLite threads table |
119
- | Windsurf | `~/Library/Application Support/Windsurf/` | Cloud AI (server-side) |
120
- | Antigravity | `~/Library/Application Support/Antigravity/` | Cloud AI (server-side) |
121
- | Cursor | `~/.cursor/` | Local workspace data |
122
- | OpenCode | `~/.opencode/` | Local session files |
123
-
124
- Only installed platforms appear in the dashboard — nothing shown for platforms you don't have.
125
-
126
- ### Manual start
127
-
128
- ```bash
129
- node ~/.kodelyth/lens/server.js
130
- # → http://localhost:3456
135
+ ```
136
+ pair-programmer → tdd-guide → code-reviewer → security-reviewer
137
+ (approach) (write tests) (review impl) (auth, validation)
131
138
  ```
132
139
 
133
- ### Environment overrides
140
+ ```
141
+ debug-detective → tdd-guide → refactor-cleaner
142
+ (root cause) (regression test) (cleanup)
143
+ ```
134
144
 
135
- ```bash
136
- CLAUDE_DIR=~/.claude # Custom Claude Code data dir
137
- CURSOR_DIR=... # Custom Cursor data dir
138
- WINDSURF_DIR=... # Custom Windsurf data dir
139
- CODEX_DIR=~/.codex # Custom Codex data dir
140
- OPENCODE_DIR=~/.opencode # Custom OpenCode data dir
141
- ANTIGRAVITY_DIR=... # Custom Antigravity data dir
142
- PORT=3456 # Dashboard port (default: 3456)
143
145
  ```
146
+ opensource-forker → opensource-sanitizer → opensource-packager → release-captain
147
+ (clean fork) (strip secrets) (README, license) (cut v0.1.0)
148
+ ```
149
+
150
+ See `skills/agent-handoff/SKILL.md` for the full handoff protocol and standard chains.
144
151
 
145
152
  ---
146
153
 
@@ -148,116 +155,55 @@ PORT=3456 # Dashboard port (default: 3456)
148
155
 
149
156
  | Component | Count | Description |
150
157
  |---|---|---|
151
- | Agents | **53** | Specialist subagents — reviewers, planners, debuggers, architects |
152
- | Skills | **185** | Domain knowledge — patterns, testing, security, DevOps |
158
+ | Agents | **58** | Specialist subagents — reviewers, planners, debuggers, architects, doctors |
159
+ | Skills | **187** | Domain knowledge — patterns, testing, security, DevOps, intent routing |
153
160
  | Commands | **79** | Slash command workflows (`/tdd`, `/plan`, `/code-review`, etc.) |
154
- | Hooks | **15+** | Automated lifecycle triggers — quality gates, session memory, cost tracking |
155
- | Rules | **15** | Language-specific coding standards |
161
+ | Hooks | **15+** | Quality gates, session memory, secret scanning, branch checks |
162
+ | Rules | **15** | Always-on coding standards + the intent routing rule |
156
163
 
157
164
  ---
158
165
 
159
166
  ## Agent Arsenal
160
167
 
161
- <img src="social/readme-agents.svg" alt="53 Specialist Agents" width="900"/>
162
-
163
- ### Kodelyth Exclusives
164
-
165
- ### `kodelyth-advisor` — The Master Guide
166
- A decade-seasoned principal engineer who reads your emotional state, understands what you're struggling with, and gives you the exact tool or approach needed. No hand-holding, no noise — direct senior-grade direction.
167
-
168
- ```
169
- use kodelyth-advisor
170
- ```
171
-
172
- ### `debug-detective` — The Root Cause Hunter
173
- Never guesses. Traces every bug to its exact origin through a structured hypothesis protocol. Covers JS/TS, Python, Go, Rust, SQL — with advanced techniques like binary search debug, git bisect, and minimal reproducers.
174
-
175
- ```
176
- use debug-detective
177
- ```
178
-
179
- ### `ux-reviewer` — The Interface Guardian
180
- Reviews frontend code for usability, interaction logic, and WCAG 2.1 AA accessibility. Never touches design aesthetic — only behavior. Catches what real users will feel before they feel it.
181
-
182
- ```
183
- use ux-reviewer
184
- ```
185
-
186
- ### `api-guardian` — The API Contract Protector
187
- Detects breaking API changes before they ship. Classifies every change as BREAKING / SAFE / WARN, generates a consumer impact report, and enforces versioning, deprecation headers, and idempotency.
188
-
189
- ```
190
- use api-guardian
191
- ```
192
-
193
- ### `pair-programmer` — The Pre-Code Thinking Partner
194
- The engineer who sits next to you before you start coding. Catches the wrong approach, over-engineered solutions, and missed edge cases — before a single line is written.
168
+ ### Kodelyth Exclusives The 11 Agents That Make ECC
195
169
 
196
- ```
197
- use pair-programmer
198
- ```
199
-
200
- ### `migration-guide` — The Framework Migration Specialist
201
- Full migration playbooks for React 18→19, Next.js 12→15, Python 2→3, Node.js 14→22, TypeScript 4→5, Java 8→21. Phase-by-phase: audit blast radius phased plan → execute → validate.
202
-
203
- ```
204
- use migration-guide
205
- ```
206
-
207
- ---
170
+ | Agent | One-line job |
171
+ |---|---|
172
+ | `kodelyth-advisor` | Master guide — picks the right tool when you don't know where to start |
173
+ | `pair-programmer` | The engineer who sits next to you **before** you write the code |
174
+ | `debug-detective` | Never guesses traces every bug to root cause |
175
+ | `silent-failure-hunter` | Finds bugs that don't throw errors |
176
+ | `ux-reviewer` | Reviews UX behavior + WCAG 2.1 AA accessibility (never touches design) |
177
+ | `api-guardian` | Detects breaking API changes before they ship |
178
+ | `migration-guide` | Framework / language version upgrades, phase by phase |
179
+ | `dependency-doctor` | npm/pip/cargo/maven hell — CVE triage, lockfile diagnosis |
180
+ | `git-rescue` | Recovers from broken git states without destroying history |
181
+ | `release-captain` | Owns the release ritual — semver, tagging, publishing, rollback |
182
+ | `env-debugger` | "Works on my machine" hunter — env, config, secrets, layers |
183
+ | `flake-hunter` | Stabilizes flaky tests — never adds blind retries |
208
184
 
209
185
  ### Agent Categories
210
186
 
211
187
  | Category | Agents |
212
188
  |---|---|
213
- | Guidance | `kodelyth-advisor`, `pair-programmer`, `planner`, `architect`, `code-architect`, `chief-of-staff`, `migration-guide` |
214
- | Code Review | `code-reviewer`, `typescript-reviewer`, `python-reviewer`, `go-reviewer`, `rust-reviewer`, `java-reviewer`, `kotlin-reviewer`, `cpp-reviewer`, `csharp-reviewer`, `flutter-reviewer` |
215
- | Build Fixing | `build-error-resolver`, `go-build-resolver`, `rust-build-resolver`, `java-build-resolver`, `kotlin-build-resolver`, `cpp-build-resolver`, `dart-build-resolver`, `pytorch-build-resolver` |
216
- | Debugging | `debug-detective`, `silent-failure-hunter` |
217
- | UX & Design | `ux-reviewer` |
218
- | Security | `security-reviewer`, `healthcare-reviewer`, `api-guardian` |
219
- | Quality | `refactor-cleaner`, `code-simplifier`, `performance-optimizer`, `type-design-analyzer` |
220
- | Testing | `tdd-guide`, `e2e-runner`, `pr-test-analyzer` |
221
- | Documentation | `doc-updater`, `docs-lookup`, `comment-analyzer` |
222
- | Open Source | `opensource-forker`, `opensource-packager`, `opensource-sanitizer` |
223
-
224
- ---
225
-
226
- ## How Agent Detection Works
227
-
228
- Agents activate in two ways — you do not always need to type `use agent-name`.
229
-
230
- **1. Explicit** — type it directly in your conversation:
231
- ```
232
- use debug-detective
233
- @code-reviewer
234
- invoke security-reviewer
235
- ```
236
-
237
- **2. Automatic intent detection** — Kodelyth Lens reads your prompts and infers which agent matches:
238
-
239
- | What you write | Agent triggered |
240
- |---|---|
241
- | "this bug won't fix", "I'm getting an error", "it's broken" | `debug-detective` |
242
- | "review this", "check my code", "LGTM?" | `code-reviewer` |
243
- | "it's slow", "taking too long", "optimize" | `performance-optimizer` |
244
- | "is this secure", "SQL injection", "auth" | `security-reviewer` |
245
- | "the build failed", "compile error", "type error" | `build-error-resolver` |
246
- | "write a test", "TDD", "coverage" | `tdd-guide` |
247
- | "the UI feels off", "accessibility", "WCAG" | `ux-reviewer` |
248
- | "plan this feature", "architecture", "design" | `planner` / `architect` |
249
- | "I'm not sure where to start", "what should I do" | `kodelyth-advisor` |
250
- | "refactor", "clean up", "dead code" | `refactor-cleaner` |
251
- | "document this", "add comments" | `doc-updater` |
252
- | "migrate", "upgrade framework", "breaking change" | `migration-guide` |
253
-
254
- Intent detection runs across all platforms — Claude Code, Windsurf, Cursor, Codex — anywhere Kodelyth Lens can read conversation logs. The dashboard shows both explicit and auto-detected agent activations in the leaderboard.
189
+ | **Guidance** | `kodelyth-advisor`, `pair-programmer`, `planner`, `architect`, `code-architect`, `chief-of-staff`, `migration-guide` |
190
+ | **Code Review** | `code-reviewer`, `typescript-reviewer`, `python-reviewer`, `go-reviewer`, `rust-reviewer`, `java-reviewer`, `kotlin-reviewer`, `cpp-reviewer`, `csharp-reviewer`, `flutter-reviewer`, `database-reviewer`, `healthcare-reviewer` |
191
+ | **Build Fixers** | `build-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` |
192
+ | **Debugging** | `debug-detective`, `silent-failure-hunter`, `flake-hunter` |
193
+ | **Security & API** | `security-reviewer`, `api-guardian` |
194
+ | **Performance** | `performance-optimizer` |
195
+ | **Quality** | `refactor-cleaner`, `code-simplifier`, `type-design-analyzer` |
196
+ | **Testing** | `tdd-guide`, `e2e-runner`, `pr-test-analyzer`, `flake-hunter` |
197
+ | **Documentation** | `doc-updater`, `docs-lookup`, `comment-analyzer` |
198
+ | **Release & Ops** | `release-captain`, `git-rescue` |
199
+ | **Open Source** | `opensource-forker`, `opensource-packager`, `opensource-sanitizer` |
200
+ | **Specialized** | `seo-specialist`, `ux-reviewer`, `code-explorer` |
255
201
 
256
202
  ---
257
203
 
258
204
  ## Hooks — Always Running in Background
259
205
 
260
- Once installed, these hooks run automatically with zero configuration:
206
+ Once installed (Claude Code target), these hooks run automatically with zero configuration:
261
207
 
262
208
  | Hook | What it does |
263
209
  |---|---|
@@ -266,8 +212,7 @@ Once installed, these hooks run automatically with zero configuration:
266
212
  | Quality gate | Runs type checks and formatting after edits |
267
213
  | Git push reminder | Prompts review before pushing |
268
214
  | Config protection | Blocks weakening of linter/formatter configs |
269
- | Cost tracker | Logs token usage per session |
270
- | Desktop notify | macOS notification when Claude finishes a long task |
215
+ | Desktop notify | macOS notification when a long task finishes |
271
216
  | MCP health check | Validates MCP servers before calling them |
272
217
  | Test reminder | Prompts to write tests when code is edited without tests |
273
218
  | Smart suggest | After each response, suggests the next logical agent |
@@ -278,11 +223,13 @@ Once installed, these hooks run automatically with zero configuration:
278
223
  ## Usage After Install
279
224
 
280
225
  ### Start here (new users)
226
+
281
227
  ```
282
228
  /kodelyth-quickstart
283
229
  ```
284
230
 
285
- ### Core workflows
231
+ ### Core workflows — explicit invocation
232
+
286
233
  ```bash
287
234
  use kodelyth-advisor # Not sure what to do? Start here
288
235
  use pair-programmer # Think through approach before writing code
@@ -295,9 +242,19 @@ use ux-reviewer # Review frontend UX and accessibility
295
242
  use migration-guide # Upgrading a framework or language version
296
243
  use tdd-guide # Write tests the right way
297
244
  use performance-optimizer # Diagnose and fix slowness
245
+ use dependency-doctor # npm/pip/cargo dep hell
246
+ use git-rescue # Broken git state, lost commits, bad rebase
247
+ use release-captain # Cut a clean release with rollback plan
248
+ use env-debugger # "Works on my machine" — env/config/secrets
249
+ use flake-hunter # Stabilize flaky tests
298
250
  ```
299
251
 
300
- ### Load language patterns
252
+ ### Or just describe your problem
253
+
254
+ 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.
255
+
256
+ ### Load language patterns (skills)
257
+
301
258
  ```bash
302
259
  /typescript-patterns # TypeScript + React + Next.js
303
260
  /python-patterns # Python best practices
@@ -308,54 +265,55 @@ use performance-optimizer # Diagnose and fix slowness
308
265
  ```
309
266
 
310
267
  ### Advanced skills
268
+
311
269
  ```bash
312
270
  /git-mastery # Trunk-based dev, rebase, bisect, monorepos
313
271
  /observability # Structured logging, metrics, OpenTelemetry, SLOs
314
272
  /smart-debug # Systematic debugging framework
273
+ /intent-routing # How the auto-routing system works
274
+ /agent-handoff # Standard multi-agent handoff chains
315
275
  ```
316
276
 
317
277
  ---
318
278
 
319
279
  ## What Gets Installed
320
280
 
321
- ### Claude Code (`~/.claude/`)
281
+ ### Claude Code `~/.claude/`
322
282
 
323
283
  | Source | Destination | What it does |
324
284
  |---|---|---|
325
- | `agents/` | `~/.claude/agents/` | All 53 subagents available globally |
326
- | `skills/` | `~/.claude/skills/` | All 185 skills loadable via commands |
327
- | `hooks/hooks.json` | `~/.claude/hooks/` | Automated quality gates and session memory |
328
- | `rules/` | `~/.claude/rules/` | Always-on coding standards |
285
+ | `agents/` | `~/.claude/agents/` | All 58 subagents available globally |
286
+ | `skills/` | `~/.claude/skills/` | All 187 skills loadable via commands |
287
+ | `hooks/hooks.json` | `~/.claude/hooks/` | Automated quality gates |
288
+ | `rules/` | `~/.claude/rules/` | Always-on standards + intent routing |
329
289
  | `commands/` | `~/.claude/commands/` | Slash commands (`/tdd`, `/plan`, etc.) |
330
- | `dashboard/` | `~/.kodelyth/lens/` | Kodelyth Lens usage dashboard |
331
290
 
332
- ### Windsurf (project: `.windsurf/` · global: `~/.codeium/windsurf/`)
291
+ ### Windsurf `.windsurf/` (project) or `~/.codeium/windsurf/` (global)
333
292
 
334
293
  | Source | Destination | Notes |
335
294
  |---|---|---|
336
295
  | `agents/` | `.windsurf/agents/` | Call with `use <agent-name>` in Cascade |
337
296
  | `skills/` | `.windsurf/skills/` | Domain knowledge, loadable via chat |
338
297
  | `rules/` | `.windsurf/rules/` | Flattened rule files |
339
- | `rules/common/` | `.windsurfrules` | Concatenated — Windsurf reads this automatically |
340
-
341
- The `.windsurfrules` file is auto-generated from all common rules and loaded by Windsurf Cascade on every session. No manual setup needed.
298
+ | `rules/common/` | `.windsurfrules` | Concatenated — Windsurf reads this automatically every session |
342
299
 
343
- ### Codex CLI (`~/.codex/`)
300
+ ### Cursor `.cursor/` in project root
344
301
 
345
- | Source | Destination | What it does |
346
- |---|---|---|
347
- | `agents/` | `~/.codex/agents/` | All 53 agents available globally |
348
- | `skills/` | `~/.codex/skills/` | All 185 skills loadable in chat |
349
- | `commands/` | `~/.codex/commands/` | Slash commands |
350
- | `rules/` | `~/.codex/rules/` | Coding standards (flattened) |
302
+ | Source | Destination |
303
+ |---|---|
304
+ | `rules/` | `.cursor/rules/` |
305
+ | `skills/` | `.cursor/skills/` |
351
306
 
352
- ### OpenCode (`.opencode/` in project root)
307
+ ### Codex CLI `~/.codex/`
353
308
 
354
- | Source | Destination | What it does |
355
- |---|---|---|
356
- | `rules/` | `.opencode/rules/` | Coding standards (flattened) |
309
+ | Source | Destination |
310
+ |---|---|
311
+ | `agents/` | `~/.codex/agents/` |
312
+ | `skills/` | `~/.codex/skills/` |
313
+ | `commands/` | `~/.codex/commands/` |
314
+ | `rules/` | `~/.codex/rules/` |
357
315
 
358
- ### Antigravity (`.agent/` in project root)
316
+ ### Antigravity `.agent/` in project root
359
317
 
360
318
  | Source | Destination |
361
319
  |---|---|
@@ -363,6 +321,12 @@ The `.windsurfrules` file is auto-generated from all common rules and loaded by
363
321
  | `commands/` | `.agent/workflows/` |
364
322
  | `rules/` | `.agent/rules/` |
365
323
 
324
+ ### OpenCode — `.opencode/` in project root
325
+
326
+ | Source | Destination |
327
+ |---|---|
328
+ | `rules/` | `.opencode/rules/` |
329
+
366
330
  ---
367
331
 
368
332
  ## Install Profiles — Language Bundles
@@ -370,15 +334,9 @@ The `.windsurfrules` file is auto-generated from all common rules and loaded by
370
334
  Works with any target:
371
335
 
372
336
  ```bash
373
- # Claude Code
374
- ./install.sh --profile nextjs
375
- npx github:sifxprime/kodelyth-ecc --profile nextjs
376
-
377
- # Windsurf
378
- npx github:sifxprime/kodelyth-ecc --target windsurf-project --profile nextjs
379
-
380
- # Antigravity
381
- npx github:sifxprime/kodelyth-ecc --target antigravity --profile python-api
337
+ npx kodelyth-ecc --profile nextjs # Claude Code
338
+ npx kodelyth-ecc --target windsurf-project --profile nextjs # Windsurf
339
+ npx kodelyth-ecc --target antigravity --profile python-api # Antigravity
382
340
  ```
383
341
 
384
342
  Available profiles:
@@ -391,9 +349,10 @@ Available profiles:
391
349
  | `mobile` | Kotlin + Swift rules |
392
350
  | `backend` | Go + Python + Java rules |
393
351
 
394
- Individual languages:
352
+ Or specify languages directly:
353
+
395
354
  ```bash
396
- npx github:sifxprime/kodelyth-ecc typescript python golang rust java kotlin php swift cpp dart
355
+ npx kodelyth-ecc typescript python golang rust java kotlin php swift cpp dart
397
356
  ```
398
357
 
399
358
  ---
@@ -404,21 +363,47 @@ npx github:sifxprime/kodelyth-ecc typescript python golang rust java kotlin php
404
363
  |---|---|---|---|
405
364
  | Claude Code | Full | `claude-home` (default) | Agents, skills, commands, hooks, rules |
406
365
  | Windsurf | Full | `windsurf-project` / `windsurf-home` | Agents, skills, rules, `.windsurfrules` |
407
- | Google Antigravity | Full | `antigravity` | Agents → skills, commands → workflows, rules |
408
366
  | Cursor | Full | `cursor-project` | Rules, skills |
409
367
  | Codex CLI | Full | `codex-home` | Agents, skills, commands, rules |
368
+ | Google Antigravity | Full | `antigravity` | Agents → skills, commands → workflows, rules |
410
369
  | OpenCode | Full | `opencode` | Rules |
411
370
 
371
+ **OS support:** macOS, Linux (`install.sh`), Windows (`install.ps1`), or any OS with Node.js 18+ (`npx`).
372
+
373
+ ---
374
+
375
+ ## Privacy & Philosophy
376
+
377
+ ECC is **100% local files**. No telemetry, no cloud, no account, no tracking. Everything is markdown your AI reads on every session.
378
+
379
+ - **No dashboard** — we removed it in v1.3.0 because it wasn't giving accurate cross-platform data and added confusion. The toolkit is now leaner.
380
+ - **No phoning home** — install scripts copy files and exit. That's it.
381
+ - **You own everything** — fork the repo, edit any agent, write your own.
382
+
412
383
  ---
413
384
 
414
385
  ## Contributing
415
386
 
416
- We welcome new agents, skills, and hooks that meet the **Kodelyth Standard** — specialist personas, model-agnostic, production-grade examples.
387
+ We welcome new agents, skills, hooks, and intent routing patterns that meet the **Kodelyth Standard** — specialist personas, model-agnostic, production-grade examples.
388
+
389
+ 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.
417
390
 
418
391
  See [CONTRIBUTING.md](CONTRIBUTING.md) for templates, checklists, and the full Kodelyth Standard.
419
392
 
420
393
  ---
421
394
 
395
+ ## Changelog
396
+
397
+ See [CHANGELOG.md](CHANGELOG.md). v1.3.0 highlights:
398
+
399
+ - **Removed:** Lens dashboard (was inaccurate across cloud-AI platforms)
400
+ - **Added:** God-tier `agent-intent-routing` rule — 10 priority tiers, 50+ patterns
401
+ - **Added:** 5 new agents — `dependency-doctor`, `git-rescue`, `release-captain`, `env-debugger`, `flake-hunter`
402
+ - **Added:** 2 new skills — `intent-routing` (routing system docs), `agent-handoff` (chain protocol)
403
+ - **Improved:** Cross-platform install parity — full Windows support for all targets
404
+
405
+ ---
406
+
422
407
  <div align="center">
423
408
 
424
409
  Built and maintained by **Kodelyth** — [@sifxprime](https://github.com/sifxprime)
package/VERSION CHANGED
@@ -1 +1 @@
1
- 1.2.2
1
+ 1.3.0