From 7065e5e6df16239a1487a4d367158c94ca82aa10 Mon Sep 17 00:00:00 2001
From: Rolando Santamaria Maso <4096860+jkyberneees@users.noreply.github.com>
Date: Mon, 14 Sep 2026 10:59:14 +0200
Subject: [PATCH 1/2] docs: correct binary-size claim to <15 MB across README,
 landing and docs

The published figure (~11 MB) understated the shipped binaries. v2.16.0
release assets measure 12.45-13.55 MB, and a local build with the release
flags (CGO_ENABLED=0, -ldflags "-s -w") reproduces 12.97 MB. The claim had
drifted ~2 MB (~15%) before anyone noticed.

Replace it with a <15 MB ceiling: accurate today, and with headroom so the
claim does not silently go stale again as the binary grows.

Sweeps every place the claim appeared:
  - README.md, GETTING_STARTED.md, AGENTS.md, docs/CHEATSHEET.md, docs/llms.txt
  - docs/index.html: meta/og/twitter tags, both JSON-LD blocks, and the
    hero size marker in the body
  - cmd/odek/telegram.go: the Telegram Quick Facts prompt, which instructed
    the model to quote the same stale figure to users

HTML escaping: &lt; entities in attributes and body text; a literal < inside
the JSON-LD <script> blocks, where character references are not decoded.

Docs and prompt-string only - no behaviour change. Verified: zero stale
claims repo-wide, JSON-LD still valid JSON, entities decode to the intended
visible text, gofmt clean, build and vet pass.
---
 AGENTS.md            |  2 +-
 GETTING_STARTED.md   |  2 +-
 README.md            |  2 +-
 cmd/odek/telegram.go |  2 +-
 docs/CHEATSHEET.md   |  2 +-
 docs/index.html      | 16 ++++++++--------
 docs/llms.txt        |  2 +-
 7 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 5c01a16a..0a3c4ccb 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -9,7 +9,7 @@ It provides context about the project's architecture, conventions, and how to up
 
 - **Package:** `odek` (Go module: `github.com/BackendStack21/odek`)
 - **What it is:** Minimal Go autonomous agent runtime — ReAct (Reasoning + Acting) loop with zero frameworks (stdlib + a few focused packages).
