Skip to main content

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 Build the static viewer site (graph.json, search-index.json, index.html)
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

Apache-2.0, except the hub and server modules (hub_admin, hub_keys, hub_shell, pre_receive, viewer/serve, viewer/agent, viewer/proposals), which are AGPL-3.0-or-later. Each code file names its license in an SPDX header. Copyright (c) 2026 Yibei Chen. Code published before this change, including version 0.2.0, remains available under the MIT License.

Metadata

Release files for schist 0.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for schist 0.3.2
File Size Uploaded Provenance Actions
schist-0.3.2.tar.gz 541.2 kB With provenance Details for schist-0.3.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for schist 0.3.2
File Interpreter ABI Platform Actions
schist-0.3.2-py3-none-any.whl Python 3 none any Details for schist-0.3.2-py3-none-any.whl

Total release size: 830.9 kB

Release files / schist-0.3.2.tar.gz

Download URL schist-0.3.2.tar.gz
Size 541.2 kB
Tags Source
SHA-256 checksum
How to use checksums
a543691d0e061248b045fb8f9de4d675736f0ad9d597a1a19e06a0251b44c3ea
BLAKE2b-256 checksum
How to use checksums
ad7c2abf7593e1a99f5dea4951da2c215abc142cd5dcdf6c3033a6f13a750598
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.

Transparency log

Release files / schist-0.3.2-py3-none-any.whl

Download URL schist-0.3.2-py3-none-any.whl
Size 289.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3e6dd50ed2e6a08f1a1ed0dc92d4e97bb82907e62f68ab984556953f76feef2c
BLAKE2b-256 checksum
How to use checksums
778c8a3a84c32b34cb28fdfd20a51c4de6937f74ee28c51c0155f462a94736f0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.

Transparency log

Security for schist 0.3.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for schist-0.3.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page