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.1

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.1
File Size Uploaded Provenance Actions
schist-0.3.1.tar.gz 539.8 kB With provenance Details for schist-0.3.1.tar.gz

Built distribution (wheel)

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

Total release size: 828.2 kB

Release files / schist-0.3.1.tar.gz

Download URL schist-0.3.1.tar.gz
Size 539.8 kB
Tags Source
SHA-256 checksum
How to use checksums
f13a56fe2dcbb2815174a81dfe4ca5254e625bad26bd603e45436378da4cf98c
BLAKE2b-256 checksum
How to use checksums
2b1b82fb1a390a21ef2f63daed87618d08ce8ea52804096c191607857c96d04d
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 3, 2026.

Transparency log

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

Download URL schist-0.3.1-py3-none-any.whl
Size 288.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6864a67a8500961fbc30363159cd36bcce79023f23ccfd9fe65812b36d875af3
BLAKE2b-256 checksum
How to use checksums
2045240e2b7ded73fc20ee739b90ada1902ba6c14e3083ae8128c81bc3f34862
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 3, 2026.

Transparency log

Security for schist 0.3.1

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.1.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 3, 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