Skip to main content

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)

Source distribution for mindslice-tui 0.1.0
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)

Table of built distributions (wheels) for mindslice-tui 0.1.0
File Interpreter ABI Platform Actions
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 log

Release 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 log

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

Select from 2 files

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

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

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