Optional local web UI for the Cairn harness — a zero-build static app served by `cairn serve`.
Project description
cairn-web
The optional local web UI for the Cairn harness — a zero-build,
dependency-free single-page app (vanilla JS, no npm, no node_modules). It is
served by cairn serve and talks to the local HTTP API.
Remember: the harness's primary face is the MCP server (Claude Code / Codex).
This UI is the "see-and-touch" companion for people who want to browse, read,
edit .uni documents, view images/PDFs, manage tags, and search — without a
terminal.
Use
pip install cairn-cli cairn-web
cairn --workspace ~/Documents/notes serve
# open http://127.0.0.1:4177/
serve auto-detects the installed cairn-web package. To point at a custom
build instead: cairn serve --web-dir ./my-ui.
What it does
- File tree with lazy-expanding folders and tag badges
- Edit
.unidocuments (rich HTML) and plain-text files; Save writes back - View images and PDFs inline (
/raw) - Add/edit tags per document
- Semantic search box (uses
/api/retrieve) and a Reindex button - New file / new folder / rename / delete
Everything is a call to the cairn serve API over localhost — nothing
leaves your machine, and there's no build step to run.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cairn_web-0.2.0.tar.gz.
File metadata
- Download URL: cairn_web-0.2.0.tar.gz
- Upload date:
- Size: 5.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
840e3923a6b80805074df8c701a9cd92392230ffa302f4633022b23b9ad5abf8
|
|
| MD5 |
0a0da40de45229068e91bececf494860
|
|
| BLAKE2b-256 |
814edcfe57ba765f00b62b91749d869c2d2fa72902274a4226cf63377cbc3fbc
|
File details
Details for the file cairn_web-0.2.0-py3-none-any.whl.
File metadata
- Download URL: cairn_web-0.2.0-py3-none-any.whl
- Upload date:
- Size: 6.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8054ea473a6c5e668a787e80f50b6055fff496142c44a42edf625a82f1b45f42
|
|
| MD5 |
0783b303710387c24493bf80b26258ae
|
|
| BLAKE2b-256 |
d12c255e3cc67e5e7feed467d684d83d4d82e878744090a1c3c9ba7a17a8657f
|
