Skip to main content

Chat UI

Knox Agent is a native workbench pane, not a webview. Open it from the Activity Bar Knox icon, or ⌘L / Ctrl+L. There is no Chat vs Agent tab: Jev (when enabled) picks routing per turn; you stay in one transcript.

Knox Agent sidebar during a turn: file edit card with Apply, thinking chip, terminal card, permission bar on Edits, Jev in the status bar
Streaming turn in the native sidebar. Tool cards, thinking chip, Edits on the permission bar, Jev on the status bar.

This page is the layout. How you type is Composer and context. How tools are approved is Permission modes.

Regions​

Top to bottom in the sidebar:

RegionWhat you see
TranscriptYour messages, Knox replies, thinking chips, tool cards. Landmark name: Chat transcript. Skip to composer jumps past a long log.
Agent meterWhile a turn runs: activity kind (Thinking, Read, Search, Edit, Shell, Git, Task, Ask, Reply), step count, a rough token estimate. Thinking and Loading live here, not on the composer toolbar.
PanelsTask plan peek, background Jobs, git diff, queued messages, compaction banner, injected memories.
ComposerPermission bar, Plan, Run in background, model picker, editor, Send / Cancel. Landmark: Message composer.

Dedicated Memory and Checkpoint Graph windows replace this chat chrome (no composer). Open them from the title bar (brain and graph icons, left of Customize Layout) or Knox: View Memory / Knox: Open Checkpoint Graph.

Session tabs appear only if you turned Show Session Tabs on and you have more than one tab. A single conversation hides the tab strip.

Transcript​

  • Your messages can be click-to-edit on the floating sent prompt, including while a reply is still streaming.
  • Streaming replies can be selected and copied. Auto-scroll pauses on the first upward wheel so a live turn cannot yank the view.
  • Thinking collapses to a compact chip so tool cards stay in view. Expand it if the model exposed reasoning.
  • Tool cards stay on one header line. File edits show CheckPoint +N / −N. Terminal cards cap at five lines (scroll for the rest). Copy command is on the card.
  • Ask-user cards are named questions: Approve / Deny, or a multi-step form (Next / Previous, freeform).
  • Permission cards for a single tool: Approve, Always (rest of this chat), Deny.
  • Failed tools show Tool call failed (and retry count). Cancel on a running card stops that tool and the generation.

There are no empty-chat “Try” sample chips in 2.2.

Agent meter​

During a turn the meter shows what Knox is doing now and a running count of reads / searches / edits / tests.

ChipMeaning
N stepsTool rounds this turn. GUI default is unlimited; stop with Cancel. Background / /autonomous are capped.
systems / rustResolved agent profile (systems / rust) when it is not the default app profile.
~N tokEstimate from prompt logs (characters ÷ 4) unless the provider reported usage.
jev …Last Jev route (and optional skill hint). Never file contents.
Doom loopRepeated identical or failing calls. Change strategy injects a one-line instruction to pick a different approach.

Cancel current generation is ⌘⌫ / Ctrl+Backspace while streaming (composer hint: Cancel current generation).

Overlays (gear / lump toolbar)​

The lump toolbar opens overlays over the transcript, not a second window:

OverlayIconFor
ModelscpuCatalog, KnoxStudio / OpenRouter sign-in, Add Model
Rulessquare-penLoaded instruction files
Promptsscroll-textCustom slash prompts
ToolswrenchTool groups, path & command policy
HistoryhistorySessions
SettingssettingsAgent knobs (not Memory → Recipes)

Scroll in an overlay stays when the GUI rebuilds. Close it to return to chat.

Attached panels​

PanelWhen
Task planbuiltin_plan has steps. Fraction done/total, Execute plan when you leave Plan mode.
JobsBackground agents, long shell, subagents. Merge / Discard / Kill / Clear finished. Cap 2 concurrent background starts. Details: Background agents.
Queued messagesYou typed while a turn was running. Send now or Interrupt and send.
CompactionHistory was summarized (~75% context). Shows tokens saved.
Review editsMode popover chip is on. Held files, Apply / Discard per file. Shell still hits disk. Details: Review edits.

Title bar (outside the pane)​

ControlCommand
Memory (brain)Knox: View Memory / title-bar Open Knox Memory
Checkpoint GraphKnox: Open Checkpoint Graph
Language globeToggle Knox chat UI en / zh
ThemeToggle light / dark (chat palettes include One Dark, Light+, high contrast)

Accessibility​

The pane has landmarks, a live transcript region, named permission / jobs / checkpoint / recipe chrome, and Skip to composer. Arrow keys move between checkpoint tabs. Built-in palettes are contrast-checked; a dedicated VoiceOver/NVDA pass is still a human check. The chat UI was tuned for One Dark.

Next​

Composer and context · Review edits · Agent profiles