-- **Binary:** `odek` — single static binary, ~11 MB, instant startup.
+- **Binary:** `odek` — single static binary, <15 MB, instant startup.
 - **Config:** Five-layer priority: `~/.odek/secrets.env` → `~/.odek/config.json` → `./odek.json` → `ODEK_*` env vars → CLI flags.
 - **Extension contract:** `odek-extension/v1` (docs/EXTENSIONS.md) — MCP server limits, artifact refs, runtime events, external session refs, execution budgets.
 - **Releases:** tag-driven (`git tag vX.Y.Z && git push --tags` builds binaries + release). See [GitHub Releases](https://github.com/BackendStack21/odek/releases).
diff --git a/GETTING_STARTED.md b/GETTING_STARTED.md
index 483073b4..773f5c9d 100644
--- a/GETTING_STARTED.md
+++ b/GETTING_STARTED.md
@@ -2,7 +2,7 @@
 
 Install **odek** (the agent engine), configure it with a **GLM 5.3 Flash** subscription from **z.ai**, and — optionally — add **bodek**, a polished terminal UI on top.
 
-odek is a single static Go binary (~11 MB, instant startup). No Python, no Node, no framework — one binary and an API key is the whole install.
+odek is a single static Go binary (<15 MB, instant startup). No Python, no Node, no framework — one binary and an API key is the whole install.
 
 ---
 
diff --git a/README.md b/README.md
index 35068b02..fc222fb0 100644
--- a/README.md
+++ b/README.md
@@ -32,7 +32,7 @@ odek is not a framework. It's a **runtime** — the smallest possible surface ar
 | | odek | Python agents (LangChain, CrewAI, etc.) |
 |---|---|---|
 | Dependencies | **6.** 3× 21no.de, 3× golang.org/x | 200+ packages |
-| Binary size | ~11 MB static | 50-200 MB with venv |
+| Binary size | <15 MB static | 50-200 MB with venv |
 | Startup | **Instant** | 2-10s (Python imports) |
 | Sandbox | **Default-on** Docker sandbox (`--no-sandbox` to opt out) | Requires manual Docker setup |
 | Tool interface | One interface, one method | Class hierarchies + decorators |
diff --git a/cmd/odek/telegram.go b/cmd/odek/telegram.go
index 0fdf470c..c57e0255 100644
--- a/cmd/odek/telegram.go
+++ b/cmd/odek/telegram.go
@@ -435,7 +435,7 @@ func telegramCmd(args []string) error {
 	systemMessage += "- odek website: https://odek.21no.de\n"
 	systemMessage += "- Built by: 21no.de (https://21no.de)\n"
 	systemMessage += "- Binary name: odek\n"
-	systemMessage += "- Language: Go, minimal dependencies, ~11 MB binary\n"
+	systemMessage += "- Language: Go, minimal dependencies, <15 MB binary\n"
 	systemMessage += "\n"
 	systemMessage += "File attachment:\n"
 	systemMessage += "- You CAN send files (zip, pdf, images, csv, etc.) in BOTH intermediate replies\n"
diff --git a/docs/CHEATSHEET.md b/docs/CHEATSHEET.md
index 442e58c0..7ca8786a 100644
--- a/docs/CHEATSHEET.md
+++ b/docs/CHEATSHEET.md
@@ -361,7 +361,7 @@ odek mcp --sandbox
 ## Key Design Properties
 
 - **Minimal Go dependencies** — all minimal-dependency Go packages from 21no.de
-- **~11 MB static binary**
+- **<15 MB static binary**
 - **One loop, one interface** — tool implementers write `func Call(args string) (string, error)`
 - **File-based config** — no YAML, no DSL, no schema generation
 - **Sandbox on by default** (CLI) with loud unsandboxed fallback when Docker is missing — no container runtime *required*, isolation unless you opt out
diff --git a/docs/index.html b/docs/index.html
index 105bcedd..0dd7f10e 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -6,7 +6,7 @@
   <meta name="theme-color" content="#030304">
   <meta name="color-scheme" content="dark">
   <title>odek · Move fast. Stay in control.</title>
-  <meta name="description" content="An autonomous agent workspace in one ~11 MB Go binary. Plan, build, inspect results, and keep working across sessions. Your models, your machine, zero frameworks.">
+  <meta name="description" content="An autonomous agent workspace in one &lt;15 MB Go binary. Plan, build, inspect results, and keep working across sessions. Your models, your machine, zero frameworks.">
   <link rel="canonical" href="https://odek.21no.de/">
   <link rel="robots" href="/robots.txt">
   <link rel="sitemap" href="/sitemap.xml">
@@ -14,19 +14,19 @@
   <meta property="og:site_name" content="odek">
   <meta property="og:locale" content="en_US">
   <meta property="og:url" content="https://odek.21no.de/">
-  <meta property="og:title" content="odek — ~11 MB Go agent runtime">
+  <meta property="og:title" content="odek — &lt;15 MB Go agent runtime">
   <meta property="og:description" content="Verified install, a provider key, then odek run. DeepSeek, OpenAI, Anthropic, Gemini, z.ai, Kimi, or any OpenAI-compatible endpoint.">
   <meta property="og:image" content="https://odek.21no.de/og-image.png">
   <meta property="og:image:secure_url" content="https://odek.21no.de/og-image.png">
   <meta property="og:image:type" content="image/png">
   <meta property="og:image:width" content="1200">
   <meta property="og:image:height" content="630">
-  <meta property="og:image:alt" content="odek — ~11 MB static binary, zero-framework Go autonomous agent runtime">
+  <meta property="og:image:alt" content="odek — &lt;15 MB static binary, zero-framework Go autonomous agent runtime">
   <meta name="twitter:card" content="summary_large_image">
-  <meta name="twitter:title" content="odek — ~11 MB Go agent runtime">
+  <meta name="twitter:title" content="odek — &lt;15 MB Go agent runtime">
   <meta name="twitter:description" content="Verified install, a provider key, then odek run. DeepSeek, OpenAI, Anthropic, Gemini, z.ai, Kimi, or any OpenAI-compatible endpoint.">
   <meta name="twitter:image" content="https://odek.21no.de/og-image.png">
-  <meta name="twitter:image:alt" content="odek — ~11 MB static binary, zero-framework Go autonomous agent runtime">
+  <meta name="twitter:image:alt" content="odek — &lt;15 MB static binary, zero-framework Go autonomous agent runtime">
   <meta name="keywords" content="odek, Go, autonomous agent, ReAct, GLM 5.3 Flash, z.ai, MCP, Docker sandbox, bodek">
   <meta name="robots" content="index, follow">
   <meta http-equiv="Content-Security-Policy" content="default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self'; img-src 'self'; font-src 'self'; connect-src 'self'; object-src 'none'; base-uri 'self'; form-action 'none'; frame-ancestors 'none'">
@@ -41,7 +41,7 @@
   "name": "odek",
   "applicationCategory": "DeveloperApplication",
   "operatingSystem": "Linux, macOS",
-  "description": "A ~11 MB static Go binary that runs an autonomous ReAct agent loop. Zero frameworks. Provider-agnostic. Sandbox on by default.",
+  "description": "A <15 MB static Go binary that runs an autonomous ReAct agent loop. Zero frameworks. Provider-agnostic. Sandbox on by default.",
   "url": "https://odek.21no.de",
   "downloadUrl": "https://github.com/BackendStack21/odek/releases",
   "license": "https://github.com/BackendStack21/odek/blob/main/LICENSE",
@@ -61,7 +61,7 @@
       "name": "What is odek?",
       "acceptedAnswer": {
         "@type": "Answer",
-        "text": "odek is a ~11 MB static Go binary that runs an autonomous ReAct agent loop. It is provider-agnostic and ships parallel tool execution, persistent memory, an MCP server and client, a Docker sandbox (on by default), a Web UI, and a Telegram bot — with no frameworks and no Python venv."
+        "text": "odek is a <15 MB static Go binary that runs an autonomous ReAct agent loop. It is provider-agnostic and ships parallel tool execution, persistent memory, an MCP server and client, a Docker sandbox (on by default), a Web UI, and a Telegram bot — with no frameworks and no Python venv."
       }
     },
     {
@@ -123,7 +123,7 @@
     <header class="hero">
       <p class="eyebrow">GO SMALL. BUILD BIG.</p>
       <h1>Move fast.<br><span>Stay in control.</span></h1>
-      <p class="lede">An autonomous agent with a small footprint and a clear set of boundaries. Odek plans, runs tools, and follows through—in one <span class="size">~11 MB</span> Go binary you can inspect from the inside out.</p>
+      <p class="lede">An autonomous agent with a small footprint and a clear set of boundaries. Odek plans, runs tools, and follows through—in one <span class="size">&lt;15 MB</span> Go binary you can inspect from the inside out.</p>
       <div class="hero-actions">
         <a class="button primary" href="#install">Get started <span aria-hidden="true">↗</span></a>
         <a class="button secondary" href="#gallery">Explore the Web UI <span aria-hidden="true">↓</span></a>
diff --git a/docs/llms.txt b/docs/llms.txt
index 61840742..daf67480 100644
--- a/docs/llms.txt
+++ b/docs/llms.txt
@@ -1,6 +1,6 @@
 # odek
 
-> odek is a minimal autonomous agent runtime written in Go — a ReAct (Reasoning + Acting) loop with zero frameworks (stdlib plus a few focused packages), shipped as a single ~11 MB static binary with instant startup. It runs tasks from the CLI, an interactive REPL, a web UI, a Telegram bot, scheduled jobs, or as a Go library, and can execute shell commands, edit files, browse the web, transcribe audio, analyze images, spawn sub-agents, and connect to MCP servers.
+> odek is a minimal autonomous agent runtime written in Go — a ReAct (Reasoning + Acting) loop with zero frameworks (stdlib plus a few focused packages), shipped as a single <15 MB static binary with instant startup. It runs tasks from the CLI, an interactive REPL, a web UI, a Telegram bot, scheduled jobs, or as a Go library, and can execute shell commands, edit files, browse the web, transcribe audio, analyze images, spawn sub-agents, and connect to MCP servers.
 
 Module path: `github.com/BackendStack21/odek`. Repository: https://github.com/BackendStack21/odek
 

From f557340cc0c5958b716f6414fc55672c340254f3 Mon Sep 17 00:00:00 2001
From: Rolando Santamaria Maso <4096860+jkyberneees@users.noreply.github.com>
Date: Mon, 14 Sep 2026 11:04:36 +0200
Subject: [PATCH 2/2] chore: keep the local commercial brief out of version
 control

PITCH.html and PITCH.pdf are a local, client-facing commercial brief, not
product documentation. Add them to the ignore list so they cannot be
committed by accident or by a broad `git add`.

Verified: git check-ignore resolves both paths to this rule, and neither
file is tracked.
---
 .gitignore | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.gitignore b/.gitignore
index 108c5c32..925eb731 100644
--- a/.gitignore
+++ b/.gitignore
@@ -21,6 +21,10 @@ docker/.odek/*
 
 sec_findings.md
 
+# Local commercial brief (not product docs)
+PITCH.html
+PITCH.pdf
+
 # Docs-audit working set — local only
 docs_findings.md
 SUB_AGENTS_IMPROVEMENTS.md