@lk251066/dsh-tui

Usage

After successful installation and profile validation:

dsh --profile tui

The bundled profile opens the active project session for the current directory. If the directory has no active session, it creates one and adds it to the workspace. The TUI enters the terminal alternate screen and renders a full outer frame. Transcript, tool output, and editor occupy the left inner area; a right sidebar keeps Workspace, Active, Current, and Status fixed while Page Up, Page Down, and the mouse wheel scroll only the active transcript. Short choices replace the fixed bottom input area without popup borders. Stopping the TUI restores the invoking terminal and its scrollback.

Use /sessions to replace the left chat area with complete history while the outer frame and right sidebar remain fixed. Up and Down select a row, Enter opens it, Tab switches between complete history and the active list, and Space adds or removes a project session from the active workspace list. Escape returns to the transcript. Removing membership never deletes the session log. Use /assistant for the fixed personal assistant session.

The TUI owns these commands: /help, /model, /effort, /clear, /details, /theme, /queue, /rename, /fork, /status, /context, /agents, /jobs, /settings, /export, /exit, /quit, /sessions, /new, and /assistant. /effort only accepts reasoning levels advertised by the selected model; model and effort selections are independent for each live session. dsh-base may add /feedback, /goal, /compact, /permission, and /plan. The bundle does not provide /palette, /reload, /fleet, or /memories.

Use /new for another session in the active project. Use the whole command remainder as a project path, including spaces:

/new D:\work\another project

Configuration

The bundled cordis.patch.yml installs the TUI with these defaults:

- id: tui
  name: '@lk251066/dsh-tui'
  config:
    sidebarWidth: 32
    showReasoning: false
    maxToolOutputLines: 6

sidebarWidth sets the preferred right-sidebar width in terminal columns, defaults to 32, and accepts values of 24 or greater. The outer frame reserves one row and column on each edge. Below 65 total columns the sidebar hides so the main area remains usable. A height of at least 24 rows is recommended to keep Workspace, Sessions, Current, Status, and the editor visible together.

The package also exports @lk251066/dsh-tui/prompt and @lk251066/dsh-tui/invariant for its bundle composition. Treat the bundled patch as the supported entry path; direct manual profile composition must provide every service injected by the TUI.