Skip to content

Releases: aomerk/keeba

v0.2.0-alpha — gaps closed

28 Apr 09:20
70b8a85

Choose a tag to compare

Pre-release

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-alpha

What's new since v0.1.0-alpha

LLM-driven bench

ANTHROPIC_API_KEY=… keeba bench --llm anthropic --raw ../your-corpus

Each 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

28 Apr 08:57
4563700

Choose a tag to compare

Pre-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-alpha

What'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 --diff for tracking ratio drift.
  • Homebrew tap.

🤖 Released with Claude Code