Terminal & AI-Agent Integration

A real pseudo-terminal lives next to the editor. This is the single biggest reason to use Kensa over "a folder of Markdown files plus a generic editor": your AI agent commands run with the right environment already wired up, and agent output flows straight back into the editor.

#A real PTY

• ConPTY on Windows, a shell on macOS/Linux.
• Supports full-screen TUI applications - Claude Code, vim, tmux, etc.
• True color, UTF-8, xterm-256color. The environment is set up precisely so Ink-based agent UIs render correctly.
• One persistent session per project, rooted at the project folder, that survives switching between cases (it is not recreated on every navigation).

#Multi-tab

Up to several PTY tabs per project, each preserving its own scrollback and state across tab switches. Need more than that? Run tmux inside.

#Environment auto-injection

The terminal always knows which case you're looking at:

TMS_CASE=/path/to/project/suites/auth/218.md   # the active case, kept in sync
TMS_PROJECT_ROOT=/path/to/project
KENSA_PROJECT_ROOT=/path/to/project
KENSA_VERSION=0.16.0

So claude "review $TMS_CASE" always means the case you currently have open.

#Bundled CLI on PATH

The kensa binary is injected onto the terminal's PATH automatically - no install step. Agents (and you) can call kensa list, kensa filter, kensa context, etc. straight away. See cli.md.

#Selection → editor

Right-click a terminal selection to drop agent output into the editor:

• Insert as new case in the current suite,
• Append to the current case,
• Replace the current case body, or
• Copy to clipboard as Markdown.

Kensa tries to parse the selection as a Markdown case (looking for a "Steps" section and numbered steps); if it can't, it inserts the text as-is.

#Conveniences

• Toggle visibility with Cmd/Ctrl+`; it collapses to a thin strip.
• Clear the buffer from the toolbar.
• Copy/paste with Ctrl+Shift+C / Ctrl+Shift+V (cross-platform aliases).
• Dockable right (default) or bottom; resizable splitter.
• Terminal theme follows the app's light/dark theme.