<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<script async src="https://www.googletagmanager.com/gtag/js?id=G-3LG1NMQXB9"></script>
<script src="/assets/ga.js"></script>
<title>KYB — Shared Memory & Incident Tracker for AI Agent Fleets</title>
<meta name="description" content="KYB is a git-backed, searchable knowledge base and incident tracker for fleets of AI agents. Fast hybrid BM25 + CPU vector search, no database, access tokens and roles optional. Open source, Rust, MIT.">
<link rel="canonical" href="https://kybmemory.com/">
<meta name="robots" content="index, follow, max-image-preview:large">
<meta name="theme-color" content="#131720">
<meta name="author" content="Alexander Panasenko">
<meta name="keywords" content="AI agent memory, agent knowledge base, incident tracker, hybrid search, BM25, vector search, git-backed, Rust, Claude Code, Codex, Antigravity, MCP, Model Context Protocol, infrastructure knowledge base">
<meta property="og:type" content="website">
<meta property="og:site_name" content="KYB — Know Your Business">
<meta property="og:title" content="KYB — the shared memory your AI agent fleet keeps forgetting it needs">
<meta property="og:description" content="KYB is a git-backed, searchable knowledge base and incident tracker for fleets of AI agents. Fast hybrid BM25 + CPU vector search, no database, access tokens and roles optional. Open source, Rust, MIT.">
<meta property="og:url" content="https://kybmemory.com/">
<meta property="og:image" content="https://kybmemory.com/og.png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:image:alt" content="KYB — git-backed shared memory and incident tracker for AI agent fleets">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="KYB — shared memory for AI agent fleets">
<meta name="twitter:description" content="KYB is a git-backed, searchable knowledge base and incident tracker for fleets of AI agents. Fast hybrid BM25 + CPU vector search, no database, access tokens and roles optional. Open source, Rust, MIT.">
<meta name="twitter:image" content="https://kybmemory.com/og.png">
<link rel="icon" href="/favicon.svg" type="image/svg+xml">
<link rel="apple-touch-icon" href="/favicon.svg">
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;500;600;700&family=Hanken+Grotesk:wght@400;500;600;700&family=IBM+Plex+Mono:wght@400;500;600&display=swap">
<script type="application/ld+json">
{"@context":"https://schema.org","@graph":[
{"@type":"SoftwareApplication","name":"KYB — Know Your Business","applicationCategory":"DeveloperApplication","operatingSystem":"macOS, Linux, Docker","description":"KYB is a git-backed, searchable knowledge base and incident tracker for fleets of AI agents. Fast hybrid BM25 + CPU vector search, no database, access tokens and roles optional. Open source, Rust, MIT.","url":"https://kybmemory.com/","softwareVersion":"0.3.2","license":"https://opensource.org/licenses/MIT","programmingLanguage":"Rust","author":{"@type":"Person","name":"Alexander Panasenko","url":"https://prod.codes/about/"},"offers":{"@type":"Offer","price":"0","priceCurrency":"USD"},"codeRepository":"https://github.com/alex09x/kyb"},
{"@type":"WebSite","name":"KYB","url":"https://kybmemory.com/","description":"KYB is a git-backed, searchable knowledge base and incident tracker for fleets of AI agents. Fast hybrid BM25 + CPU vector search, no database, access tokens and roles optional. Open source, Rust, MIT.","author":{"@type":"Person","name":"Alexander Panasenko","url":"https://prod.codes/about/"}},
{"@type":"FAQPage","mainEntity":[
{"@type":"Question","name":"What is KYB?","acceptedAnswer":{"@type":"Answer","text":"KYB is a git-backed, searchable knowledge base and incident tracker for fleets of AI agents. It stores which servers exist, how services are wired, what broke and how it ended, and what work is still in flight — so the operational truth survives between agent sessions and across machines."}},
{"@type":"Question","name":"Does KYB need a database?","acceptedAnswer":{"@type":"Answer","text":"No. Git is the canon: one markdown file per entry, one commit per change, and a commit sha is a version id. The Tantivy search index is a disposable cache rebuilt from git on every start."}},
{"@type":"Question","name":"How does KYB search work?","acceptedAnswer":{"@type":"Answer","text":"Hybrid search: BM25 lexical scoring fused by reciprocal rank with vector search over every entry, using a multilingual e5-small int8 ONNX model on CPU. In a 2026-09-22 benchmark against a 643-entry base, round-trip LAN queries completed in ~7–9 ms. Without the model on disk the service degrades to lexical-only."}},
{"@type":"Question","name":"Which AI agents does KYB support?","acceptedAnswer":{"@type":"Answer","text":"The installer wires the KYB skill into every agent it finds on a machine: Claude Code, Codex and Antigravity. It writes a pointer into each agent's always-loaded global instructions, so the skill is discovered without being asked for. In addition, KYB serves native Model Context Protocol (MCP) over HTTP at POST /mcp."}},
{"@type":"Question","name":"How do I install KYB?","acceptedAnswer":{"@type":"Answer","text":"On Apple Silicon macOS: brew install alex09x/apps/kyb, then brew services start kyb. With Docker: docker compose up -d, using the ghcr.io/alex09x/kyb image. Via Cargo: cargo install knowyourbusiness --locked, then kyb-server. Skills installation (skills/install.sh) and the client CLI require a repository checkout. From source: cargo run --release."}}]}]}
</script>
<style>
* { box-sizing: border-box; }
html, body { margin: 0; padding: 0; }
html { scroll-behavior: smooth; }
body {
--bg: oklch(0.148 0.012 260);
--bg2: oklch(0.185 0.014 260);
--panel: oklch(0.207 0.014 260);
--panel2: oklch(0.235 0.015 260);
--border: oklch(0.315 0.016 260);
--text: oklch(0.935 0.006 260);
--muted: oklch(0.685 0.013 260);
--faint: oklch(0.64 0.012 260);
--accent: oklch(0.76 0.132 196);
--accent-dim: oklch(0.40 0.07 196);
--incident: oklch(0.77 0.13 62);
--incident-dim: oklch(0.42 0.08 62);
--good: oklch(0.78 0.15 150);
--violet: oklch(0.70 0.14 300);
background: var(--bg);
}
a { color: var(--accent); text-decoration: none; }
a:hover { color: oklch(0.86 0.11 196); }
::selection { background: oklch(0.76 0.132 196 / 0.30); }
@keyframes kybBlink { 0%, 55% { opacity: 1; } 56%, 100% { opacity: 0; } }
img { max-width: 100%; height: auto; }
[data-hover] { transition: filter .18s ease, border-color .18s ease, color .18s ease, transform .18s ease; }
[data-hover="0"]:hover, [data-hover="2"]:hover, [data-hover="5"]:hover { border-color: var(--accent) !important; }
[data-hover="1"]:hover, [data-hover="4"]:hover { filter: brightness(1.08); }
[data-hover="3"]:hover, [data-hover="6"]:hover { color: var(--text) !important; }
a:focus-visible { outline: 2px solid var(--accent); outline-offset: 4px; border-radius: 4px; }
@media (max-width: 900px) {
nav div div:nth-child(3) { display: none !important; }
section > div[style*="grid-template-columns: 1.1fr"],
section > div[style*="grid-template-columns: 1fr 1fr"] { grid-template-columns: 1fr !important; }
}
@media (max-width: 600px) {
#citation { padding-left: 16px !important; padding-right: 16px !important; }
#citation > div { padding: 24px 16px !important; }
}
@media (prefers-reduced-motion: reduce) { * { animation: none !important; transition: none !important; } }
</style>
</head>
<body>
<div style="background: var(--bg); color: var(--text); font-family: 'Hanken Grotesk', system-ui, sans-serif; -webkit-font-smoothing: antialiased; line-height: 1.5; min-height: 100vh; overflow-x: hidden;">
<div style="position: absolute; inset: 0; overflow: hidden; pointer-events: none;">
<div style="position: absolute; top: -240px; left: 50%; transform: translateX(-50%); width: 900px; height: 620px; background: radial-gradient(ellipse at center, oklch(0.76 0.132 196 / 0.14), transparent 68%); filter: blur(20px);"></div>
<div style="position: absolute; top: 380px; right: -180px; width: 560px; height: 520px; background: radial-gradient(ellipse at center, oklch(0.77 0.13 62 / 0.09), transparent 66%); filter: blur(24px);"></div>
</div>
<!-- ===================== NAV ===================== -->
<nav aria-label="Primary" style="position: sticky; top: 0; z-index: 50; backdrop-filter: blur(14px); background: oklch(0.148 0.012 260 / 0.72); border-bottom: 1px solid var(--border);">
<div style="max-width: 1120px; margin: 0 auto; padding: 14px 28px; display: flex; align-items: center; gap: 20px;">
<a href="#top" style="display: flex; align-items: center; gap: 11px; color: var(--text);">
<span style="width: 30px; height: 30px; border-radius: 8px; background: linear-gradient(140deg, var(--accent), var(--accent-dim)); display: grid; place-items: center; font-family: 'Space Grotesk'; font-weight: 700; font-size: 15px; color: oklch(0.15 0.01 260); box-shadow: 0 0 0 1px oklch(0.76 0.132 196 / 0.4);">K</span>
<span style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 17px; letter-spacing: -0.01em;">KYB</span>
</a>
<div style="flex: 1;"></div>
<div style="display: flex; align-items: center; gap: 24px; font-size: 14px; font-weight: 500;">
<a href="#how" style="color: var(--muted);">How it works</a>
<a href="#incidents" style="color: var(--muted);">Incidents</a>
<a href="#tasks" style="color: var(--muted);">Tasks</a>
<a href="#skill" style="color: var(--muted);">Skill</a>
<a href="#mcp" style="color: var(--muted);">MCP</a>
<a href="#attribution" style="color: var(--muted);">Who</a>
<a href="#api" style="color: var(--muted);">API</a>
<a href="#install" style="color: var(--muted);">Install</a>
<a href="#citation" style="color: var(--muted);">Cite</a>
<a href="/blog/" style="color: var(--muted);">Blog</a>
</div>
<a href="https://github.com/alex09x/kyb" style="display: inline-flex; align-items: center; gap: 8px; padding: 8px 15px; border-radius: 9px; background: var(--panel); border: 1px solid var(--border); color: var(--text); font-size: 13.5px; font-weight: 600;" data-hover="0">
<span style="color: var(--incident);">★</span> Star on GitHub
</a>
</div>
</nav>
<main>
<div id="top"></div>
<!-- ===================== HERO ===================== -->
<header style="position: relative; max-width: 1120px; margin: 0 auto; padding: 90px 28px 40px;">
<div style="display: inline-flex; align-items: center; gap: 9px; padding: 6px 13px; border-radius: 999px; border: 1px solid var(--border); background: oklch(0.207 0.014 260 / 0.6); font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--muted); letter-spacing: 0.02em; margin-bottom: 26px;">
<span style="width: 7px; height: 7px; border-radius: 50%; background: var(--good); box-shadow: 0 0 8px var(--good);"></span>
Open source · Rust · MIT · kybmemory.com
</div>
<h1 style="font-family: 'Space Grotesk'; font-weight: 700; font-size: clamp(38px, 6vw, 68px); line-height: 1.03; letter-spacing: -0.025em; margin: 0 0 24px; max-width: 16ch; text-wrap: balance;">
The shared memory your <span style="color: var(--accent);">AI agent fleet</span> keeps forgetting it needs.
</h1>
<p style="font-size: clamp(17px, 2vw, 20px); color: var(--muted); max-width: 62ch; margin: 0 0 20px; text-wrap: pretty;">
<strong style="color: var(--text); font-weight: 600;">KYB — Know Your Business</strong> is a git-backed, searchable knowledge base for fleets of AI agents. Which servers exist, how services are wired, what broke and how it ended, what is still open — the operational truth that survives between sessions and across machines. Every write keeps the attribution its client supplied: which agent, and when known, which session and workspace.
</p>
<div style="display: flex; flex-wrap: wrap; gap: 9px; margin: 26px 0 32px;">
<span style="display: inline-flex; font-family: 'IBM Plex Mono'; font-size: 12px; border-radius: 6px; overflow: hidden; border: 1px solid var(--border);"><span style="padding: 4px 9px; background: var(--bg2); color: var(--muted);">license</span><span style="padding: 4px 9px; background: var(--accent-dim); color: var(--text);">MIT</span></span>
<span style="display: inline-flex; font-family: 'IBM Plex Mono'; font-size: 12px; border-radius: 6px; overflow: hidden; border: 1px solid var(--border);"><span style="padding: 4px 9px; background: var(--bg2); color: var(--muted);">tests</span><span style="padding: 4px 9px; background: oklch(0.40 0.09 150); color: var(--text);">421 test cases</span></span>
<span style="display: inline-flex; font-family: 'IBM Plex Mono'; font-size: 12px; border-radius: 6px; overflow: hidden; border: 1px solid var(--border);"><span style="padding: 4px 9px; background: var(--bg2); color: var(--muted);">search</span><span style="padding: 4px 9px; background: var(--panel2); color: var(--text);">hybrid · ~7–9ms LAN</span></span>
<span style="display: inline-flex; font-family: 'IBM Plex Mono'; font-size: 12px; border-radius: 6px; overflow: hidden; border: 1px solid var(--border);"><span style="padding: 4px 9px; background: var(--bg2); color: var(--muted);">rust</span><span style="padding: 4px 9px; background: var(--panel2); color: var(--text);">edition 2021</span></span>
<span style="display: inline-flex; font-family: 'IBM Plex Mono'; font-size: 12px; border-radius: 6px; overflow: hidden; border: 1px solid var(--border);"><span style="padding: 4px 9px; background: var(--bg2); color: var(--muted);">release</span><span style="padding: 4px 9px; background: oklch(0.40 0.09 300); color: var(--text);">v0.3.2 · brew · docker · cargo</span></span>
</div>
<div style="display: flex; flex-wrap: wrap; gap: 12px; align-items: center;">
<a href="https://github.com/alex09x/kyb" style="display: inline-flex; align-items: center; gap: 9px; padding: 13px 22px; border-radius: 11px; background: var(--accent); color: oklch(0.15 0.01 260); font-weight: 700; font-size: 15px;" data-hover="1">
<span style="color: oklch(0.15 0.01 260);">★</span> Star on GitHub
</a>
<a href="#install" style="display: inline-flex; align-items: center; gap: 9px; padding: 13px 22px; border-radius: 11px; background: var(--panel); border: 1px solid var(--border); color: var(--text); font-weight: 600; font-size: 15px;" data-hover="2">
Install →
</a>
<a href="#api" style="display: inline-flex; align-items: center; gap: 9px; padding: 13px 20px; border-radius: 11px; color: var(--muted); font-weight: 600; font-size: 15px;" data-hover="3">
Read the docs
</a>
</div>
</header>
<!-- ===================== TERMINAL ===================== -->
<section style="max-width: 1120px; margin: 0 auto; padding: 34px 28px 20px;">
<div style="border-radius: 16px; border: 1px solid var(--border); background: linear-gradient(180deg, var(--bg2), var(--bg)); box-shadow: 0 40px 80px -40px oklch(0 0 0 / 0.7); overflow: hidden;">
<div style="display: flex; align-items: center; gap: 8px; padding: 13px 16px; border-bottom: 1px solid var(--border); background: oklch(0.185 0.014 260 / 0.7);">
<span style="width: 12px; height: 12px; border-radius: 50%; background: oklch(0.68 0.16 25);"></span>
<span style="width: 12px; height: 12px; border-radius: 50%; background: oklch(0.82 0.14 85);"></span>
<span style="width: 12px; height: 12px; border-radius: 50%; background: oklch(0.78 0.15 150);"></span>
<span style="flex: 1; text-align: center; font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--faint);">agent@fleet — kyb — 96×26</span>
</div>
<pre role="region" tabindex="0" aria-label="KYB terminal example" style="margin: 0; padding: 24px 26px; font-family: 'IBM Plex Mono'; font-size: 14px; line-height: 1.85; color: var(--text); overflow-x: auto;"><span style="display:block;"><span style="color: var(--good);">$</span> kyb query <span style="color: var(--incident);">"which servers run clickhouse?"</span></span><span style="display:block;"><span style="color: var(--accent);">orders-api-architecture</span><span style="color: var(--muted);"> · score 0.867 · #infra #clickhouse</span></span><span style="display:block;"><span style="color: var(--muted);"> "orders_api on host-a is the single write path into ClickHouse (gRPC :9000)"</span></span><span style="display:block;"> </span><span style="display:block;"><span style="color: var(--good);">$</span> kyb incident --key inc-2026-08-06-orders-api-oom --severity <span style="color: var(--incident);">critical</span></span><span style="display:block;"><span style="color: var(--muted);">created · status </span><span style="color: var(--incident);">open</span><span style="color: var(--muted);"> · hints: add a `detection` check, link `knowledge`</span></span><span style="display:block;"> </span><span style="display:block;"><span style="color: var(--good);">$</span> kyb task-status task-raise-log-retention --status <span style="color: var(--violet);">in_progress</span> --assignee agent-a</span><span style="display:block;"><span style="color: var(--muted);">moved · assignee=agent-a · title, body, tags and priority untouched</span></span><span style="display:block;"> </span><span style="display:block;"><span style="color: var(--good);">$</span> kyb query <span style="color: var(--incident);">"why did the order service keep restarting"</span> <span style="color: var(--faint);"># no keyword overlap</span></span><span style="display:block;"><span style="color: var(--accent);">inc-2026-08-06-orders-api-oom</span><span style="color: var(--muted);"> · resolved · semantic hit ✓</span></span><span style="display:block;"><span style="color: var(--good);">$</span> <span style="display: inline-block; width: 9px; height: 17px; background: var(--accent); vertical-align: -3px; animation: kybBlink 1.1s steps(1) infinite;"></span></span></pre>
</div>
</section>
<!-- ===================== PROBLEM & CONCRETE USE CASE ===================== -->
<section style="max-width: 1120px; margin: 44px auto 0; padding: 0 28px;">
<div style="border-radius: 14px; border: 1px solid var(--border); background: oklch(0.185 0.014 260 / 0.5); padding: 26px 30px; display: flex; flex-direction: column; gap: 20px;">
<div style="display: flex; flex-wrap: wrap; gap: 16px; align-items: baseline;">
<span style="font-family: 'Space Grotesk'; font-size: 15px; font-weight: 600; color: var(--incident);">The problem</span>
<p style="margin: 0; font-size: 17px; color: var(--text); flex: 1; min-width: 280px; text-wrap: pretty;">
Agents forget everything between sessions. Multiple agents — Claude Code, Codex, Antigravity — on multiple machines rediscover the same infrastructure over and over, and every hard-won incident lesson evaporates the moment the context window closes.
</p>
</div>
<div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 14px; padding-top: 18px; border-top: 1px solid var(--border);">
<div style="background: var(--panel); border: 1px solid var(--border); border-radius: 10px; padding: 18px 20px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 12px; color: var(--accent); margin-bottom: 6px;">Concrete scenario</div>
<div style="font-size: 14.5px; color: var(--muted); line-height: 1.6;">
<strong style="color: var(--text);">Session 1:</strong> An agent diagnoses an outage, discovers that a write buffer exhausted container memory, fixes it, and files <code style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--accent);">inc-orders-api-oom</code> with an executable detection check and resolution.<br><br>
<strong style="color: var(--text);">Session 2 (weeks later):</strong> Another agent on a different machine asks <em>"why did the order service keep restarting?"</em> Hybrid search can surface that resolution even when the wording differs from the entry — instead of re-investigating what was already solved.
</div>
</div>
<div style="background: var(--panel); border: 1px solid var(--border); border-radius: 10px; padding: 18px 20px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 12px; color: var(--good); margin-bottom: 6px;">Fast setup in 3 steps</div>
<div style="font-size: 14.5px; color: var(--muted); line-height: 1.6;">
<strong style="color: var(--text);">1. Launch the server:</strong> <code style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--good);">brew install alex09x/apps/kyb && brew services start kyb</code> (or Docker / Cargo: <code style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--good);">cargo install knowyourbusiness --locked && kyb-server</code>).<br><br>
<strong style="color: var(--text);">2. Wire your fleet:</strong> Drop the skill into local agents via <code style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--good);">bash skills/install.sh</code> (from a <a href="https://github.com/alex09x/kyb" style="color: var(--accent); text-decoration: underline;">git checkout</a>), or connect directly over native HTTP MCP via <code style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--good);">POST /mcp</code>.<br><br>
<strong style="color: var(--text);">3. Ask before reasoning:</strong> Agents query KYB first, claim tasks, and enrich the shared knowledge base before finishing.
</div>
</div>
</div>
</div>
</section>
<!-- ===================== FEATURES ===================== -->
<section id="how" style="max-width: 1120px; margin: 88px auto 0; padding: 0 28px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--accent); letter-spacing: 0.08em; text-transform: uppercase; margin-bottom: 12px;">// How it works</div>
<h2 style="font-family: 'Space Grotesk'; font-weight: 700; font-size: clamp(28px, 4vw, 40px); letter-spacing: -0.02em; margin: 0 0 12px;">Seven ideas, one operational truth.</h2>
<p style="font-size: 18px; color: var(--muted); max-width: 60ch; margin: 0 0 38px;">No database, no namespaces, no ceremony. Just git, a disposable index, and a search that actually finds things.</p>
<div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(300px, 1fr)); gap: 16px;">
<div style="border-radius: 14px; border: 1px solid var(--border); background: var(--panel); padding: 24px;">
<div style="width: 40px; height: 40px; border-radius: 10px; background: var(--bg); border: 1px solid var(--border); display: grid; place-items: center; font-family: 'IBM Plex Mono'; color: var(--accent); font-size: 18px; margin-bottom: 16px;">⎇</div>
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 19px; margin: 0 0 8px;">Git is the canon</h3>
<p style="margin: 0; color: var(--muted); font-size: 15px; text-wrap: pretty;">One markdown file per entry, one commit per change. <strong style="color: var(--text); font-weight: 600;">A commit sha is a version id.</strong> There is no database — history, diff and rollback come for free, and any text editor can read the canon.</p>
</div>
<div style="border-radius: 14px; border: 1px solid var(--border); background: var(--panel); padding: 24px;">
<div style="width: 40px; height: 40px; border-radius: 10px; background: var(--bg); border: 1px solid var(--border); display: grid; place-items: center; font-family: 'IBM Plex Mono'; color: var(--accent); font-size: 18px; margin-bottom: 16px;">⌕</div>
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 19px; margin: 0 0 8px;">Hybrid search</h3>
<p style="margin: 0; color: var(--muted); font-size: 15px; text-wrap: pretty;">BM25 fused (reciprocal rank) with vector search over every entry — e5-small, int8 ONNX locally on CPU. Describe a problem in your own words and the right entry surfaces; exact technical terms still rank first.</p>
</div>
<div style="border-radius: 14px; border: 1px solid var(--border); background: var(--panel); padding: 24px;">
<div style="width: 40px; height: 40px; border-radius: 10px; background: var(--bg); border: 1px solid var(--border); display: grid; place-items: center; font-family: 'IBM Plex Mono'; color: var(--incident); font-size: 18px; margin-bottom: 16px;">⚠</div>
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 19px; margin: 0 0 8px;">Incidents & tasks built in</h3>
<p style="margin: 0; color: var(--muted); font-size: 15px; text-wrap: pretty;">Not just facts: operational events and work in flight are first-class entries with real lifecycles — and <strong style="color: var(--text); font-weight: 600;">every closing demands an outcome in writing</strong>.</p>
</div>
<div style="border-radius: 14px; border: 1px solid var(--border); background: var(--panel); padding: 24px;">
<div style="width: 40px; height: 40px; border-radius: 10px; background: var(--bg); border: 1px solid var(--border); display: grid; place-items: center; font-family: 'IBM Plex Mono'; color: var(--accent); font-size: 18px; margin-bottom: 16px;">↺</div>
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 19px; margin: 0 0 8px;">Upserts by key</h3>
<p style="margin: 0; color: var(--muted); font-size: 15px; text-wrap: pretty;">Writes are keyed and deterministic — a no-op when content did not change, so no empty commits. Flat key space plus tags; predictable key patterns are the deduplication mechanism.</p>
</div>
<div style="border-radius: 14px; border: 1px solid var(--border); background: var(--panel); padding: 24px;">
<div style="width: 40px; height: 40px; border-radius: 10px; background: var(--bg); border: 1px solid var(--border); display: grid; place-items: center; font-family: 'IBM Plex Mono'; color: var(--accent); font-size: 18px; margin-bottom: 16px;">✎</div>
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 19px; margin: 0 0 8px;">Every write says who</h3>
<p style="margin: 0; color: var(--muted); font-size: 15px; text-wrap: pretty;">A commit records the attribution its client supplied — the agent, and when known its session and the workspace it ran in — as git trailers, as <span style="font-family: 'IBM Plex Mono'; font-size: 13px;">by</span> in history and the ledger, on each version in the console. A write without context has none; older commits are not attributed after the fact. <strong style="color: var(--text); font-weight: 600;">Forensics, not identity:</strong> attribution grants nothing; tokens do.</p>
</div>
<div style="border-radius: 14px; border: 1px solid var(--border); background: var(--panel); padding: 24px;">
<div style="width: 40px; height: 40px; border-radius: 10px; background: var(--bg); border: 1px solid var(--border); display: grid; place-items: center; font-family: 'IBM Plex Mono'; color: var(--good); font-size: 18px; margin-bottom: 16px;">⌂</div>
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 19px; margin: 0 0 8px;">Local, private, no secrets</h3>
<p style="margin: 0; color: var(--muted); font-size: 15px; text-wrap: pretty;">Binds to <span style="font-family: 'IBM Plex Mono'; font-size: 13px;">127.0.0.1</span> by default. To serve a trusted LAN, opt into one exact private interface; out of the box tokens are <strong style="color: var(--text); font-weight: 600;">off</strong> and the service speaks plain HTTP, so never publish port 9310 to the internet as it is: turn tokens on and put TLS in front first. Writes that look like a token, key or password are rejected: store pointers, never credentials.</p>
</div>
<div style="border-radius: 14px; border: 1px solid var(--border); background: var(--panel); padding: 24px;">
<div style="width: 40px; height: 40px; border-radius: 10px; background: var(--bg); border: 1px solid var(--border); display: grid; place-items: center; font-family: 'IBM Plex Mono'; color: var(--incident); font-size: 18px; margin-bottom: 16px;">🦀</div>
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 19px; margin: 0 0 8px;">Rust, all the way down</h3>
<p style="margin: 0; color: var(--muted); font-size: 15px; text-wrap: pretty;">axum + tantivy 0.22 + git2 + ort (ONNX Runtime). One write mutex, lock-free reads. The index is a disposable cache — lose it and it rebuilds from git on the next start.</p>
</div>
</div>
</section>
<!-- ===================== ARCHITECTURE ===================== -->
<section id="architecture" style="max-width: 1120px; margin: 90px auto 0; padding: 0 28px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--accent); letter-spacing: 0.08em; text-transform: uppercase; margin-bottom: 12px;">// Architecture</div>
<h2 style="font-family: 'Space Grotesk'; font-weight: 700; font-size: clamp(28px, 4vw, 40px); letter-spacing: -0.02em; margin: 0 0 34px;">Git in, ranked answers out.</h2>
<figure style="margin: 0; padding: 0; border-radius: 18px; border: 1px solid var(--border); background: oklch(0.185 0.014 260 / 0.5); overflow: hidden;">
<a href="assets/kyb-architecture.png" target="_blank" rel="noopener noreferrer" style="display: block;">
<img src="assets/kyb-architecture.png" alt="KYB architecture: AI agents, Rust server, Git history and derived BM25 plus optional vector search" width="1586" height="992" loading="lazy" decoding="async" style="display: block; width: 100%; height: auto; border-bottom: 1px solid var(--border);">
</a>
<figcaption style="padding: 16px 22px; display: flex; flex-wrap: wrap; justify-content: space-between; align-items: center; gap: 12px; font-size: 14px; color: var(--muted); background: var(--panel);">
<span>Git keeps the durable history. The server rebuilds search state from Git and combines BM25 with optional vector search. Without a model, lexical search still works.</span>
<a href="assets/kyb-architecture.png" target="_blank" rel="noopener noreferrer" style="font-family: 'IBM Plex Mono'; font-size: 13px; font-weight: 600; color: var(--accent); white-space: nowrap;">View full size ↗</a>
</figcaption>
</figure>
</section>
<!-- ===================== THREE KINDS ===================== -->
<section style="max-width: 1120px; margin: 90px auto 0; padding: 0 28px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--accent); letter-spacing: 0.08em; text-transform: uppercase; margin-bottom: 12px;">// Entry kinds</div>
<h2 style="font-family: 'Space Grotesk'; font-weight: 700; font-size: clamp(28px, 4vw, 40px); letter-spacing: -0.02em; margin: 0 0 12px;">Three kinds, one flat key space.</h2>
<p style="font-size: 18px; color: var(--muted); max-width: 62ch; margin: 0 0 30px;">Only the closing states archive an entry — and every one of them requires an outcome in writing.</p>
<div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 16px;">
<div style="border-radius: 14px; border: 1px solid var(--border); background: var(--panel); padding: 24px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--accent); margin-bottom: 12px;">knowledge</div>
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 18px; margin: 0 0 8px;">What is true now</h3>
<p style="margin: 0 0 14px; color: var(--muted); font-size: 15px;">A fact under a stable key: architecture, topology, deploys, decisions, gotchas.</p>
<div style="font-family: 'IBM Plex Mono'; font-size: 12px; color: var(--faint); background: var(--bg); border: 1px solid var(--border); border-radius: 8px; padding: 9px 11px;">live → retracted</div>
</div>
<div style="border-radius: 14px; border: 1px solid var(--incident-dim); background: linear-gradient(180deg, oklch(0.77 0.13 62 / 0.06), var(--panel)); padding: 24px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--incident); margin-bottom: 12px;">incident · inc-…</div>
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 18px; margin: 0 0 8px;">What happened</h3>
<p style="margin: 0 0 14px; color: var(--muted); font-size: 15px;">An operational event: what broke, the impact, the runbook, the resolution.</p>
<div style="font-family: 'IBM Plex Mono'; font-size: 12px; color: var(--faint); background: var(--bg); border: 1px solid var(--border); border-radius: 8px; padding: 9px 11px;">open → mitigated → <span style="color: var(--good);">resolved</span></div>
</div>
<div style="border-radius: 14px; border: 1px solid oklch(0.70 0.14 300 / 0.45); background: linear-gradient(180deg, oklch(0.70 0.14 300 / 0.06), var(--panel)); padding: 24px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--violet); margin-bottom: 12px;">task · task-…</div>
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 18px; margin: 0 0 8px;">What is in flight</h3>
<p style="margin: 0 0 14px; color: var(--muted); font-size: 15px;">Work and ideas: who holds it right now, what it waits on, what came of it.</p>
<div style="font-family: 'IBM Plex Mono'; font-size: 12px; color: var(--faint); background: var(--bg); border: 1px solid var(--border); border-radius: 8px; padding: 9px 11px;">open → in_progress → blocked → <span style="color: var(--good);">done</span> | dropped</div>
</div>
</div>
</section>
<!-- ===================== INCIDENTS ===================== -->
<section id="incidents" style="max-width: 1120px; margin: 90px auto 0; padding: 0 28px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--incident); letter-spacing: 0.08em; text-transform: uppercase; margin-bottom: 12px;">// Incidents</div>
<h2 style="font-family: 'Space Grotesk'; font-weight: 700; font-size: clamp(28px, 4vw, 40px); letter-spacing: -0.02em; margin: 0 0 12px;">A report is a control panel, not a story.</h2>
<p style="font-size: 18px; color: var(--muted); max-width: 62ch; margin: 0 0 34px;">The server teaches structure instead of gating on it — a bare report is accepted, but the reply names every missing actionable part. Two hard rules: keys start with <span style="font-family: 'IBM Plex Mono'; font-size: 14px; color: var(--incident);">inc-</span>, and closing requires a resolution.</p>
<div style="display: grid; grid-template-columns: 1.1fr 0.9fr; gap: 16px; align-items: start;">
<div style="border-radius: 14px; border: 1px solid var(--border); overflow: hidden;">
<div style="display: grid; grid-template-columns: 130px 1fr; font-size: 14.5px;">
<div style="padding: 14px 16px; background: var(--panel); border-bottom: 1px solid var(--border); font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--incident);">detection</div>
<div style="padding: 14px 16px; background: var(--bg2); border-bottom: 1px solid var(--border); color: var(--muted);">An executable "is it still happening?" check, with the expected healthy result.</div>
<div style="padding: 14px 16px; background: var(--panel); border-bottom: 1px solid var(--border); font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--incident);">affected</div>
<div style="padding: 14px 16px; background: var(--bg2); border-bottom: 1px solid var(--border); color: var(--muted);">Machine-readable poisoned windows — a backtest excludes them programmatically.</div>
<div style="padding: 14px 16px; background: var(--panel); border-bottom: 1px solid var(--border); font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--incident);">knowledge</div>
<div style="padding: 14px 16px; background: var(--bg2); border-bottom: 1px solid var(--border); color: var(--muted);">Links to the knowledge entries the incident concerns.</div>
<div style="padding: 14px 16px; background: var(--panel); border-bottom: 1px solid var(--border); font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--incident);">resolution</div>
<div style="padding: 14px 16px; background: var(--bg2); border-bottom: 1px solid var(--border); color: var(--muted);">How it ended — searchable, so "how did we fix this last time" has an answer.</div>
<div style="padding: 14px 16px; background: var(--panel); border-bottom: 1px solid var(--border); font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--incident);">runbook</div>
<div style="padding: 14px 16px; background: var(--bg2); border-bottom: 1px solid var(--border); color: var(--muted);">Each step marked <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--good);">SAFE</span> (an agent may act alone) or <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--incident);">APPROVAL</span> (human required).</div>
<div style="padding: 14px 16px; background: var(--panel); font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--incident);">follow-ups</div>
<div style="padding: 14px 16px; background: var(--bg2); color: var(--muted);">Checkbox loose ends in the body — the server counts them and warns when you close over them.</div>
</div>
</div>
<div style="border-radius: 14px; border: 1px solid var(--incident-dim); background: linear-gradient(180deg, oklch(0.77 0.13 62 / 0.06), transparent); padding: 22px;">
<div style="display: flex; align-items: center; gap: 10px; margin-bottom: 16px;">
<span style="font-family: 'IBM Plex Mono'; font-size: 12px; padding: 3px 9px; border-radius: 6px; background: var(--incident); color: oklch(0.16 0.01 60); font-weight: 600;">RESOLVED</span>
<span style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--faint);">severity: critical</span>
</div>
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 17px; margin: 0 0 4px;">inc-2026-08-06-orders-api-oom</h3>
<p style="margin: 0 0 18px; color: var(--muted); font-size: 14px;">orders_api OOM loop: the write buffer grows until the container restarts.</p>
<div style="display: flex; flex-direction: column;">
<div style="display: flex; align-items: center; gap: 12px; padding: 8px 0; border-bottom: 1px dashed var(--border);"><span style="width: 9px; height: 9px; border-radius: 50%; background: var(--incident);"></span><span style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--muted);">started</span><span style="flex:1;"></span><span style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--faint);">14:02</span></div>
<div style="display: flex; align-items: center; gap: 12px; padding: 8px 0; border-bottom: 1px dashed var(--border);"><span style="width: 9px; height: 9px; border-radius: 50%; background: var(--incident);"></span><span style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--muted);">detected</span><span style="flex:1;"></span><span style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--faint);">14:09</span></div>
<div style="display: flex; align-items: center; gap: 12px; padding: 8px 0; border-bottom: 1px dashed var(--border);"><span style="width: 9px; height: 9px; border-radius: 50%; background: var(--accent);"></span><span style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--muted);">mitigated</span><span style="flex:1;"></span><span style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--faint);">14:31</span></div>
<div style="display: flex; align-items: center; gap: 12px; padding: 8px 0;"><span style="width: 9px; height: 9px; border-radius: 50%; background: var(--good);"></span><span style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--muted);">resolved</span><span style="flex:1;"></span><span style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--faint);">16:48</span></div>
</div>
<div style="margin-top: 16px; font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--good); background: var(--bg); border: 1px solid var(--border); border-radius: 8px; padding: 10px 12px;">✓ resolution recorded · 0 open follow-ups</div>
</div>
</div>
</section>
<!-- ===================== TASKS ===================== -->
<section id="tasks" style="max-width: 1120px; margin: 90px auto 0; padding: 0 28px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--violet); letter-spacing: 0.08em; text-transform: uppercase; margin-bottom: 12px;">// Tasks</div>
<h2 style="font-family: 'Space Grotesk'; font-weight: 700; font-size: clamp(28px, 4vw, 40px); letter-spacing: -0.02em; margin: 0 0 12px;">A board your agents can actually share.</h2>
<p style="font-size: 18px; color: var(--muted); max-width: 64ch; margin: 0 0 34px;">A task is a short actionable note with a real lifecycle. Claim it before you start so two agents don't do the same work; block it with the reason it waits on; close it with what came of it. Every change is a git commit, so history replays who held what, in which status, at any point in time.</p>
<div style="display: grid; grid-template-columns: 1fr 1fr; gap: 16px; align-items: start;">
<div style="border-radius: 14px; border: 1px solid var(--border); overflow: hidden;">
<div style="padding: 13px 18px; background: var(--panel); border-bottom: 1px solid var(--border); font-family: 'Space Grotesk'; font-weight: 600; font-size: 15px;">kyb tasks <span style="color: var(--faint); font-family: 'IBM Plex Mono'; font-size: 12.5px; font-weight: 400;">— live only, freshest on top</span></div>
<div style="padding: 16px 18px; border-bottom: 1px solid var(--border); background: var(--bg2);">
<div style="display: flex; align-items: center; gap: 9px; margin-bottom: 7px; flex-wrap: wrap;">
<span style="font-family: 'IBM Plex Mono'; font-size: 11.5px; padding: 2px 8px; border-radius: 5px; background: oklch(0.70 0.14 300 / 0.18); color: var(--violet); border: 1px solid oklch(0.70 0.14 300 / 0.35);">in_progress</span>
<span style="font-family: 'IBM Plex Mono'; font-size: 11.5px; padding: 2px 8px; border-radius: 5px; background: oklch(0.77 0.13 62 / 0.15); color: var(--incident); border: 1px solid var(--incident-dim);">high</span>
<span style="font-family: 'IBM Plex Mono'; font-size: 11.5px; color: var(--faint);">assignee=agent-a</span>
</div>
<div style="font-family: 'IBM Plex Mono'; font-size: 13.5px; color: var(--accent);">task-raise-log-retention</div>
<div style="font-size: 14px; color: var(--muted); margin-top: 3px;">72h retention, 2G disk budget</div>
</div>
<div style="padding: 16px 18px; border-bottom: 1px solid var(--border);">
<div style="display: flex; align-items: center; gap: 9px; margin-bottom: 7px; flex-wrap: wrap;">
<span style="font-family: 'IBM Plex Mono'; font-size: 11.5px; padding: 2px 8px; border-radius: 5px; background: oklch(0.77 0.13 62 / 0.15); color: var(--incident); border: 1px solid var(--incident-dim);">blocked</span>
<span style="font-family: 'IBM Plex Mono'; font-size: 11.5px; padding: 2px 8px; border-radius: 5px; background: oklch(0.68 0.16 25 / 0.15); color: oklch(0.75 0.16 25); border: 1px solid oklch(0.45 0.10 25);">critical</span>
<span style="font-family: 'IBM Plex Mono'; font-size: 11.5px; color: var(--faint);">assignee=agent-b</span>
</div>
<div style="font-family: 'IBM Plex Mono'; font-size: 13.5px; color: var(--accent);">task-swap-failing-disk</div>
<div style="font-size: 14px; color: var(--muted); margin-top: 3px;">waits on: the replacement disk</div>
</div>
<div style="padding: 16px 18px;">
<div style="display: flex; align-items: center; gap: 9px; margin-bottom: 7px; flex-wrap: wrap;">
<span style="font-family: 'IBM Plex Mono'; font-size: 11.5px; padding: 2px 8px; border-radius: 5px; background: var(--panel2); color: var(--muted); border: 1px solid var(--border);">open</span>
<span style="font-family: 'IBM Plex Mono'; font-size: 11.5px; color: var(--faint);">unclaimed</span>
</div>
<div style="font-family: 'IBM Plex Mono'; font-size: 13.5px; color: var(--accent);">task-audit-log-rotation</div>
<div style="font-size: 14px; color: var(--muted); margin-top: 3px;">audit.jsonl grows unbounded</div>
</div>
</div>
<div style="display: flex; flex-direction: column; gap: 16px;">
<div style="border-radius: 14px; border: 1px solid var(--border); background: var(--panel); padding: 22px 24px;">
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 16px; margin: 0 0 14px;">Partial transitions</h3>
<p style="margin: 0 0 14px; color: var(--muted); font-size: 15px; text-wrap: pretty;"><span style="font-family: 'IBM Plex Mono'; font-size: 13.5px; color: var(--violet);">kyb task-status</span> sends the status and nothing else — title, body, tags, priority and links stay exactly as stored. A transition never has to fetch and resend the task.</p>
<div style="display: grid; gap: 8px; font-family: 'IBM Plex Mono'; font-size: 12.5px;">
<div style="display: flex; gap: 10px; padding: 8px 11px; background: var(--bg); border: 1px solid var(--border); border-radius: 8px;"><span style="color: var(--faint); min-width: 88px;">pick up</span><span style="color: var(--text);">--status in_progress --assignee agent-a</span></div>
<div style="display: flex; gap: 10px; padding: 8px 11px; background: var(--bg); border: 1px solid var(--border); border-radius: 8px;"><span style="color: var(--faint); min-width: 88px;">get stuck</span><span style="color: var(--text);">--status blocked --blocked-reason "…"</span></div>
<div style="display: flex; gap: 10px; padding: 8px 11px; background: var(--bg); border: 1px solid var(--border); border-radius: 8px;"><span style="color: var(--faint); min-width: 88px;">hand back</span><span style="color: var(--text);">--status open --assignee ""</span></div>
<div style="display: flex; gap: 10px; padding: 8px 11px; background: var(--bg); border: 1px solid var(--border); border-radius: 8px;"><span style="color: var(--faint); min-width: 88px;">finish</span><span style="color: var(--good);">kyb done <key> <<< "what came of it"</span></div>
</div>
</div>
<div style="border-radius: 14px; border: 1px solid var(--border); background: oklch(0.185 0.014 260 / 0.5); padding: 22px 24px;">
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 16px; margin: 0 0 10px;">Nothing is inferred</h3>
<p style="margin: 0; color: var(--muted); font-size: 15px; text-wrap: pretty;">Unranked stays unranked, unclaimed stays unclaimed. A <span style="font-family: 'IBM Plex Mono'; font-size: 13px;">blocked_reason</span> is only valid while blocked — moving off <span style="font-family: 'IBM Plex Mono'; font-size: 13px;">blocked</span> clears it, so a task never advertises a block it is out of. <span style="font-family: 'IBM Plex Mono'; font-size: 13px;">parent_task</span> hangs child work under the task it belongs to.</p>
</div>
</div>
</div>
</section>
<!-- ===================== AGENT SKILL ===================== -->
<section id="skill" style="max-width: 1120px; margin: 90px auto 0; padding: 0 28px;">
<div style="border-radius: 18px; border: 1px solid var(--border); background: oklch(0.185 0.014 260 / 0.5); padding: 40px 34px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--accent); letter-spacing: 0.08em; text-transform: uppercase; margin-bottom: 12px;">// The agent skill</div>
<h2 style="font-family: 'Space Grotesk'; font-weight: 700; font-size: clamp(26px, 3.6vw, 36px); letter-spacing: -0.02em; margin: 0 0 12px;">One command wires it into every agent on the machine.</h2>
<p style="font-size: 17px; color: var(--muted); max-width: 64ch; margin: 0 0 28px; text-wrap: pretty;">A skill an agent never opens is a skill it never uses — so the installer drops a pointer into each agent's <strong style="color: var(--text); font-weight: 600;">always-loaded global instructions</strong>. Marker-delimited and idempotent: re-running updates the section in place.</p>
<div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); gap: 14px; margin-bottom: 26px;">
<div style="border-radius: 12px; border: 1px solid var(--border); background: var(--bg); padding: 18px;">
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 16px; margin: 0 0 6px;">Claude Code</h3>
<p style="margin: 0; font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--muted); line-height: 1.7;">~/.claude/skills/kyb<br>+ CLAUDE.md</p>
</div>
<div style="border-radius: 12px; border: 1px solid var(--border); background: var(--bg); padding: 18px;">
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 16px; margin: 0 0 6px;">Codex</h3>
<p style="margin: 0; font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--muted); line-height: 1.7;">~/.codex/skills/kyb<br>+ AGENTS.md</p>
</div>
<div style="border-radius: 12px; border: 1px solid var(--border); background: var(--bg); padding: 18px;">
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 16px; margin: 0 0 6px;">Antigravity</h3>
<p style="margin: 0; font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--muted); line-height: 1.7;">~/.gemini/…/skills/kyb<br>+ GEMINI.md</p>
</div>
</div>
<div style="border-radius: 11px; background: var(--bg); border: 1px solid var(--border); padding: 16px 18px; font-family: 'IBM Plex Mono'; font-size: 14px; overflow-x: auto; margin-bottom: 12px;"><span style="color: var(--good);">$</span> KYB_SERVER=your-server:9310 bash skills/install.sh</div>
<p style="margin: 0 0 26px; color: var(--muted); font-size: 13.5px; line-height: 1.6;">Executed from a clone of the <a href="https://github.com/alex09x/kyb" style="color: var(--accent); text-decoration: underline;">KYB repository</a>. (The Homebrew package installs the client CLI and wires this automatically.)</p>
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 17px; margin: 0 0 14px;">What no database can enforce — governance</h3>
<div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 12px;">
<div style="border-radius: 11px; border: 1px solid var(--border); background: var(--bg); padding: 16px 18px;"><span style="font-family: 'IBM Plex Mono'; font-size: 12px; color: var(--accent);">01</span><p style="margin: 6px 0 0; color: var(--muted); font-size: 14.5px;">The loop is <strong style="color: var(--text); font-weight: 600;">ask → assess → enrich</strong>: query before reasoning, write back what you learned before finishing.</p></div>
<div style="border-radius: 11px; border: 1px solid var(--border); background: var(--bg); padding: 16px 18px;"><span style="font-family: 'IBM Plex Mono'; font-size: 12px; color: var(--accent);">02</span><p style="margin: 6px 0 0; color: var(--muted); font-size: 14.5px;">Always query before adding. Found something close? Overwrite the <strong style="color: var(--text); font-weight: 600;">same key</strong> — duplicates kill a shared base.</p></div>
<div style="border-radius: 11px; border: 1px solid var(--border); background: var(--bg); padding: 16px 18px;"><span style="font-family: 'IBM Plex Mono'; font-size: 12px; color: var(--accent);">03</span><p style="margin: 6px 0 0; color: var(--muted); font-size: 14.5px;">Entries are self-contained and hold verified facts only — never a guess dressed as knowledge.</p></div>
<div style="border-radius: 11px; border: 1px solid var(--border); background: var(--bg); padding: 16px 18px;"><span style="font-family: 'IBM Plex Mono'; font-size: 12px; color: var(--accent);">04</span><p style="margin: 6px 0 0; color: var(--muted); font-size: 14.5px;">Working a task means <strong style="color: var(--text); font-weight: 600;">claiming it first</strong>, blocking it with a reason, closing it with an outcome.</p></div>
<div style="border-radius: 11px; border: 1px solid var(--border); background: var(--bg); padding: 16px 18px;"><span style="font-family: 'IBM Plex Mono'; font-size: 12px; color: var(--accent);">05</span><p style="margin: 6px 0 0; color: var(--muted); font-size: 14.5px;">Broke something? File an incident, close it with a real resolution, then <strong style="color: var(--text); font-weight: 600;">fold the lesson back into knowledge</strong>.</p></div>
<div style="border-radius: 11px; border: 1px solid var(--border); background: var(--bg); padding: 16px 18px;"><span style="font-family: 'IBM Plex Mono'; font-size: 12px; color: var(--accent);">06</span><p style="margin: 6px 0 0; color: var(--muted); font-size: 14.5px;">Secrets never in bodies — pointers in <span style="font-family: 'IBM Plex Mono'; font-size: 13px;">refs</span>, and the server rejects the rest.</p></div>
</div>
</div>
</section>
<!-- ===================== MCP ===================== -->
<section id="mcp" style="max-width: 1120px; margin: 90px auto 0; padding: 0 28px;">
<div style="border-radius: 18px; border: 1px solid var(--border); background: oklch(0.185 0.014 260 / 0.5); padding: 40px 34px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--accent); letter-spacing: 0.08em; text-transform: uppercase; margin-bottom: 12px;">// Model Context Protocol</div>
<h2 style="font-family: 'Space Grotesk'; font-weight: 700; font-size: clamp(26px, 3.6vw, 36px); letter-spacing: -0.02em; margin: 0 0 12px;">Native MCP over HTTP.</h2>
<p style="font-size: 17px; color: var(--muted); max-width: 64ch; margin: 0 0 24px; text-wrap: pretty;">KYB is not an MCP alternative — it speaks Model Context Protocol natively. The server serves the MCP protocol directly over HTTP at <span style="font-family: 'IBM Plex Mono'; font-size: 14px; color: var(--accent);">POST /mcp</span>. No client-side adapters, no subprocesses, and no client packages to install or update.</p>
<div style="border-radius: 11px; background: var(--bg); border: 1px solid var(--border); padding: 16px 18px; font-family: 'IBM Plex Mono'; font-size: 13.5px; line-height: 1.9; overflow-x: auto; margin-bottom: 24px;">
<span style="display:block;"><span style="color: var(--faint);"># any client that speaks MCP over HTTP; one URL, no package</span></span>
<span style="display:block;"><span style="color: var(--good);">$</span> claude mcp add --transport http kyb http://<host>:9310/mcp <span style="color: var(--faint);"># Claude Code</span></span>
<span style="display:block;"><span style="color: var(--good);">$</span> codex mcp add kyb --url http://<host>:9310/mcp <span style="color: var(--faint);"># Codex</span></span>
<span style="display:block;"><span style="color: var(--good);">$</span> agy mcp add -t http kyb http://<host>:9310/mcp <span style="color: var(--faint);"># Antigravity</span></span>
<span style="display:block;"><span style="color: var(--good);">$</span> gemini mcp add -t http kyb http://<host>:9310/mcp <span style="color: var(--faint);"># Gemini CLI</span></span>
<span style="display:block;"><span style="color: var(--faint);"># Cursor, Windsurf, VS Code and any other client that speaks MCP over HTTP: the same URL, in that client’s own configuration file and schema</span></span>
</div>
<div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 14px;">
<div style="border-radius: 12px; border: 1px solid var(--border); background: var(--bg); padding: 18px 20px;">
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 16px; margin: 0 0 6px;">Zero client adapters</h3>
<p style="margin: 0; color: var(--muted); font-size: 14px; line-height: 1.6;">The tool list is generated by the server. Clients discover capabilities when listing tools, without updating a local KYB adapter, and may need to refresh or reconnect after an upgrade.</p>
</div>
<div style="border-radius: 12px; border: 1px solid var(--border); background: var(--bg); padding: 18px 20px;">
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 16px; margin: 0 0 6px;">Shared audit log</h3>
<p style="margin: 0; color: var(--muted); font-size: 14px; line-height: 1.6;">Tool calls forwarded through <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">/mcp</span> execute against the same API routes and share the audit log; when tokens are on, the actor is recorded too. Eligible operations (entry gets, search queries, and mutations) are recorded with caller IP and duration, while routine health (<span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">/healthz</span>), taxonomy (<span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">/tags</span>), and all incident and task list reads are excluded to avoid polling noise.</p>
</div>
<div style="border-radius: 12px; border: 1px solid var(--border); background: var(--bg); padding: 18px 20px;">
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 16px; margin: 0 0 6px;">Agent skills or MCP</h3>
<p style="margin: 0; color: var(--muted); font-size: 14px; line-height: 1.6;">Both reach the same server. The agent skill (<span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">skills/install.sh</span>) gives Claude Code, Codex and Antigravity the <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">kyb</span> command and the rules for using it; MCP is for any client that would rather call tools than run a shell — IDEs, desktop apps, or those same agents. Either path records attribution when the client supplies it: the CLI reads its environment, MCP needs the hook, the client’s metadata or the headers described under <a href="#attribution" style="color: var(--accent); text-decoration: none;">Attribution</a>; a client registered with nothing but the URL writes unattributed.</p>
</div>
</div>
</div>
</section>
<!-- ===================== ATTRIBUTION ===================== -->
<section id="attribution" style="max-width: 1120px; margin: 90px auto 0; padding: 0 28px;">
<div style="border-radius: 18px; border: 1px solid var(--border); background: oklch(0.185 0.014 260 / 0.5); padding: 40px 34px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--accent); letter-spacing: 0.08em; text-transform: uppercase; margin-bottom: 12px;">// Attribution</div>
<h2 style="font-family: 'Space Grotesk'; font-weight: 700; font-size: clamp(26px, 3.6vw, 36px); letter-spacing: -0.02em; margin: 0 0 12px;">Who wrote what, on every version.</h2>
<p style="font-size: 17px; color: var(--muted); max-width: 64ch; margin: 0 0 24px; text-wrap: pretty;">Since 0.3.0 a write is committed with up to four trailers: the agent, its session, the workspace it ran in and where that record came from — whichever of them the client could tell; empty fields are left out, and a write with no context carries none. History and the activity ledger return them as <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">by</span>; the console shows them on each version; <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">kyb whoami</span> shows what the current shell would write. Workspaces are a repository name and a path inside it, never an absolute path. The git author stays the service’s unless tokens name a principal.</p>
<div style="border-radius: 11px; background: var(--bg); border: 1px solid var(--border); padding: 16px 18px; font-family: 'IBM Plex Mono'; font-size: 13.5px; line-height: 1.8; overflow-x: auto; margin-bottom: 24px; white-space: pre;"><span style="color: var(--faint);">kyb: upsert inc-2026-10-11-orders-api-oom</span>
<span style="color: var(--accent);">Kyb-Agent:</span> codex
<span style="color: var(--accent);">Kyb-Session:</span> example-session-001
<span style="color: var(--accent);">Kyb-Workspace:</span> orders-api
<span style="color: var(--accent);">Kyb-Via:</span> cli</div>
<div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(230px, 1fr)); gap: 14px;">
<div style="border-radius: 12px; border: 1px solid var(--border); background: var(--bg); padding: 18px 20px;">
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 16px; margin: 0 0 6px;">via: cli</h3>
<p style="margin: 0; color: var(--muted); font-size: 14px; line-height: 1.6;">The <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">kyb</span> command read the environment the agent runs it in: which provider, which session, which repository.</p>
</div>
<div style="border-radius: 12px; border: 1px solid var(--border); background: var(--bg); padding: 18px 20px;">
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 16px; margin: 0 0 6px;">via: hook</h3>
<p style="margin: 0; color: var(--muted); font-size: 14px; line-height: 1.6;">Claude Code calls the MCP tools over HTTP; a decision-free PreToolUse hook adds the record to each call, and the server takes it out of the arguments before the API sees them.</p>
</div>
<div style="border-radius: 12px; border: 1px solid var(--border); background: var(--bg); padding: 18px 20px;">
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 16px; margin: 0 0 6px;">via: meta</h3>
<p style="margin: 0; color: var(--muted); font-size: 14px; line-height: 1.6;">The MCP client’s own call metadata named the conversation (Codex, Antigravity) when there is no hook. Fixture-tested; live evidence so far is for cli and hook.</p>
</div>
<div style="border-radius: 12px; border: 1px solid var(--border); background: var(--bg); padding: 18px 20px;">
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 16px; margin: 0 0 6px;">via: headers</h3>
<p style="margin: 0; color: var(--muted); font-size: 14px; line-height: 1.6;">Any client: <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">X-Kyb-Agent</span>, <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">X-Kyb-Session</span>, <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">X-Kyb-Workspace</span>. Sources are read in order — hook, then the client’s metadata, then headers. The first source that names an agent selects the agent and the session it has; a missing session may be filled by a source naming the same agent or no agent, and the workspace is the first available value. <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">via</span> names the agent’s source; which source filled each field is not recorded.</p>
</div>
</div>
<p style="margin: 20px 0 0; color: var(--faint); font-size: 13.5px; max-width: 70ch;">The record is what the caller supplied, not an authenticated identity. <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">GET /whoami</span> echoes it back. Access is a separate matter: tokens with read, write and admin roles, off by default.</p>
</div>
</section>
<!-- ===================== CONSOLE ===================== -->
<section id="console" style="max-width: 1120px; margin: 90px auto 0; padding: 0 28px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--accent); letter-spacing: 0.08em; text-transform: uppercase; margin-bottom: 12px;">// Console</div>
<h2 style="font-family: 'Space Grotesk'; font-weight: 700; font-size: clamp(26px, 3.6vw, 36px); letter-spacing: -0.02em; margin: 0 0 12px;">A console for people, served from the binary.</h2>
<p style="font-size: 17px; color: var(--muted); max-width: 64ch; margin: 0 0 24px; text-wrap: pretty;">Open <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">http://<host>:9310/</span>. No build step, no separate service, one quiet type scale; colour only where state demands it. Every screen and every write a person can make is driven by a browser test in CI, with block coverage of the page script held at 100%.</p>
<div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(230px, 1fr)); gap: 14px;">
<div style="border-radius: 12px; border: 1px solid var(--border); background: var(--bg); padding: 18px 20px;">
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 16px; margin: 0 0 6px;">Queues, not boards</h3>
<p style="margin: 0; color: var(--muted); font-size: 14px; line-height: 1.6;">Incidents and tasks are attention queues: what needs a person now, with the reason in the row — blocked and why, open with no detection check, stale for how long.</p>
</div>
<div style="border-radius: 12px; border: 1px solid var(--border); background: var(--bg); padding: 18px 20px;">
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 16px; margin: 0 0 6px;">Versions</h3>
<p style="margin: 0; color: var(--muted); font-size: 14px; line-height: 1.6;">An entry’s own ledger: every version, newest first, with the whole of what it changed and, when the client said, who wrote it and from where. Any version is one click away as it was first written.</p>
</div>
<div style="border-radius: 12px; border: 1px solid var(--border); background: var(--bg); padding: 18px 20px;">
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 16px; margin: 0 0 6px;">Ledger</h3>
<p style="margin: 0; color: var(--muted); font-size: 14px; line-height: 1.6;">Activity is a change ledger: the whole change, not a feed. Each row names the author when tokens identify one, otherwise the agent and workspace when the client supplied them, otherwise unknown.</p>
</div>
<div style="border-radius: 12px; border: 1px solid var(--border); background: var(--bg); padding: 18px 20px;">
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 16px; margin: 0 0 6px;">Services and hosts</h3>
<p style="margin: 0; color: var(--muted); font-size: 14px; line-height: 1.6;">For each service or host an incident names: what is open on it right now, the notes those incidents cite, the open tasks pointing at them. Every row says why it is listed; nothing is inferred from tags.</p>
</div>
</div>
</section>
<!-- ===================== BENCHMARK ===================== -->
<section id="benchmark" style="max-width: 1120px; margin: 90px auto 0; padding: 0 28px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--accent); letter-spacing: 0.08em; text-transform: uppercase; margin-bottom: 12px;">// Search quality</div>
<h2 style="font-family: 'Space Grotesk'; font-weight: 700; font-size: clamp(28px, 4vw, 40px); letter-spacing: -0.02em; margin: 0 0 12px;">Vectors earn their keep.</h2>
<p style="font-size: 18px; color: var(--muted); max-width: 64ch; margin: 0 0 24px; text-wrap: pretty;">Evaluated with <span style="font-family: 'IBM Plex Mono'; font-size: 14px; color: var(--accent);">scripts/eval-search.sh</span> using paraphrase questions that share few or no tokens with the entries they land on. In-memory Tantivy BM25 fused with an int8 multilingual ONNX model running locally on CPU.</p>
<div style="border-radius: 14px; border: 1px solid var(--border); overflow: hidden; background: var(--panel);">
<div style="display: grid; grid-template-columns: 2fr 1fr 1fr 1fr; font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--faint); background: var(--bg2);">
<div style="padding: 13px 20px;">SETUP</div>
<div style="padding: 13px 20px; text-align: center;">TOP-1</div>
<div style="padding: 13px 20px; text-align: center;">TOP-3</div>
<div style="padding: 13px 20px; text-align: center;">TYPICAL LATENCY</div>
</div>
<div style="display: grid; grid-template-columns: 2fr 1fr 1fr 1fr; align-items: center; border-top: 1px solid var(--border); font-size: 15px;">
<div style="padding: 16px 20px; color: var(--muted);">lexical only (BM25)</div>
<div style="padding: 16px 20px; text-align: center; font-family: 'IBM Plex Mono'; color: var(--faint);">1 / 14</div>
<div style="padding: 16px 20px; text-align: center; font-family: 'IBM Plex Mono'; color: var(--faint);">2 / 14</div>
<div style="padding: 16px 20px; text-align: center; font-family: 'IBM Plex Mono'; color: var(--muted);">~7 ms</div>
</div>
<div style="display: grid; grid-template-columns: 2fr 1fr 1fr 1fr; align-items: center; border-top: 1px solid var(--border); font-size: 15px; background: oklch(0.76 0.132 196 / 0.06);">
<div style="padding: 16px 20px; color: var(--text); font-weight: 600;">+ e5-small int8 <span style="color: var(--faint); font-weight: 400; font-family: 'IBM Plex Mono'; font-size: 12.5px;">118 MB · default in container</span></div>
<div style="padding: 16px 20px; text-align: center; font-family: 'IBM Plex Mono'; color: var(--accent); font-weight: 600;">3 / 14</div>
<div style="padding: 16px 20px; text-align: center; font-family: 'IBM Plex Mono'; color: var(--accent); font-weight: 600;">4 / 14</div>
<div style="padding: 16px 20px; text-align: center; font-family: 'IBM Plex Mono'; color: var(--accent); font-weight: 600;">~9 ms</div>
</div>
</div>
<div style="margin-top: 14px; padding: 14px 18px; border-radius: 10px; background: var(--bg2); border: 1px solid var(--border); font-size: 13.5px; color: var(--muted); line-height: 1.6;">
<strong style="color: var(--text);">Documented measurement (2026-09-22):</strong> Measured over LAN against a 643-entry base with e5-small int8 using the 14 reference paraphrase questions in <code style="font-family: 'IBM Plex Mono'; font-size: 12px; color: var(--accent);">scripts/eval-search.sh</code>. The example queries were originally drafted against a different test base (three target keys are absent from this 643-entry corpus, capping the reachable score well below 14/14). On identical queries against the same corpus, hybrid vector fusion roughly doubles retrieval hit rate over lexical BM25 alone. Replace example queries and target keys with your own base before drawing production conclusions.
</div>
</section>
<!-- ===================== HTTP API ===================== -->
<section id="api" style="max-width: 1120px; margin: 90px auto 0; padding: 0 28px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--accent); letter-spacing: 0.08em; text-transform: uppercase; margin-bottom: 12px;">// HTTP API</div>
<h2 style="font-family: 'Space Grotesk'; font-weight: 700; font-size: clamp(28px, 4vw, 40px); letter-spacing: -0.02em; margin: 0 0 12px;">A small, honest surface.</h2>
<p style="font-size: 18px; color: var(--muted); max-width: 62ch; margin: 0 0 30px;">Eligible API operations are appended to a JSONL audit log — timestamp, ip, method, path, status, duration — while routine health (<span style="font-family:'IBM Plex Mono'; font-size:14px;">/healthz</span>), taxonomy (<span style="font-family:'IBM Plex Mono'; font-size:14px;">/tags</span>), and all incident and task list reads are excluded to avoid polling noise.</p>
<div style="border-radius: 14px; border: 1px solid var(--border); overflow: hidden;">
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-family: 'IBM Plex Mono'; font-size: 12px; color: var(--faint); background: var(--bg2); border-bottom: 1px solid var(--border);">
<div style="padding: 12px 16px;">METHOD</div><div style="padding: 12px 16px;">PATH</div><div style="padding: 12px 16px;">WHAT IT DOES</div>
</div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center;"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--good); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">POST</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--accent);">/knowledge</div><div style="padding: 13px 16px; color: var(--muted);">Upsert by key → <span style="font-family:'IBM Plex Mono'; font-size:12.5px;">{key, sha, changed, action}</span>. Identical content = no commit.</div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center; background: oklch(0.185 0.014 260 / 0.4);"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--accent); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">GET</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--accent);">/knowledge/{key}</div><div style="padding: 13px 16px; color: var(--muted);">Current entry; <span style="font-family:'IBM Plex Mono'; font-size:12.5px;">?at=<sha></span> returns a version from history.</div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center;"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--accent); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">GET</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--accent);">/knowledge/{key}/history</div><div style="padding: 13px 16px; color: var(--muted);">Every version, newest first, with what changed.</div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center; background: oklch(0.185 0.014 260 / 0.4);"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--incident); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">DEL</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--accent);">/knowledge/{key}</div><div style="padding: 13px 16px; color: var(--muted);">Retract knowledge / archive an incident or task. History stays searchable.</div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center;"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--good); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">POST</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--incident);">/incidents</div><div style="padding: 13px 16px; color: var(--muted);">Upsert a report; reply carries <span style="font-family:'IBM Plex Mono'; font-size:12.5px;">hints</span> + <span style="font-family:'IBM Plex Mono'; font-size:12.5px;">unknown_knowledge</span>.</div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center; background: oklch(0.185 0.014 260 / 0.4);"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--accent); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">GET</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--incident);">/incidents</div><div style="padding: 13px 16px; color: var(--muted);">Filter by status / service / follow-ups. Live first, freshest on top.</div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center;"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--good); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">POST</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--incident);">/incidents/{key}/resolve</div><div style="padding: 13px 16px; color: var(--muted);">Flip status, record the outcome, stamp the timeline. Resolution required.</div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center; background: oklch(0.185 0.014 260 / 0.4);"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--good); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">POST</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--violet);">/tasks</div><div style="padding: 13px 16px; color: var(--muted);">Upsert a task, or send a <strong style="color: var(--text); font-weight: 600;">partial</strong> status / assignee / parent / blocked-reason update.</div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center;"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--accent); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">GET</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--violet);">/tasks</div><div style="padding: 13px 16px; color: var(--muted);"><span style="font-family:'IBM Plex Mono'; font-size:12.5px;">?status=&priority=&assignee=&parent_task=</span> — live tasks, freshest on top.</div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center; background: oklch(0.185 0.014 260 / 0.4);"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--good); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">POST</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--violet);">/tasks/{key}/resolve</div><div style="padding: 13px 16px; color: var(--muted);"><span style="font-family:'IBM Plex Mono'; font-size:12.5px;">done</span> or <span style="font-family:'IBM Plex Mono'; font-size:12.5px;">dropped</span> — resolution required, then archived.</div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center;"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--accent); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">GET</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--accent);">/search</div><div style="padding: 13px 16px; color: var(--muted);">Ranked hits with full bodies. <span style="font-family:'IBM Plex Mono'; font-size:12.5px;">?q=&tag=&history=&kind=&status=&sort=</span> · <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">as_of=</span> the base as it stood then — a date, an RFC 3339 instant or a git revision; the version current at that instant answers, never a superseded one · <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">changed_between=</span></div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center; background: oklch(0.185 0.014 260 / 0.4);"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--accent); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">GET</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--accent);">/knowledge/{key}/diff</div><div style="padding: 13px 16px; color: var(--muted);"><span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">?from=&to=</span> — the change between two versions: fields and body lines.</div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center;"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--accent); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">GET</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--accent);">/knowledge/{key}/related</div><div style="padding: 13px 16px; color: var(--muted);">What the entry refers to and what refers to it, each with how — a <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">knowledge</span> list, a <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">parent_task</span>, a link in the text. Never a shared tag.</div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center; background: oklch(0.185 0.014 260 / 0.4);"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--accent); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">GET</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--accent);">/places</div><div style="padding: 13px 16px; color: var(--muted);">Services and hosts named by incidents, open and total, the worst first.</div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center;"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--accent); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">GET</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--accent);">/impact</div><div style="padding: 13px 16px; color: var(--muted);"><span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">?service=</span> or <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">?host=</span> — incidents on it, the notes they cite, the open tasks pointing at either.</div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center; background: oklch(0.185 0.014 260 / 0.4);"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--accent); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">GET</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--good);">/whoami</div><div style="padding: 13px 16px; color: var(--muted);">The role this request has and the attribution it carries — what a write from here would record.</div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center;"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--accent); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">GET</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--good);">/api/activity</div><div style="padding: 13px 16px; color: var(--muted);">The change ledger: action, key, author, <span style="font-family: 'IBM Plex Mono'; font-size: 12.5px;">by</span>, files, sha, time.</div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; border-bottom: 1px solid var(--border); align-items: center; background: oklch(0.185 0.014 260 / 0.4);"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--accent); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">GET</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--accent);">/tags</div><div style="padding: 13px 16px; color: var(--muted);">Which topics the base covers, most used first.</div></div>
<div style="display: grid; grid-template-columns: 74px 1.15fr 2fr; font-size: 14px; align-items: center;"><div style="padding: 13px 16px;"><span style="font-family:'IBM Plex Mono'; font-size: 11px; color: var(--accent); border: 1px solid var(--border); border-radius: 5px; padding: 2px 6px;">GET</span></div><div style="padding: 13px 16px; font-family:'IBM Plex Mono'; font-size: 13px; color: var(--good);">/healthz</div><div style="padding: 13px 16px; color: var(--muted);">entries · open_incidents · open_tasks · index_docs · last_commit</div></div>
</div>
</section>
<!-- ===================== INSTALL ===================== -->
<section id="install" style="max-width: 1120px; margin: 90px auto 0; padding: 0 28px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--accent); letter-spacing: 0.08em; text-transform: uppercase; margin-bottom: 12px;">// Install</div>
<h2 style="font-family: 'Space Grotesk'; font-weight: 700; font-size: clamp(28px, 4vw, 40px); letter-spacing: -0.02em; margin: 0 0 34px;">Up in two commands.</h2>
<div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(300px, 1fr)); gap: 16px;">
<div style="border-radius: 14px; border: 1px solid var(--accent-dim); overflow: hidden;">
<div style="padding: 12px 18px; border-bottom: 1px solid var(--border); background: var(--panel); display: flex; align-items: center; gap: 10px;">
<span style="font-size: 13px;">🍺</span>
<span style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 15px;">macOS · Apple Silicon</span>
</div>
<pre role="region" tabindex="0" aria-label="Homebrew installation commands" style="margin: 0; padding: 20px; font-family: 'IBM Plex Mono'; font-size: 13.5px; line-height: 1.85; color: var(--text); background: var(--bg); overflow-x: auto;"><span style="display:block;"><span style="color: var(--good);">$</span> brew install alex09x/apps/kyb</span><span style="display:block;"><span style="color: var(--good);">$</span> brew services start kyb</span></pre>
<div style="padding: 14px 18px; background: var(--bg2); color: var(--muted); font-size: 13.5px; border-top: 1px solid var(--border);">Installs both binaries, wires the skill into every agent on the machine, and keeps the server alive under launchd.</div>
</div>
<div style="border-radius: 14px; border: 1px solid var(--border); overflow: hidden;">
<div style="padding: 12px 18px; border-bottom: 1px solid var(--border); background: var(--panel); display: flex; align-items: center; gap: 10px;">
<span style="font-size: 13px;">🐳</span>
<span style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 15px;">Docker</span>
</div>
<pre role="region" tabindex="0" aria-label="Docker installation commands" style="margin: 0; padding: 20px; font-family: 'IBM Plex Mono'; font-size: 13.5px; line-height: 1.85; color: var(--text); background: var(--bg); overflow-x: auto;"><span style="display:block;"><span style="color: var(--good);">$</span> docker compose up -d</span><span style="display:block;"><span style="color: var(--faint);"># ghcr.io/alex09x/kyb:latest</span></span></pre>
<div style="padding: 14px 18px; background: var(--bg2); color: var(--muted); font-size: 13.5px; border-top: 1px solid var(--border);">The model is baked into the image, so the container has no network dependency at runtime.</div>
</div>
<div style="border-radius: 14px; border: 1px solid var(--border); overflow: hidden;">
<div style="padding: 12px 18px; border-bottom: 1px solid var(--border); background: var(--panel); display: flex; align-items: center; gap: 10px;">
<span style="font-size: 13px;">🦀</span>
<span style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 15px;">Cargo & Crates.io</span>
</div>
<pre role="region" tabindex="0" aria-label="Cargo installation commands" style="margin: 0; padding: 20px; font-family: 'IBM Plex Mono'; font-size: 13.5px; line-height: 1.85; color: var(--text); background: var(--bg); overflow-x: auto;"><span style="display:block;"><span style="color: var(--good);">$</span> cargo install knowyourbusiness --locked</span><span style="display:block;"><span style="color: var(--good);">$</span> kyb-server</span><span style="display:block;"><span style="color: var(--faint);"># or from source: cargo run --release</span></span></pre>
<div style="padding: 14px 18px; background: var(--bg2); color: var(--muted); font-size: 13.5px; border-top: 1px solid var(--border);">Installs and launches the <code style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--accent);">kyb-server</code> binary. Note: the client CLI and <code style="font-family: 'IBM Plex Mono'; font-size: 12.5px; color: var(--accent);">skills/install.sh</code> require a separate <a href="https://github.com/alex09x/kyb" style="color: var(--muted); text-decoration: underline;">git repository checkout</a>.</div>
</div>
</div>
<div style="margin-top: 16px; border-radius: 14px; border: 1px solid var(--incident-dim); background: linear-gradient(180deg, oklch(0.77 0.13 62 / 0.07), transparent); padding: 22px 26px; display: flex; gap: 18px; align-items: flex-start;">
<span style="color: var(--incident); font-size: 20px; line-height: 1.2;">⚠</span>
<div>
<h3 style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 16px; margin: 0 0 6px;">Two things to know before you expose it</h3>
<p style="margin: 0; color: var(--muted); font-size: 15px; text-wrap: pretty;">Tokens are <strong style="color: var(--text); font-weight: 600;">off by default</strong> — keep port 9310 on a private network. Tokens with read, write and admin roles tell callers apart and name them as the author of their commits; they do not encrypt the traffic, so beyond a trusted network add TLS in front. And run the container as <strong style="color: var(--text); font-weight: 600;">your host uid</strong>: otherwise the git canon ends up root-owned and unreadable by hand, and git-as-truth is the whole point.</p>
</div>
</div>
<div style="margin-top: 16px; border-radius: 14px; border: 1px solid var(--border); background: var(--panel); padding: 22px 24px;">
<div style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 15px; margin-bottom: 14px;">Configuration <span style="color: var(--faint); font-weight: 400; font-family:'IBM Plex Mono'; font-size: 12.5px;">— env, all optional</span></div>
<div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(230px, 1fr)); gap: 10px 24px; font-family: 'IBM Plex Mono'; font-size: 13px;">
<div style="display: flex; justify-content: space-between; gap: 10px; padding: 7px 0; border-bottom: 1px dashed var(--border);"><span style="color: var(--accent);">KYB_DATA</span><span style="color: var(--faint);">./kyb-data</span></div>
<div style="display: flex; justify-content: space-between; gap: 10px; padding: 7px 0; border-bottom: 1px dashed var(--border);"><span style="color: var(--accent);">KYB_INDEX</span><span style="color: var(--faint);">./index</span></div>
<div style="display: flex; justify-content: space-between; gap: 10px; padding: 7px 0; border-bottom: 1px dashed var(--border);"><span style="color: var(--accent);">KYB_ADDR</span><span style="color: var(--faint);">127.0.0.1:9310</span></div>
<div style="display: flex; justify-content: space-between; gap: 10px; padding: 7px 0; border-bottom: 1px dashed var(--border);"><span style="color: var(--accent);">KYB_MODEL</span><span style="color: var(--faint);">dir · absent = lexical</span></div>
<div style="display: flex; justify-content: space-between; gap: 10px; padding: 7px 0; border-bottom: 1px dashed var(--border);"><span style="color: var(--accent);">KYB_AUDIT</span><span style="color: var(--faint);">audit.jsonl</span></div>
<div style="display: flex; justify-content: space-between; gap: 10px; padding: 7px 0; border-bottom: 1px dashed var(--border);"><span style="color: var(--accent);">KYB_SERVER</span><span style="color: var(--faint);">for install.sh</span></div>
<div style="display: flex; justify-content: space-between; gap: 10px; padding: 7px 0; border-bottom: 1px dashed var(--border);"><span style="color: var(--accent);">KYB_AUTH</span><span style="color: var(--faint);">off · compat · required</span></div>
<div style="display: flex; justify-content: space-between; gap: 10px; padding: 7px 0; border-bottom: 1px dashed var(--border);"><span style="color: var(--accent);">KYB_AUTH_FILE</span><span style="color: var(--faint);">./auth.json</span></div>
<div style="display: flex; justify-content: space-between; gap: 10px; padding: 7px 0; border-bottom: 1px dashed var(--border);"><span style="color: var(--accent);">KYB_ANON</span><span style="color: var(--faint);">read · public demo</span></div>
</div>
</div>
<div style="margin-top: 16px; border-radius: 14px; border: 1px solid var(--border); overflow: hidden;">
<div style="padding: 12px 18px; border-bottom: 1px solid var(--border); background: var(--panel);"><span style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 15px;">CLI cheatsheet</span></div>
<pre role="region" tabindex="0" aria-label="KYB command-line examples" style="margin: 0; padding: 22px 24px; font-family: 'IBM Plex Mono'; font-size: 13.5px; line-height: 1.95; color: var(--text); background: var(--bg); overflow-x: auto;"><span style="display:block;"><span style="color: var(--good);">$</span> kyb tags <span style="color: var(--faint);">/</span> kyb health <span style="color: var(--faint);"># the map of the base, and its pulse</span></span><span style="display:block;"><span style="color: var(--good);">$</span> kyb query <span style="color: var(--incident);">"nats streams"</span> --tag infra --history</span><span style="display:block;"><span style="color: var(--good);">$</span> kyb add --key nats-streams --title <span style="color: var(--incident);">"..."</span> --tags nats,infra <<< <span style="color: var(--incident);">"body"</span></span><span style="display:block;"><span style="color: var(--good);">$</span> kyb get nats-streams --at <span style="color: var(--accent);"><sha></span> <span style="color: var(--faint);"># any historical version</span></span><span style="display:block;"><span style="color: var(--good);">$</span> kyb query <span style="color: var(--incident);">"orders api"</span> --as-of 2026-08-01 <span style="color: var(--faint);"># the base as it stood then</span></span><span style="display:block;"><span style="color: var(--good);">$</span> kyb incident --template <span style="color: var(--faint);"># the report skeleton</span></span><span style="display:block;"><span style="color: var(--good);">$</span> kyb incidents --status open --open-followups</span><span style="display:block;"><span style="color: var(--good);">$</span> kyb resolve inc-… <<< <span style="color: var(--incident);">"what fixed it"</span> <span style="color: var(--faint);"># resolution mandatory</span></span><span style="display:block;"><span style="color: var(--good);">$</span> kyb task-status task-… --status <span style="color: var(--violet);">in_progress</span> --assignee agent-a</span><span style="display:block;"><span style="color: var(--good);">$</span> kyb tasks --status blocked --priority critical</span><span style="display:block;"><span style="color: var(--good);">$</span> kyb done task-… <<< <span style="color: var(--incident);">"what came of it"</span></span><span style="display:block;"><span style="color: var(--good);">$</span> kyb whoami <span style="color: var(--faint);"># the agent, session and workspace a write would carry</span></span><span style="display:block;"><span style="color: var(--good);">$</span> echo <span style="color: var(--incident);">"$TOKEN"</span> | kyb login <span style="color: var(--faint);"># when the server asks for tokens</span></span></pre>
</div>
</section>
<!-- ===================== FLEET DEPLOY ===================== -->
<section style="max-width: 1120px; margin: 90px auto 0; padding: 0 28px;">
<div style="font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--accent); letter-spacing: 0.08em; text-transform: uppercase; margin-bottom: 12px;">// Fleet deploy</div>
<h2 style="font-family: 'Space Grotesk'; font-weight: 700; font-size: clamp(28px, 4vw, 40px); letter-spacing: -0.02em; margin: 0 0 12px;">One idempotent command, whole pipeline.</h2>
<p style="font-size: 18px; color: var(--muted); max-width: 62ch; margin: 0 0 30px;">Refuses to run with uncommitted changes, waits for CI green, health-checks the server, then rolls the skill and CLI to every machine. Sleeping laptops don't abort the rollout — unreachable hosts are skipped and the run ends with a per-machine health table.</p>
<div style="border-radius: 18px; border: 1px solid var(--border); background: oklch(0.185 0.014 260 / 0.5); padding: 32px 28px;">
<div style="display: flex; flex-wrap: wrap; align-items: center; justify-content: center; gap: 10px; margin-bottom: 24px;">
<span style="font-family: 'IBM Plex Mono'; font-size: 13px; padding: 10px 16px; border-radius: 10px; background: var(--panel); border: 1px solid var(--border); color: var(--text);">git push</span>
<span style="color: var(--accent); font-family: 'IBM Plex Mono';">→</span>
<span style="font-family: 'IBM Plex Mono'; font-size: 13px; padding: 10px 16px; border-radius: 10px; background: var(--panel); border: 1px solid var(--border); color: var(--text);">CI builds the image</span>
<span style="color: var(--accent); font-family: 'IBM Plex Mono';">→</span>
<span style="font-family: 'IBM Plex Mono'; font-size: 13px; padding: 10px 16px; border-radius: 10px; background: var(--panel); border: 1px solid var(--border); color: var(--text);">server pulls & restarts</span>
<span style="color: var(--accent); font-family: 'IBM Plex Mono';">→</span>
<span style="font-family: 'IBM Plex Mono'; font-size: 13px; padding: 10px 16px; border-radius: 10px; background: var(--panel); border: 1px solid var(--accent-dim); color: var(--text);">skill + CLI to every machine</span>
</div>
<div style="border-radius: 11px; background: var(--bg); border: 1px solid var(--border); padding: 16px 18px; font-family: 'IBM Plex Mono'; font-size: 13.5px; line-height: 1.9; overflow-x: auto;"><div><span style="color: var(--good);">$</span> scripts/deploy.sh <span style="color: var(--faint);"># everything</span></div><div><span style="color: var(--good);">$</span> scripts/deploy.sh --skills <span style="color: var(--faint);"># only roll skills + CLI</span></div></div>
<p style="margin: 18px 0 0; color: var(--muted); font-size: 14.5px; text-wrap: pretty;">Machine-specific config lives <strong style="color: var(--text); font-weight: 600;">outside the repo</strong> in a gitignored <span style="font-family: 'IBM Plex Mono'; font-size: 13px;">fleet.local.sh</span>. Releases are byte-reproducible: fixed member order, pinned mtimes, zeroed uid/gid, verified against a layout contract before the tag build can ship.</p>
</div>
</section>
<!-- ===================== CITATION ===================== -->
<section id="citation" style="max-width: 1120px; margin: 90px auto 0; padding: 0 28px;">
<div style="border-radius: 18px; border: 1px solid var(--border); background: oklch(0.185 0.014 260 / 0.5); padding: clamp(24px, 4vw, 40px) clamp(16px, 3.5vw, 34px);">
<div style="font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--accent); letter-spacing: 0.08em; text-transform: uppercase; margin-bottom: 12px;">// Citation & Attribution</div>
<h2 style="font-family: 'Space Grotesk'; font-weight: 700; font-size: clamp(26px, 3.6vw, 36px); letter-spacing: -0.02em; margin: 0 0 12px;">Citing KYB.</h2>
<p style="font-size: 17px; color: var(--muted); max-width: 64ch; margin: 0 0 22px; text-wrap: pretty;">
KYB is authored by <a href="https://prod.codes/about/" style="color: var(--accent); text-decoration: underline; font-weight: 600;">Alexander Panasenko</a>. If you use KYB in academic, archival, or technical research, cite the software via Zenodo:
</p>
<div style="display: flex; flex-wrap: wrap; gap: 12px; margin-bottom: 22px;">
<a href="https://doi.org/10.5281/zenodo.23309457" style="display: inline-flex; flex-wrap: wrap; align-items: center; gap: 4px 8px; max-width: 100%; box-sizing: border-box; padding: 8px 14px; border-radius: 8px; background: var(--bg); border: 1px solid var(--border); font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--accent); word-break: break-word;">
<span style="color: var(--faint); white-space: nowrap;">v0.3.0 DOI:</span> <span style="word-break: break-all; overflow-wrap: anywhere;">10.5281/zenodo.23309457</span>
</a>
<a href="https://doi.org/10.5281/zenodo.22850723" style="display: inline-flex; flex-wrap: wrap; align-items: center; gap: 4px 8px; max-width: 100%; box-sizing: border-box; padding: 8px 14px; border-radius: 8px; background: var(--bg); border: 1px solid var(--border); font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--muted); word-break: break-word;">
<span style="color: var(--faint); white-space: nowrap;">Concept DOI:</span> <span style="word-break: break-all; overflow-wrap: anywhere;">10.5281/zenodo.22850723</span>
</a>
<a href="https://prod.codes/about/" style="display: inline-flex; align-items: center; gap: 8px; max-width: 100%; box-sizing: border-box; padding: 8px 14px; border-radius: 8px; background: var(--bg); border: 1px solid var(--border); font-family: 'IBM Plex Mono'; font-size: 13px; color: var(--text);">
<span>Author Profile ↗</span>
</a>
</div>
<pre role="region" tabindex="0" aria-label="BibTeX citation" style="margin: 0; padding: 20px 22px; font-family: 'IBM Plex Mono'; font-size: 13px; line-height: 1.8; color: var(--text); background: var(--bg); border: 1px solid var(--border); border-radius: 12px; overflow-x: auto;">@misc{panasenko2026kyb,
doi = {10.5281/zenodo.23309457},
url = {https://zenodo.org/records/23309457},
author = {Panasenko, Alexander},
title = {KYB (Know Your Business): Git-backed knowledge base and incident tracker for AI agents},
version = {0.3.0},
publisher = {Zenodo},
year = {2026}
}</pre>
</div>
</section>
<!-- ===================== FINAL CTA ===================== -->
<section style="max-width: 1120px; margin: 96px auto 0; padding: 0 28px;">
<div style="border-radius: 22px; border: 1px solid var(--border); background: radial-gradient(ellipse at 50% -10%, oklch(0.76 0.132 196 / 0.16), var(--panel) 62%); padding: 64px 34px; text-align: center;">
<div style="width: 54px; height: 54px; border-radius: 14px; background: linear-gradient(140deg, var(--accent), var(--accent-dim)); display: grid; place-items: center; font-family: 'Space Grotesk'; font-weight: 700; font-size: 26px; color: oklch(0.15 0.01 260); margin: 0 auto 22px; box-shadow: 0 12px 40px -10px oklch(0.76 0.132 196 / 0.6);">K</div>
<h2 style="font-family: 'Space Grotesk'; font-weight: 700; font-size: clamp(28px, 4.4vw, 44px); letter-spacing: -0.025em; margin: 0 0 14px; text-wrap: balance;">Give your agents a memory.</h2>
<p style="font-size: 18px; color: var(--muted); max-width: 52ch; margin: 0 auto 30px;">One command to run it, one to wire every agent on every machine into the same operational truth.</p>
<div style="display: flex; flex-wrap: wrap; gap: 12px; justify-content: center;">
<a href="https://github.com/alex09x/kyb" style="display: inline-flex; align-items: center; gap: 9px; padding: 14px 26px; border-radius: 12px; background: var(--accent); color: oklch(0.15 0.01 260); font-weight: 700; font-size: 15px;" data-hover="4"><span style="color: oklch(0.15 0.01 260);">★</span> Star on GitHub</a>
<a href="#install" style="display: inline-flex; align-items: center; gap: 9px; padding: 14px 26px; border-radius: 12px; background: var(--bg); border: 1px solid var(--border); color: var(--text); font-weight: 600; font-size: 15px;" data-hover="5">Install</a>
<a href="#api" style="display: inline-flex; align-items: center; gap: 9px; padding: 14px 26px; border-radius: 12px; color: var(--muted); font-weight: 600; font-size: 15px;" data-hover="6">Read the docs →</a>
</div>
</div>
</section>
</main>
<!-- ===================== FOOTER ===================== -->
<footer style="max-width: 1120px; margin: 60px auto 0; padding: 34px 28px 60px; border-top: 1px solid var(--border); display: flex; flex-wrap: wrap; gap: 20px; align-items: center;">
<div style="display: flex; align-items: center; gap: 10px;">
<span style="width: 26px; height: 26px; border-radius: 7px; background: linear-gradient(140deg, var(--accent), var(--accent-dim)); display: grid; place-items: center; font-family: 'Space Grotesk'; font-weight: 700; font-size: 13px; color: oklch(0.15 0.01 260);">K</span>
<span style="font-family: 'Space Grotesk'; font-weight: 600; font-size: 15px;">KYB — Know Your Business</span>
</div>
<div style="flex: 1;"></div>
<div style="display: flex; flex-wrap: wrap; gap: 22px; font-family: 'IBM Plex Mono'; font-size: 13px; align-items: center;">
<a href="https://kybmemory.com" style="color: var(--accent);">kybmemory.com</a>
<a href="https://github.com/alex09x/kyb" style="color: var(--muted);">GitHub</a>
<a href="/blog/" style="color: var(--muted);">Blog</a>
<a href="#mcp" style="color: var(--muted);">MCP</a>
<a href="#attribution" style="color: var(--muted);">Who</a>
<a href="#api" style="color: var(--muted);">API</a>
<a href="#install" style="color: var(--muted);">Install</a>
<a href="#citation" style="color: var(--muted);">Cite</a>
<span style="color: var(--faint);">By <a href="https://prod.codes/about/" style="color: var(--muted); text-decoration: underline;">Alexander Panasenko</a> · MIT © 2026</span>
</div>
</footer>
</div>
</body>
</html>