knogg
Agent context broker — a small Rust CLI that keeps a local context store for AI coding agents and brokers that context between tools (Cursor, Claude Code, Codex). Multiple agents and humans share one source of truth for what is being worked on, what was decided, and what to do next — without corrupting files or stepping on each other.
Features
Quick Start
# Install (Linux/macOS)
curl -fsSL https://raw.githubusercontent.com/CoffeJeanCode/knogg/main/scripts/install.sh | bash
# Install (Windows PowerShell)
irm https://raw.githubusercontent.com/CoffeJeanCode/knogg/main/scripts/install.ps1 | iex
# Initialize and use
knogg init
knogg state set --stage auth --task "Add login" --status in_progress
knogg sync
knogg handoff --to cursor --print
Documentation
Installation
Linux / macOS
curl -fsSL https://raw.githubusercontent.com/CoffeJeanCode/knogg/main/scripts/install.sh | bash
Custom install directory:
KNOGG_INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/CoffeJeanCode/knogg/main/scripts/install.sh | bash
Windows (PowerShell)
irm https://raw.githubusercontent.com/CoffeJeanCode/knogg/main/scripts/install.ps1 | iex
Custom directory or pinned version:
$env:KNOGG_INSTALL_DIR = "C:\Tools\knogg"; irm https://raw.githubusercontent.com/CoffeJeanCode/knogg/main/scripts/install.ps1 | iex
$env:KNOGG_VERSION = "v1.1.0"; irm https://raw.githubusercontent.com/CoffeJeanCode/knogg/main/scripts/install.ps1 | iex
Download Binary
Pre-built binaries at https://github.com/CoffeJeanCode/knogg/releases:
# Linux / macOS
curl -LO https://github.com/CoffeJeanCode/knogg/releases/latest/download/knogg-linux-amd64
chmod +x knogg-linux-amd64
sudo mv knogg-linux-amd64 /usr/local/bin/knogg
Build from Source
Requires Docker (Compose v2) — no local Rust toolchain needed.
make release # → ./dist/knogg + ./dist/knogg.exe
make test
make dev # interactive dev shell
Typical Workflow
# Human: set focus
knogg state set --stage auth --task "Add login" --status in_progress
knogg state add-next "Wire up session cookie"
knogg sync
knogg handoff --to cursor --print
# Human: record a decision
knogg decision add --title "Use JWT sessions" \
--reason "Stateless, scales horizontally" --status accepted
# AI agent: read context → propose change (via MCP)
# get_active_context → propose_state_update → PROP-NNNN staged
# Human: review + apply
knogg proposal show PROP-0001
knogg proposal apply PROP-0001
knogg status
License
Apache License 2.0 — see LICENSE.