gosha70/wiki-studio

PyPI ·
Changelog
Karpathy-pattern LLM wiki maintainer: a curated markdown knowledge base
(index.md, log.md, typed pages with cited sources) that agents ingest
into, query from and lint. Standard library only; the LLM backends are
copilot CLIs the tool shells out to.
The code was extracted from
gosha70/code-copilot-team
(see NOTICE); the page schema is shared with
memkernel's wiki bridge.
## Install
bash
pip install wiki-studio # Python 3.11–3.13, no runtime dependencies
pip install 'wiki-studio[mcp]' # optional: the MCP server, wiki-studio-mcp (see MCP)
wiki-studio --help
wiki-studio --version # 0.8.1
From a checkout: poetry install, then poetry run wiki-studio --help.
The standalone quickstart goes from an empty directory
to a reviewed, approved page with no model backend; its executed blocks run
in the quickstart CI job. The
memkernel composition quickstart puts the same
wiki behind memkernel: retain, a gated export, a reviewed correction, a
governed import and a handoff clone, with executed blocks in the
quickstart-memkernel CI job.
## Layout
With no flags and no variables wiki-studio reproduces the original
code-copilot-team layout under the git toplevel of the current directory:
| Location | Default | Flag | Variable |
| root (confines sources and proposals; anchors path: citations) | git toplevel of the current directory, else the current directory | --root | WIKISTUDIOROOT |
| wiki directory | /knowledge/wiki | --wiki-dir | WIKISTUDIOWIKIDIR |
| proposals directory | /docinternal/proposals | --proposals-dir | WIKISTUDIOPROPOSALSDIR |
| allowed source roots (directories outside the root that local links in pages may reference) | none | --source-root (repeatable) | WIKISTUDIOSOURCEROOTS (os.pathsep-separated) |
| query log | /docinternal/wiki-query-log.jsonl | | |
| ingest audit log | /.audit/ingest-log.md | | |
| schema override | /schema/ (used when present) | | |
| wiki lock | /. .wiki-studio.lock | | |
| search cache (the fts5 ranker's index; must lie outside the wiki) | /. .wiki-studio.search.sqlite | --search-cache | WIKISTUDIOSEARCHCACHE |
Flags beat variables, variables beat defaults. The three flags are accepted
before or after the verb. Relative flag and variable values are taken from
the current directory. A --search-cache or WIKISTUDIOSEARCHCACHE path
inside the wiki directory is refused (exit 1).
The lock and the search cache sit beside the wiki directory, never inside it.
Where the wiki lives in a git checkout, one .gitignore pattern covers both:
gitignore
. .wiki-studio.
(.wiki.wiki-studio. for the default knowledge/wiki.) The search cache is
derived data: find and query with --ranker fts5 refresh it from the
pages on every call (each eligible page is read and hashed, no timestamp
shortcut), rebuild it when it was built for another wiki, format or ranker
configuration, and remove and rebuild it when it is corrupt. When it cannot
be used safely (a symlink at the path or its directory, a directory that is
not writable, a read-only file system, another process holding it past five
seconds) that call ranks with an in-memory index, prints one warning and
still exits 0. The cache only ranks; the text a prompt carries is always read