# khive

A research knowledge graph runtime for agents that need structure: typed substrates,
closed taxonomies, and a verb-consolidated MCP surface.

Vector search finds similar text. A knowledge graph finds structure: lineages,
dependencies, contradictions, gaps. khive gives an agent a typed, queryable graph that
grows as it works.

[crates.io](https://crates.io/crates/khive-mcp) ·
[GitHub](https://github.com/ohdearquant/khive) ·
[License: Apache 2.0](https://github.com/ohdearquant/khive/blob/main/LICENSE)

## For AI agents

- [`/llms.txt`](llms.txt): short project summary + a linked index of every doc page
- [`/llms-full.txt`](llms-full.txt): every doc page, concatenated, in one fetch
- [`/md/*.md`](md/getting-started.md): raw, unconverted markdown for each page (also
  linked from the bottom of every page)

## Documentation

- [Getting Started](getting-started.html): install, connect, first session
- [Knowledge Graph Modeling](knowledge-graph.html): entity kinds, edge relations, modeling patterns
- [Memory and Recall](memory.html): episodic vs semantic, salience, decay
- [Search and Retrieval](search.html): FTS, vector, hybrid fusion, reranking
- [GTD Task Management](tasks.html): task lifecycle, priorities, dependencies
- [Prompt Cookbook](prompt-cookbook.html): ready-to-use verb patterns
- [API Reference](api-reference.html): full verb catalog, params, DSL examples

## Demos

Runnable transcripts, captured against a scratch database, in the repo's
[`demos/`](https://github.com/ohdearquant/khive/tree/main/demos) directory:

- [research-ingest](https://github.com/ohdearquant/khive/blob/main/demos/research-ingest.md): create entities, link them, search, and traverse the graph
- [gtd-memory](https://github.com/ohdearquant/khive/blob/main/demos/gtd-memory.md): task lifecycle and salience-weighted memory recall

## Install

```bash
cargo install kkernel
```

`kkernel` is the single shipped binary; `kkernel mcp` serves the MCP `request` surface.
Full install and MCP client setup: [Getting Started](getting-started.html).

## Reference

- [AGENTS.md](https://github.com/ohdearquant/khive/blob/main/AGENTS.md): full verb reference for agents using khive
- [Architecture Decision Records](https://github.com/ohdearquant/khive/tree/main/docs/adr): the design contract