You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- CONFIG.md: stripped embedded line number prefixes from file content
(was: ' 124|some text' — now: 'some text')
- LICENSE: added MIT license file (was referenced but missing)
- README: fixed Skill System leading pipe character (table rendering bug)
- README: updated test count to 695+ (was stale 220+)
- README: changed MCP emoji from 🔌 (conflict with LLM-Agnostic) to 🔗
- README: added kode mcp to commands cheatsheet
- README: mentioned OPENAI_API_KEY fallback in install example
- Removed stale build artifacts (bin/kode, kode, coverage.out)
Copy file name to clipboardExpand all lines: README.md
+6-5Lines changed: 6 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ One binary. One loop. Zero frameworks. ReAct (Reasoning + Acting) — think, the
8
8
# Install
9
9
go install github.com/BackendStack21/kode/cmd/kode@latest
10
10
11
-
# Use
11
+
# Use (set DEEPSEEK_API_KEY or OPENAI_API_KEY)
12
12
export DEEPSEEK_API_KEY=sk-...
13
13
kode run "How many lines in go.mod?"
14
14
# → 3 lines
@@ -39,7 +39,7 @@ kode is not a framework. It's a **runtime** — the smallest possible surface ar
39
39
Parallel OS-process sub-agents via `delegate_tasks`. True isolation — each sub-agent is a fresh `kode subagent` process with its own config, tools, and termination timeout. Up to 8 concurrent workers. [docs/SUBAGENTS.md](docs/SUBAGENTS.md)
40
40
41
41
### 🧠 Skill System (on by default)
42
-
|Trigger-matched `SKILL.md` files load on-demand. Auto-learns from patterns every session — detects multi-step procedures, error recoveries, repeated actions, and user corrections. **LLM-enhanced**: each detected pattern is enriched with an LLM-generated name, description, trigger keywords, and structured body with overview, steps, pitfalls, and verification sections. Use `--no-learn` to disable. Import skills from any URI with automatic LLM risk assessment. [docs/CLI.md#skills](docs/CLI.md#skills)
42
+
Skill-matched `SKILL.md` files load on-demand. Auto-learns from patterns every session — detects multi-step procedures, error recoveries, repeated actions, and user corrections. **LLM-enhanced**: each detected pattern is enriched with an LLM-generated name, description, trigger keywords, and structured body with overview, steps, pitfalls, and verification sections. Use `--no-learn` to disable. Import skills from any URI with automatic LLM risk assessment. [docs/CLI.md#skills](docs/CLI.md#skills)
43
43
44
44
### 💾 Persistent Memory
45
45
Three tiers: **facts** (agent-managed durable entries), **session buffer** (auto-appended turn summaries), **episodes** (LLM-extracted knowledge from past sessions). Merge-on-write via go-vector RandomProjections — cosine >0.7 auto-merges, <0.3 auto-adds. Saves ~80% LLM calls. [docs/MEMORY.md](docs/MEMORY.md)
`kode serve` — browser-based agent with `@` resource completion (`@file.go`, `@sess:abc123`), WebSocket streaming, and a full IDE-style console. [docs/WEBUI.md](docs/WEBUI.md)
58
58
59
-
### 🔌 MCP (Two-Way)
59
+
### 🔗 MCP (Two-Way)
60
60
**Server** (`kode mcp`) — expose kode's native tools (shell, read/write/search files, patch, browser) to Claude Code, Cursor, and any MCP client. **Client** (`mcp_servers` config) — kode connects to external MCP servers (Playwright, Fetch, GitHub, SQLite, etc.) and makes their tools available to the agent as `<server>__<tool>`. Both directions in one binary. [docs/MCP.md](docs/MCP.md)
61
61
62
62
### 🔍 Native Tools
@@ -112,6 +112,7 @@ kode repl
112
112
|`kode serve [--addr :8080]`| Start Web UI server |
113
113
|`kode subagent --goal <string>`| Run a focused sub-task |
114
114
|`kode init [--global]`| Create config file |
115
+
|`kode mcp [--sandbox]`| Start MCP server — expose tools to Claude Code |
115
116
|`kode version`| Print version |
116
117
117
118
### Key Flags
@@ -172,9 +173,9 @@ The full `Config` struct supports: `BaseURL`, `Thinking`, `SandboxCleanup`, `Ren
172
173
## Test
173
174
174
175
```bash
175
-
go test ./... #220+ tests, all pass
176
+
go test ./... #695+ tests, all pass
176
177
go test -race ./... # race detector clean
177
-
go test -cover ./... # 80%+ coverage
178
+
go test -cover ./... # 80%+ average coverage
178
179
```
179
180
180
181
Everything runs with `go test` — no Docker, no network, no external services required for unit tests.
0 commit comments