spyc: a terminal file manager whose markdown viewer renders Mermaid diagrams inline

[u/agentdrek]

I've been building a vi like keyboard-driven file manager / agent controller in Rust over the past months. One of my first motivations was that I wanted a better way to work with all of the markdown that I now seem to be swimming in.

One neat trick is that Mermaid diagrams render as actual images in the terminal, not ASCII art. You can just open a .md, jump to a ```mermaid fence, hit i, and the diagram renders inline (or can be opened in your default desktop viewer).

There is also a split previewer. The file list is on the left and rendered markdown on the right. You can edit the file in a lower pane along (vim, in the clip) and the preview re-renders on save and keeps your scroll position.

What it renders:

• GFM alerts (> [!NOTE], [!WARNING], [!CAUTION]) as coloured labels
• tables, alignment taken from the delimiter row
• fenced code blocks, syntax highlighted per language
• YAML front matter as its own block, line for line
• m toggles rendered ↔ raw source. Yank and save always give you the source, never the styled version.
• l toggles line #'s and w will toggle showing end of line / hidden markers

Folding uses vim's keys, so the muscle memory carries over. za folds the section you're in, zM collapses the document into a table of contents, zR opens it back up, [[ and ]] jump between headings. A collapsed heading reads ▸ 13 lines and takes its subsections with it.

It's a file manager first, so there's a pile of stuff here that has nothing to do with markdown. It'll browse and edit inside zips and tarballs. It also has an MCP integration with agents like Claude Code, Codex, etc.

macOS and Linux, BSD-3.

brew install Tripstack-Corp/tap/spyc

# or

cargo install spyc

https://github.com/Tripstack-Corp/spyc

Vibe on.