Releases: aomerk/keeba
v0.2.0-alpha — gaps closed
Closes the three honest deferrals from v0.1.0-alpha. Every line item in the locked v0.1 plan §17 is now either shipped or has an explicit v0.3 home.
Install
go install github.com/aomerk/keeba/cmd/keeba@v0.2.0-alpha
keeba --version # → keeba v0.2.0-alphaWhat's new since v0.1.0-alpha
LLM-driven bench
ANTHROPIC_API_KEY=… keeba bench --llm anthropic --raw ../your-corpusEach question is answered twice — wiki context (BM25 top-k) vs raw context (truncated dump) — by Claude. Token counts come from the API response (not estimates); confidence is self-rated 1-5. Output markdown includes side-by-side answers per question.
Inert without a key. Byte-count bench remains the no-key default.
Vector search
VOYAGE_API_KEY=… keeba index
keeba search --vector "JWT auth flow"Embedder providers: Voyage AI, OpenAI. local is deferred to v0.3 (cybertron + ONNX MiniLM under the same interface).
Real llm.c worked example
Captured recipe + actual bench output checked into examples/llm-c/:
keeba: 2465.9× cheaper, 80.1× faster (5 questions; byte-count mode)
Replaces the placeholder demo-wiki number in the README.
Tests
~115 cases across 9 packages. golangci-lint v2.4.0 clean. Dogfood exercises every command (including the missing-key error paths) end-to-end.
What's v0.3
- Local sentence-transformers provider (cybertron + ONNX MiniLM).
- Direct execution of ingest agents (vs writing prompt templates).
- Cursor + Codex tool-config scaffolding alongside
.mcp.json. - Homebrew tap.
- 30-second screencast.
🤖 Released with Claude Code
v0.1.0-alpha — first public release
First public release. Pre-alpha — surface is wired end-to-end, decisions on shape may still flip.
Install
go install github.com/aomerk/keeba/cmd/keeba@v0.1.0-alpha
keeba --version # → keeba v0.1.0-alphaWhat's in the box
| Command | What it does |
|---|---|
keeba init [name] |
Scaffolds a fresh wiki repo with SCHEMA, index, log, agents, .mcp.json, lint/meta workflows. |
keeba lint |
Schema rules: title, summary, sources, see-also, wikilinks, filename casing, frontmatter. |
keeba drift |
Citation drift over configurable repo prefixes. |
keeba meta |
Builds _meta.json + _xref/<repo>.json for token-cheap agent reads. |
keeba search QUERY |
Pure-Go BM25 keyword search. No embeddings, no API keys. |
keeba bench |
Wiki-vs-raw token benchmark with default code-project questions. |
keeba ingest git|slack |
Drops a tested agent prompt template into agents/ for your AI tool. |
keeba mcp serve |
Stdio MCP server (protocol 2024-11-05) — query_documentation tool. |
Bench number from the dogfood
keeba: 126.8× cheaper, 27.5× faster (5 questions)
Next up (v0.2)
- Vector search (sqlite-vec + sentence-transformers default; Voyage / OpenAI as opt-in).
- Direct execution of ingest agents.
- Cursor + Codex MCP scaffolding.
keeba bench --difffor tracking ratio drift.- Homebrew tap.
🤖 Released with Claude Code