MindSlice-tui
English | 中文
A read-only terminal UI for a MindSlice workspace: browse cards, slices and the relations between cards.
┌ Slices ──────┬ Card ───────────────────┬ Relations ───────────┐
│ ▼ @overlay 27│ MindSlice engine repo │ → links out (10) │
│ ▼ projects │ @overlay/projects/ │ architecture ... │
│ ▼ mindslice│ mindslice │ ← backlinks (7) │
│ ▼ prefs │ tags: mindslice project │ ↑ extends (0) │
│ coding ★ │ ─────────────────────── │ ↓ extended by (0) │
│ │ MindSlice (github.com/ │ ⇒ supersedes (0) │
│ │ pancerZH/MindSlice ...) │ ⇐ superseded by (0) │
│ │ │ ≡ same path (0) │
│ │ │ ✗ dangling (0) │
│ │ │ ──────────────────── │
│ │ │ title and summary of │
│ │ │ the selected card │
└──────────────┴─────────────────────────┴──────────────────────┘
Install
With Python 3.12+ and pipx (or uv) installed:
pipx install mindslice-tui # or: uv tool install mindslice-tui
The MindSlice engine comes with it as a dependency.
Run
mindslice-tui -w ~/mindslice
The workspace is found the same way the mindslice command finds it: -w, otherwise $MINDSLICE_WORKSPACE, otherwise the nearest parent directory that contains mounts.toml.
Keys
| Key | Action |
|---|---|
↑ ↓ |
Move in the tree on the left; the card and its relations follow |
tab |
Switch between the three panes |
enter |
In the relations pane, jump to the selected card. While the cursor rests on a neighbour, its title and summary are previewed under the list. Links in the card body can be clicked with the mouse |
backspace |
Go back to the card you jumped from |
/ |
Full-text search (the engine's BM25; a superseded card leads to its replacement) |
g |
Neighbour tree: open the neighbours of the current card level by level (space opens a node, enter jumps) |
o |
Overview: status and pending review, issues, change history, always-loaded cards. The full text of the selected row is shown under each table; enter jumps to that row's card |
h |
Change history of the current card |
r |
Reload the workspace |
l |
Switch the interface language (English / 中文) |
q |
Quit |
Markers in the tree: ★ an always-loaded card (load = "always"), ! the card has parse problems, ≡ the card is shadowed by a card at the same path in a higher-precedence mount; a dimmed, struck-out name means the card has been superseded.
If a reload with r fails (for example while mounts.toml is half written), the UI keeps what it was showing and reports the error.
The interface starts in English; --lang zh starts it in Chinese. Only the interface's own text is translated: card content and the engine's messages are shown as they are.
Read-only
The UI calls no write operation (write, apply, discard, mount, bake and so on), and it does not call Workspace.read(), which would count a read.
Like every other read command of mindslice, it lets the engine sync the rebuildable cache .cache/index.sqlite when files have changed,
and recover first if an unfinished journal exists. Cards, staging, history and the mount table are never modified (the tests assert this).
Every engine call lives in mindslice_tui/store.py. ws.index and ws._reading() used there are engine internals;
once the engine offers a public graph query API, only that file needs to change.
Development
git clone https://github.com/pancerZH/MindSlice-tui.git && cd MindSlice-tui
uv sync
uv run mindslice-tui -w ~/mindslice
uv run python -m unittest discover -s tests -t .
Metadata
Release files for mindslice-tui 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mindslice_tui-0.1.0.tar.gz | 25.0 kB | With provenance | Details for mindslice_tui-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mindslice_tui-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for mindslice_tui-0.1.0-py3-none-any.whl |
Total release size: 47.8 kB
Release files / mindslice_tui-0.1.0.tar.gz
| Download URL | mindslice_tui-0.1.0.tar.gz |
|---|---|
| Size | 25.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
93851e00843a1e764b02051b6280a1bbcc1ee7057869b2eb107f2f9747587f1b
|
|
BLAKE2b-256 checksum How to use checksums |
cf27eeda891f78495293dffe512cfb682bd31633f3633a421f0ac33f38207e72
|
| 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 15, 2026.
Transparency logRelease files / mindslice_tui-0.1.0-py3-none-any.whl
| Download URL | mindslice_tui-0.1.0-py3-none-any.whl |
|---|---|
| Size | 22.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9fa91ae7b52c800e308ef138259e9b8f163cfd2c6cd6bc332bbcb2c80325eaba
|
|
BLAKE2b-256 checksum How to use checksums |
a8ae036110f9ceee2fff97f823a925c5604824fa6f9740e32409d08abac0ccdb
|
| 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 15, 2026.
Transparency logSecurity for mindslice-tui 0.1.0
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.
Attestation for mindslice_tui-0.1.0.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 15, 2026.
Transparency logA 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.