Interactive TUI

Run mogick without arguments to open the full-screen TUI, which combines conversation, tool-call monitoring, session management, and settings.

Start the TUI

mogick                          # Start with the current directory as the workspace
mogick --resume <session-id>    # Resume a session
mogick --continue               # Continue the most recent session

Change to your project directory before starting. In the TUI, press Shift+Tab to switch between Plan and Agent modes.

Before startup, Mogick checks for interactive standard input and output, TERM, terminal size, a UTF-8 locale, and Windows virtual-terminal support. mogick doctor includes these results by default. If the interface is misaligned, run mogick doctor --check-terminal-font. MOGICK_TUI_SKIP_TERMINAL_CHECK=1 is for debugging only; skipping checks does not guarantee correct rendering.

Interface layout

Region	Location	Features
Chat area	Center	Conversation history, streaming responses, reasoning blocks, tool groups, and system events
Input box	Bottom	Multiline input, @ file references, pasted images, and / commands
Sidebar	Right	Session information, context usage, MCP status
Status bar	Bottom row	Active mode, run status, model name, and shortcut hints

When the terminal is 80 columns wide or narrower, the sidebar is hidden automatically. Press Ctrl+B to toggle it manually.

Shortcut keys

Shortcut	Action
Tab	Switch focus between chat area and input box
Shift+Tab	Switch between Plan and Agent modes
Ctrl+P	Open the command palette
Ctrl+B	Show/hide sidebar
Ctrl+G	Open the Changes panel
Ctrl+O	Cycle tool detail display modes
Esc	Request cancellation while running; an active panel handles it first
Ctrl+C	Press twice to quit; a copyable input selection takes priority

Sidebar

The sidebar updates throughout the conversation. It shows the session title, summary, and ID; context-window utilization and cache hit rate; MCP connection status; turn duration; and current model. It hides automatically on narrow terminals, and you can toggle it with Ctrl+B.

See Command Palette and Sidebar for the meaning and examples of each information block.

Chat area

Feature	Behavior
Streaming output	Text rendered verbatim
Reasoning block	Collapsed by default; press Enter to expand
Tool group	Use Ctrl+O to change detail mode; outside the input box, o toggles the latest tool block
@ file reference	Type @ for fuzzy file search; multiple files are supported
Attachment chip	File and folder context appears as an openable chip; internal @file tags are hidden
Image input	Copy a PNG, JPEG, or GIF file and paste it into the input box
Language	Chinese and English; change it under Ctrl+P > Settings, then restart

System events include working-directory changes, AGENTS.md loading, MCP connection changes, mode switches, plan and permission approvals, and tool interception.

Themes

export MOGICK_TUI_THEME=auto   # Follow the terminal (default)
export MOGICK_TUI_THEME=dark   # Dark theme
export MOGICK_TUI_THEME=light  # Light theme

Slash commands

Command	Function
/new	Create a new blank session
/sessions	Browse and switch previous sessions
/rename	Rename the current session
/models	Select a model by provider
/connect	Connect a custom model
/mcp	MCP server connection, start and stop
/skills	Browse and load available Skills
/permissions	Switch permission policy
/compact	Manual context compaction
/changes	Open the Changes panel
/review	Run a read-only review of the current Changeset and show findings in Changes
/rewind	Roll back the workspace to a checkpoint

See the Slash command reference for a complete list.

/changes or Ctrl+G opens the Changes panel, while /review starts a read-only review of the current Changeset. For panel shortcuts and Git Evidence export, see Review and track changes.

Settings

Ctrl+P > Settings:

Setting	Options	Default	Description
Language	Chinese / English	Detect from the terminal locale	Change the interface language after restart
Diagnostics	On / Off	Off	Record ACP and CRP protocol traces for troubleshooting
Subagents	On / Off	Off	Enable the agent.task subagent feature
TOON encoding	On / Off	Off	Encode tool results in TOON (Tool Output Object Notation) to reduce token usage

Upgrade panel

The top pops up when a new version is detected on startup:

Option	Behavior
Upgrade now	Exit the TUI and run the upgrade in the foreground
Skip this time	Close the panel and prompt again on the next launch
Skip this version	Stop prompting for this version

For file references, clipboard images and result links, see Files and images. To adjust supported reasoning effort, use /efforts.