# Kindex

> The memory layer AI coding agents do not have. A persistent knowledge graph for AI-assisted workflows, distributed as an MCP server and standalone CLI. Indexes conversations, projects, and intellectual work so Claude Code, Codex, and other MCP-capable agents never start a session blind.

Kindex is a weighted knowledge graph (SQLite + FTS5 + graph traversal) that captures not just what happened but what it means and how it connects. It ships as a free MCP plugin for Claude Code, Codex, and other agents or a standalone `kin` CLI on PyPI.

## What Kindex is

- **MCP server**: `kin-mcp` exposes tools to Claude Code, Codex, and other MCP clients (search, add, context, show, ask, learn, link, list_nodes, status, suggest, graph_stats, graph_merge, dream, changelog, ingest, tag_start, tag_update, tag_resume, task_add, task_done, task_list, watch_add, watch_list, watch_resolve, remind_create, remind_list, remind_snooze, remind_done, remind_check, remind_exec, mode_activate, mode_list, mode_show, mode_create, mode_export, mode_import, mode_seed).
- **CLI**: 59 `kin` subcommands for scripts, cron, and humans.
- **Transport**: stdio (local). Package: `pip install kindex[mcp]`.
- **Version**: 0.19.0. License: MIT. Repo: https://github.com/jmcentire/kindex.
- **Codex setup**: `kin setup-codex-mcp` and `kin setup-agents-md --install --global`.
- **Codex session ingest**: `kin ingest codex-sessions`.
- **Project context**: `.kin/config` and `.kin/index.json` are intended to ship with the repo. Local/private runtime state belongs in `~/.kindex` or ignored `.kin/local`, `.kin/cache`, `.kin/tmp`, `.kin/private`.
- **Work policy**: `kin policy check` reads opt-in policy from `.kin/config`. Linear enforcement only applies when `work_policy.linear.enabled: true`.

## Key capabilities

- Hybrid retrieval: FTS5 BM25 + graph BFS + optional vectors, merged via Reciprocal Rank Fusion.
- Five context tiers (full / abridged / summarized / executive / index) auto-selected by token budget — your plugin does not eat the context window.
- Node types for operational guardrails: `constraint` (blocks deploys), `directive` (soft rules), `watch` (attention flags), `checkpoint` (pre-flight).
- Session tags track named work context across conversations. `tag start` / `tag update` / `tag segment` / `tag resume` / `tag end`.
- Reminders with actionable shell commands or headless `claude -p` invocations.
- Dream cycle: post-session consolidation (fuzzy dedup, suggestion auto-apply, edge strengthening).
- `.kin/` inheritance chains: repo inherits from team, team inherits from org voice; repo-local policy can require active tags, Linear IDs, or git hook gates.

## Links

- Homepage: https://kindex.tools
- Source: https://github.com/jmcentire/kindex
- PyPI: https://pypi.org/project/kindex/
- MCP server card: https://kindex.tools/.well-known/mcp/server-card.json
- Agent skills: https://kindex.tools/.well-known/agent-skills/index.json
- Full docs (this site, expanded): https://kindex.tools/llms-full.txt
- Privacy: https://kindex.tools/privacy/