Skip to content

Terminal UI

Open the terminal UI:

$npx linersh

The UI is keyboard-first and works with mixtape project folders.

KeyAction
up / down or j / kMove selection.
enter or oOpen the selected mixtape.
nCreate a new mixtape.
cCompile selected mixtape.
eEdit the selected mixtape’s sources and metadata.
sShare selected mixtape.
iImport a .mixtape archive.
dDelete selected folder after confirmation.
rRefresh the project list.
esc or bGo back from nested flows.
qQuit.
KeyAction
up / down or j / kSelect a phase.
enterRun or open the selected phase.
eEdit the selected artifact by hand.
pOpen the process manifest.
sShare the mixtape.
oOpen the project folder.
escGo back.
qQuit.

Quick mode advances review gates automatically. Methodology mode opens the gate review screens so you can inspect and accept the generated artifacts before moving on.

KeyAction
up / down or j / kSelect a source.
t / d / uEdit title, description, or curator.
mToggle quick or methodology mode.
gEdit the job-to-be-done.
EOpen synthesis.md in $EDITOR.
a / e / xAdd, edit, or remove a source.
K / JMove a source up or down.
sSave tape.yaml.
cSave and compile.
escGo back.

The editor blocks compile until synthesis.md exists and no longer contains the starter placeholder.

KeyAction
up / down, j / k, or tabMove between fields.
enterEdit the selected field.
TToggle source type.
RCycle web rendering: auto, JS, server.
pToggle required or optional priority.
sSave the source.
escCancel or leave field editing.

render only applies to web sources. Auto mode tries server HTML first and falls back to Chromium when Liner detects a JavaScript-only page and browser support is available.

KeyAction
up / downScroll sources.
pgup / pgdnJump through sources.
escCancel a running compile or return to the hub from results.
jInstall JS rendering support when the compile screen shows that callout.
yCopy compiled MIXTAPE.md to clipboard.
sShare compiled mixtape.
oOpen the project folder.
rRerun compile or retry a failed compile.
bBack to hub from results.
qQuit.

The terminal UI can import .mixtape archives from the browser with i. It scans the current directory, lets you type a path, and extracts into your Liner workspace.

TUI import does not refetch sources. After import, open the folder and compile when you want fresh extracted source files.