kglite-cli
The interactive Cypher shell for kglite
knowledge graphs — the sqlite3-style REPL for .kgl files.
Install
$ pip install kglite # Python API plus the `kglite` command
# or
$ pip install kglite-cli # standalone CLI-only binary wheel
# or
$ cargo install kglite-cli # standalone build (needs a Rust toolchain)
The main kglite wheel embeds this crate's Rust library and exposes the same
command through a thin console-script shim. kglite-cli remains the standalone
libpython-free binary distribution; install one route or the other.
The code-review Agent Skill is installed by codingest, which also builds the code graphs the skill queries:
$ codingest skill install
Use
Run one query and exit:
$ kglite query app.kgl "MATCH (n:Person) RETURN n.name AS name" --format json
[
{
"name": "Alice"
}
]
Run a scoped write and persist it:
$ kglite write app.kgl "CREATE (:Task {id:'t1', status:'todo'})" \
--save --write-scope Task --git-sha abc123 --modified-by agent
Inspect a dependency frontier:
$ kglite ready-set app.kgl --done 'n.status = "done"' --node-type Task --format csv
Ask for the agent-oriented graph description:
$ kglite describe app.kgl
$ kglite describe app.kgl --types Task
$ kglite describe app.kgl --cypher
Build a code-review graph without Python or MCP configuration:
# Code-graph builds live in the codingest project's CLI:
$ codingest build . --output .kglite/code-review.kgl
$ codingest status --output .kglite/code-review.kgl
The adjacent metadata sidecar records the source and revision fingerprint so
status can detect a stale working-tree artifact or a revision label that
moved.
Keep one graph loaded for an agent loop:
$ kglite session app.kgl --format json
{"op":"describe","types":["Task"]}
{"id":"w1","op":"write","query":"CREATE (:Task {id:'t1', status:'todo'})"}
{"id":"q1","op":"query","query":"MATCH (t:Task) RETURN count(t) AS n","format":"json"}
{"op":"save"}
{"op":"exit"}
Session JSON responses echo id when provided. JSON-mode query/write
responses return typed rows; table/csv modes return rendered output.
For describe, the compact forms still work ("connections":true,
"connections":["KNOWS"]), and agents can use explicit object forms:
"connections":{"detail":"overview"} or "connections":{"types":["KNOWS"]}.
Or open the interactive shell:
$ kglite app.kgl
kglite shell — app.kgl
Type .help for commands, .quit to exit.
kglite> MATCH (n:Person) RETURN n.name AS name LIMIT 3;
name
----
Alice
Bob
Carol
(3 rows)
kglite> .quit
Run with no path for a scratch in-memory graph ($ kglite). Pure-Rust single
binary over kglite::api::* — no Python, no server.
A Cypher statement runs when terminated by ;, so it can span multiple lines;
dot-commands run on Enter. Tab completes dot-commands and the graph's labels.
Piped input (kglite app.kgl < script.cypher) additionally runs a balanced
trailing statement at end of input and before a dot-command line, so a script
whose last statement has no ; still runs; an unbalanced tail is reported on
stderr with a non-zero exit. Table cells are width-capped only on a terminal.
Commands
Non-interactive commands:
query <graph.kgl> <cypher> [--format table|csv|json]— run a read-only Cypher querywrite <graph.kgl> <cypher> [--format table|csv|json] [--save]— run a write-capable Cypher statementwrite --write-scope A,B --git-sha <sha> --modified-by <actor>— restrict writes and stamp provenance onauto_timestamptypesready-set <graph.kgl> --done <predicate> [--relationship DEPENDS_ON] [--node-type T]— printCALL ready_set(...)describe <graph.kgl> [--types T] [--cypher] [--connections]— print the XMLdescribe()document for agents, including<skills>and<recipes>indexes when the graph carries themskill <graph.kgl> [name] [--format table|csv|json]— list the skills the graph carries (sorted,--formathonoured), or print one body raw on stdout. Read-only, no writer lease. Exits non-zero when the named skill is absent; a graph with no skills lists zero rows and exits 0. Skills and recipe queries are written from Python (set_skill/set_recipe), not hereokf check <dir> [--dialect obsidian|okf|loose] [--strict] [--json]— check a vault directory against theVAULT.mdformat and print the build report (counts, then errors, then warnings). Exits non-zero on any error;--strictcounts warnings too. Runs the same read the build runs, so it reports what a build doesokf build <dir> -o <graph.kgl> [--dialect obsidian]— build a vault into a.kgl; the report goes to stderr, stdout names the file writtenokf status <dir> [--graph <graph.kgl>] [--dialect obsidian]— print the vault's fingerprint (astatpass; no note is read). With--graph, compare it against the one stamped in the.kglat build time:currentexits 0,staleexits non-zero. Keep the.kgloutside the vault — a file inside it is part of what the fingerprint coversokf export <graph.kgl> <dir> [--force] [--source-root <dir>]— write a.kglback out as a vault. Only files a previous export wrote are replaced or removed; anything else is refused, named on stderr and exits non-zero (--forcelifts that).--source-rootnames the directory the graph's attachments were read from, so their bytes are copied too; omitted, the graph's own recorded source root stands insession <graph.kgl>— process JSONL requests against one in-memory graph (query,write,describe,save,help,exit);{"op":"help"}returns the op tableexport-text <graph.kgl>— print the deterministic text projection used by git textconvdiff <a.kgl> <b.kgl>— compare two graph text projections
Interactive dot-commands:
.help— list commands.quit/.exit— leave the shell.labels/.rels/.schema/.indexes— schema introspection.mode table|csv|json— set the output format.import <file.csv> <NodeType> [--id <col>] [--title <col>]— load a CSV as nodes.dump <dir>— export a portable CSV +blueprint.jsoncopy (reload withkglite.from_blueprint(...)).read <file>— run the Cypher statements in a file.save [path]— write the graph to a.kglfile.timing on|off— show query wall-time after each statement
Anything else is executed as Cypher. Ctrl-C cancels a running query; Ctrl-D exits.
1 maintainer
Metadata
1 maintainer
Release files for kglite-cli 0.20.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| kglite_cli-0.20.0-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| kglite_cli-0.20.0-py3-none-musllinux_1_2_x86_64.whl | Python 3 | none | Linux musl 1.2+ x86-64 | Details |
| kglite_cli-0.20.0-py3-none-musllinux_1_2_aarch64.whl | Python 3 | none | Linux musl 1.2+ ARM64 | Details |
| kglite_cli-0.20.0-py3-none-manylinux_2_28_aarch64.whl | Python 3 | none | Linux glibc 2.28+ ARM64 | Details |
| kglite_cli-0.20.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details |
| kglite_cli-0.20.0-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
| kglite_cli-0.20.0-py3-none-macosx_10_12_x86_64.whl | Python 3 | none | macOS 10.12+ x86-64 | Details |
Total release size: 56.5 MB
Release files / kglite_cli-0.20.0-py3-none-win_amd64.whl
| Download URL | kglite_cli-0.20.0-py3-none-win_amd64.whl |
|---|---|
| Size | 8.5 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
c65f523cf48e012250c7947149c4ac93fa639a33b2c4ba2fd53f077610d51057
|
|
BLAKE2b-256 checksum How to use checksums |
4efd947b75d4810b8673eb005e10e0fb6460d06ba4d9b79eee76ac2031e97db1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / kglite_cli-0.20.0-py3-none-musllinux_1_2_x86_64.whl
| Download URL | kglite_cli-0.20.0-py3-none-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 8.6 MB |
| Tags | Linux musl 1.2+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
55864c7621475469b5f0c4efe9d5a0522309ff3a16cb4b7d2763aedfb75d14b0
|
|
BLAKE2b-256 checksum How to use checksums |
70701cf5ae46baafab7e8095e084847db6c06413fb77d034222df2303eab3b93
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / kglite_cli-0.20.0-py3-none-musllinux_1_2_aarch64.whl
| Download URL | kglite_cli-0.20.0-py3-none-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 7.7 MB |
| Tags | Linux musl 1.2+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
21d303cd27c0e54e058f3d1fe3a697636d13359c5e81c231f75fe1eec33774fc
|
|
BLAKE2b-256 checksum How to use checksums |
41f1f6c51ee468d1ccff58b3ab074564ceee0bc4f8b342ce7d27d648ea562182
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / kglite_cli-0.20.0-py3-none-manylinux_2_28_aarch64.whl
| Download URL | kglite_cli-0.20.0-py3-none-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 7.7 MB |
| Tags | Linux glibc 2.28+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
7708b8dbc17683387ca4eadefb843be6383ef6b8ebe3ee0433be1486e24b9988
|
|
BLAKE2b-256 checksum How to use checksums |
20926a5e890075b403b865635de24d49374a2171ad1e01f5dc662d6d4465e0b1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / kglite_cli-0.20.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | kglite_cli-0.20.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 8.4 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
8b0a402cec2518260e21314ded167def90b0106aec8d531eea9dfc48a210c0fa
|
|
BLAKE2b-256 checksum How to use checksums |
487cf2f8422d8cd6e625024e8148f324e1308d2c80699577a90f1c199bcc27ac
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / kglite_cli-0.20.0-py3-none-macosx_11_0_arm64.whl
| Download URL | kglite_cli-0.20.0-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 7.5 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
4b9fc6e321d83fa7ad918056872f8c0a038e0a6218a6460b91b44b61233f42d9
|
|
BLAKE2b-256 checksum How to use checksums |
e4fba22b2eb098f706a4029bf8d1be674d8a7b0a173f8730f6769a844d1cbe3f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / kglite_cli-0.20.0-py3-none-macosx_10_12_x86_64.whl
| Download URL | kglite_cli-0.20.0-py3-none-macosx_10_12_x86_64.whl |
|---|---|
| Size | 8.2 MB |
| Tags | Python 3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
bbb688be7dfff15e9cf920bfc8aff8c284eb53747dd80e3e5bfb25808607bcab
|
|
BLAKE2b-256 checksum How to use checksums |
ffe333c59d451f9135a22150a3967b0c28bf119880a8ac69226b464ad48be1ec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency log
