schist 0.2.0

Agent-first knowledge graph: git is truth, SQLite is query, humans just watch

schist

Agent-first knowledge graph. Git is truth, SQLite is query, humans just watch.

schist is a generic, domain-agnostic knowledge graph where AI agents are the primary writers. Content is markdown + YAML frontmatter, version-controlled in git. SQLite provides the query layer. A static web viewer (D3.js + lunr.js) gives humans a read-only visualization.

Installation

pip install schist

This installs the schist CLI and the schist-ingest console script (used by the git post-commit hook).

Quick Start

# Create a vault
mkdir -p ~/vaults/research/{notes,papers,concepts,.schist}

# Add your first note
schist add --vault ~/vaults/research \
  --title "First Note" \
  --tags getting-started \
  --body "Hello, knowledge graph."

# Search it
schist search --vault ~/vaults/research "knowledge"

# Get graph context (useful for agent session start)
schist context --vault ~/vaults/research

CLI Commands

Command	Description
schist add	Create a new note
schist link	Add a connection between nodes
schist search	Full-text search
schist query	Raw SQL query
schist build	Generate static viewer data
schist context	Dump session context
schist schema	Print or validate schema

MCP Server

The schist MCP server (@schist/mcp-server) is published separately on npm:

npm install -g @schist/mcp-server

Register it as a user-scope MCP server:

schist --vault /absolute/path/to/vault init --print-mcp-config --format claude --identity local
# then run the printed `claude mcp add ...` line

Claude Code stores user-scope MCP servers in ~/.claude.json (managed by the CLI). On older Claude Code CLIs without mcp add, --print-mcp-config also emits a commented JSON fallback — uncomment the block and hand-merge it under the top-level mcpServers key in ~/.claude.json. Claude Desktop uses ~/Library/Application Support/Claude/claude_desktop_config.json instead; the JSON shape is the same.

See the full README for architecture docs, hub & spoke setup, and MCP tool reference.

License

MIT