spyc
TUI file commander with side-pane coding agents sharing file state over MCP.
Tested on LinuxKnown vulnerabilities
Use it
Before you install: known vulnerabilities
pickfit found 3 known high or critical vulnerabilities (5 findings, one per affected package version) in the packages a fresh install brings (OSV.dev, 3 Nov 2026). Weigh this before you install it.
crates:pulldown-cmark 0.13.5Quadratic parsing of nested image wikilinks with `ENABLE_WIKILINKS` (RUSTSEC-2026-0433, high, fixed in 0.13.6)crates:quick-xml 0.37.5Quadratic run time when checking a start tag for duplicate attribute names (RUSTSEC-2026-0194, high, fixed in 0.41.0)
See 3 more
crates:quick-xml 0.38.4— RUSTSEC-2026-0194 (high), fixed in 0.41.0crates:quick-xml 0.37.5— RUSTSEC-2026-0195 (high), fixed in 0.41.0crates:quick-xml 0.38.4— RUSTSEC-2026-0195 (high), fixed in 0.41.0
Linux x86_64
Download spyc release tarball
curl -fsSL -o /tmp/spyc.tar.gz https://github.com/Tripstack-Corp/spyc/releases/download/v2.3.0/spyc-v2.3.0-linux-x86_64.tar.gzExtract and install spyc binary
mkdir -p /tmp/spyc-ex && tar -xzf /tmp/spyc.tar.gz -C /tmp/spyc-ex && mkdir -p ~/.local/bin && cp /tmp/spyc-ex/spyc ~/.local/bin/spyc && chmod +x ~/.local/bin/spyc
Check that it works
spyc --helpThe output should contain “Print help”.
First thing to try
spyc --print-configRun spyc in a terminal from your project folder to open the file commander.
What it does
- Browse files with the keyboardNot tested
- Run an AI coding agent in a side paneNot tested
- Share selected files with the agent over MCPNot tested
- Review git diffs and blame in placeNot tested
How far pickfit got
Linux x86_64
- Installs
- Starts
- 0 of 4 features work
- Works offline
macOS: the project says it runs there; pickfit hasn’t tried it.
Good for
- Pick files and ask the side-pane agent about the selection
- Jump to a file named in agent output with gf
- Diff file against HEAD with git-aware listing
- Search filenames and project content
- Bind keys to Lua scripts to automate file picks
An alternative to Yazi, Broot and Ranger.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 2.3.0
Differences the test machine hit
- README: brew install Tripstack-Corp/tap/spyc and cargo install spyc
In the test: downloaded spyc-v2.3.0-linux-x86_64.tar.gz from GitHub releases and copied top-level spyc binary to ~/.local/bin - README: MCP bridge gives agent get_spyc_context/search_paths/git tools
In the test: standalone spyc --mcp answers initialize with spyc serverInfo but tools/list returns empty tools [] without a running commander instance