DSH Editor (CLI)

A native /files command for DeepSeek Harness (DSH)'s terminal surface (acryl-cli) - browse, view, and edit files without leaving the TUI.

This is the TUI-native sibling of acryl-dsh-editor-plugin-web, built for acryl-cli's own presentation-slot extension point (tuiCommands, spec 034 T009) rather than a browser client bundle. There is no Host/Client split here: the CLI and its Cordis Loader tree share one process, so this plugin's own apply(ctx) both registers the /files command and reads/writes files directly - no wire protocol to design.

Features (v2)

• File tree - browse from your home directory, directories-first sorting, .. to go up. Vim-style h/j/k/l work alongside arrows.
• Filter - / starts an incremental, case-insensitive name filter over the current directory's listing.
• File viewer - scrollable, line-numbered.
• Editor - press e while viewing a file to edit it in place: cursor movement, character insert/delete, newline splitting, and ctrl+s to save. Saves go through a same-directory temp-file-then-rename, so a mid-write failure never leaves a half-written file on disk.
• Back navigation - Escape (or ←/h) steps back one directory level at a time, restoring your selection to wherever you drilled in from, before finally closing the overlay once you're back at the start. Escape also steps back out of search, view, and edit modes the same way.

Deliberately still not built: cross-file/recursive search, git diff, Markdown rendering, syntax highlighting. Syntax highlighting in particular was evaluated and skipped deliberately - see the top-of-file comment in lib/index.js for why (it needs a different rendering model than this plugin's plain pi-tui Component contract provides).

Install

dsh plugin --profile <name> add acryl-dsh-editor-plugin-cli

(Each profile is its own single-package pnpm workspace, which currently needs -w to satisfy pnpm's own workspace-root safety check: dsh plugin --profile <name> add acryl-dsh-editor-plugin-cli -w.)

After installing, restart acryl tui. Type /files at the prompt.

Requirements

• Node.js >= 20
• acryl-cli with tuiCommands (spec 034 T009 or later) - the extension point this plugin registers against. Installing this on a surface without it (Web, Desktop) leaves the plugin's row simply inactive, not crashed: tuiCommands is a hard inject requirement, so the Fiber just never activates there.

Architecture

A DSH TUI plugin declares itself via the npm package's dsh field (dsh.bundle.patch -> cordis.patch.yml, which inserts the row) - the same convention every DSH plugin uses. Unlike a Web plugin, there is no dsh.client field: lib/index.js is a standard Cordis Host plugin whose apply(ctx) calls ctx.tuiCommands.register({command, description, open}), where open({tui, close}) returns a real pi-tui Component built and owned entirely by this package.

License

MIT