Skip to content

Commit a193022

Browse files
committed
v0.24.5: fix accuracy — 'zero-dependency' → 'minimal dependencies' across docs, prompts, and skills
odek has 4 direct external deps (go-mcp, go-vector, golang.org/x/net, golang.org/x/term), so 'zero-dependency' was inaccurate. Updated: - odek.go package doc - cmd/odek/main.go system prompt - AGENTS.md agent maintenance guide - docs/DEVELOPMENT.md contributing policy - docs/CHEATSHEET.md, docs/MEMORY.md, docs/index.html - ~/.odek/skills/odek-quick-guide/SKILL.md (skill file) Also fixed landing page comparison table to show actual dep count.
1 parent a127bda commit a193022

7 files changed

Lines changed: 12 additions & 12 deletions

File tree

AGENTS.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ It provides context about the project's architecture, conventions, and how to up
88
## Project Identity
99

1010
- **Package:** `odek` (Go module: `github.com/BackendStack21/kode`)
11-
- **What it is:** Minimal Go autonomous agent runtime — ReAct (Reasoning + Acting) loop with zero external dependencies (stdlib only).
11+
- **What it is:** Minimal Go autonomous agent runtime — ReAct (Reasoning + Acting) loop with minimal external dependencies (stdlib + a few focused packages).
1212
- **Binary:** `odek` — single static binary, ~11 MB, instant startup.
1313
- **Config:** Layered priority: `~/.odek/config.json``./odek.json``ODEK_*` env vars → CLI flags.
1414

@@ -54,7 +54,7 @@ docs/ Documentation (CLI, API, CONFIG, MCP, MEMORY, etc.
5454

5555
## Key Conventions
5656

57-
- **Zero-dependency policy:** No external Go modules beyond stdlib. All contributions must maintain this.
57+
- **Minimal dependencies policy:** Prefer stdlib, keep dependencies minimal and focused. All contributions must maintain this.
5858
- **Tests:** 1760+ tests, run with `go test ./...` (no network, no Docker needed for unit tests).
5959
- **Error handling:** Return errors, don't panic. Fatal errors go through `fmt.Fprintf(os.Stderr, ...)`.
6060
- **Config structs:** JSON tags for serialization. `*bool` for optional tristate fields (nil = not set).

cmd/odek/main.go

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -52,15 +52,15 @@ const defaultSystem = `⚠️ ANTI-PATTERN — NEVER do this: call search_files,
5252
You are odek — an expert software engineer who ships. You have deep knowledge of systems, architecture, and the craft of writing software. You work fast, think clearly, and build things that last.
5353
5454
About odek:
55-
- odek is a minimal, zero-dependency Go autonomous agent runtime — a single
55+
- odek is a minimal Go autonomous agent runtime — a single
5656
binary (~11 MB, instant startup) that implements the ReAct loop with tools,
5757
skills, memory, sub-agents, and sandboxing.
5858
- Built by 21no.de (https://21no.de), an AI/systems research lab.
5959
- Website: https://kode.21no.de
6060
- GitHub: injected from config (see Repository URL below).
6161
- Stack: Go 1.24+, minimal dependencies, Docker sandbox support,
6262
layered config (global → project → env → CLI), Telegram bot integration.
63-
- Philosophy: convention over configuration, zero-dep where possible,
63+
- Philosophy: convention over configuration, minimal deps where possible,
6464
agent-first design. The agent IS the application.
6565
6666
The repository directory and URL below are injected from configuration:

docs/CHEATSHEET.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -205,7 +205,7 @@ odek mcp --sse-addr :8081 # SSE transport
205205

206206
## Key Design Properties
207207

208-
- **Minimal Go dependencies** — all zero-dep Go packages from 21no.de
208+
- **Minimal Go dependencies** — all minimal-dependency Go packages from 21no.de
209209
- **~11 MB static binary**
210210
- **One loop, one interface** — tool implementers write `func Call(args string) (string, error)`
211211
- **File-based config** — no YAML, no DSL, no schema generation

docs/DEVELOPMENT.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -177,4 +177,4 @@ See [docs/SUBAGENTS.md](docs/SUBAGENTS.md) for full documentation.
177177
3. Run `go test ./...`
178178
4. Open a PR
179179

180-
**Zero-dependency policy:** Contributions must not introduce external Go modules. stdlib only.
180+
**Minimal dependencies policy:** Contributions should prefer stdlib and avoid unnecessary external Go modules.

docs/MEMORY.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Memory System
22

3-
odek has a **three-tier file-based memory** system. Minimal external dependencies from the 21no.de ecosystem (go-vector, go-mcp), all zero-dep Go packages.
3+
odek has a **three-tier file-based memory** system. Minimal external dependencies from the 21no.de ecosystem (go-vector, go-mcp), all minimal-dependency Go packages.
44

55
## Three Tiers
66

docs/index.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
<meta name="twitter:card" content="summary_large_image">
1515
<meta name="twitter:title" content="odek — Go Autonomous Agent Runtime">
1616
<meta name="twitter:description" content="The fastest, minimal Go autonomous agent runtime. ~8 MB static binary, zero frameworks.">
17-
<meta name="keywords" content="Go, autonomous agent, AI agent, LLM, ReAct, MCP, Docker sandbox, CLI, zero-dependency, open-source">
17+
<meta name="keywords" content="Go, autonomous agent, AI agent, LLM, ReAct, MCP, Docker sandbox, CLI, minimal-dependencies, open-source">
1818
<meta name="robots" content="index, follow">
1919
<link rel="stylesheet" href="https://assets.21no.de/fonts/fonts.css">
2020
<link rel="stylesheet" href="https://assets.21no.de/css/tokens.css">
@@ -528,7 +528,7 @@ <h2>odek vs <span class="hl">the rest</span></h2>
528528
<tr><th></th><th>odek</th><th>Python agents</th></tr>
529529
</thead>
530530
<tbody>
531-
<tr><td>Direct dependencies</td><td class="win">Minimal — Go stdlib</td><td>200+ packages</td></tr>
531+
<tr><td>Direct dependencies</td><td class="win">Minimal — stdlib + 4 focused pkgs</td><td>200+ packages</td></tr>
532532
<tr><td>Binary size</td><td class="win">~8 MB static</td><td>50–200 MB (venv)</td></tr>
533533
<tr><td>Startup</td><td class="win">Instant</td><td>2–10 seconds</td></tr>
534534
<tr><td>Sandbox</td><td class="win"><code>--sandbox</code> flag</td><td>Manual Docker setup</td></tr>

odek.go

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
1-
// Package odek is a minimal, zero-dependency Go agent loop runtime.
1+
// Package odek is a minimal Go agent loop runtime.
22
//
33
// odek implements the ReAct (Reasoning + Acting) pattern — the "think,
44
// therefore act" loop that powers autonomous AI agents. It is not a
5-
// framework or an SDK. It is a runtime: one loop, one binary, zero deps.
5+
// framework or an SDK. It is a runtime: one loop, one binary, minimal deps.
66
//
77
// # Design
88
//
9-
// - Zero external dependencies. stdlib only.
9+
// - Minimal external dependencies. stdlib + a few focused packages.
1010
// - Session isolation via Docker containers (--sandbox).
1111
// - LLM-agnostic. Any OpenAI-compatible endpoint works.
1212
// - Tool-first. Tools are the only extension point.

0 commit comments

Comments
 (0)