TUI

The tern binary includes a terminal profile manager for creating and editing local profiles and browsing pipelines. It opens with tern -p, or with plain tern when the project has no profiles yet.

Tabs

Tab Content
Converters Profile list: create, edit and delete local profiles; template profiles are read-only
Pipelines Pipelines with their stages and items, read-only

Keybindings

The status bar shows the keys available in the current context.

Key Context Action
j / Down, k / Up Browsing Move the selection
Left / Right Browsing Switch tabs
n Converters Create a profile
Enter Converters Edit the selected profile
d Converters Delete the selected profile
q Anywhere Quit
Tab / Shift+Tab Form Next / previous field
Ctrl+Enter / Ctrl+J Form, multi-line fields Insert a newline
Enter Form Save
Esc Form Cancel
y Confirmation Confirm
n / Esc Confirmation Cancel

Profile form

Field Content
Name Unique profile name
Engine Converter file name, e.g. pandoc.lua
Origin local (default) or global, reference Converters
Source Root Directory scanned for sources
Source Extension Extension of the sources, e.g. md
Output Root Directory the outputs go to
Output Extension Extension of the outputs, e.g. html
Options One option per line
Ignore Patterns One gitignore pattern per line

Reference Database for what each field means to a run.

Template profiles

Template profiles are marked [tpl] and cannot be edited or deleted here: tern -u recomputes them from the template’s manifest and the overrides in .tern/config.toml, so a change made in the TUI would be discarded on the next update. Trying shows a notice naming the owning template. Template profiles change through their override block in .tern/config.toml, and go away when their [[templates]] entry is removed.

Deleting a profile used by a pipeline

Deleting a profile that a pipeline stage references asks for confirmation and lists those pipelines and stages. Confirming removes the profile, the stage items that reference it, stages left empty and pipelines left without stages.