TUI CLI Reference
CLI Commands
Section titled “CLI Commands”sec-gemini
Section titled “sec-gemini”Launch the TUI or run a subcommand.
sec-gemini [OPTIONS] [COMMAND]| Option | Description |
|---|---|
-v, --verbose |
Enable verbose debug logging to stderr |
--disable-logging |
Disable session-level logging for privacy |
When invoked without a subcommand, the TUI launches (equivalent to sec-gemini run).
sec-gemini run
Section titled “sec-gemini run”Launch the TUI. This is the default when no subcommand is given.
sec-gemini set-key
Section titled “sec-gemini set-key”Set your Sec-Gemini API key interactively or inline.
sec-gemini set-key [API_KEY] [OPTIONS]| Option | Description |
|---|---|
API_KEY |
API key (prompted interactively if omitted) |
--force |
Overwrite an existing saved key |
--skip-verify |
Save the key without verifying it against the API |
sec-gemini sessions
Section titled “sec-gemini sessions”Manage sessions from the command line.
sec-gemini mcp
Section titled “sec-gemini mcp”Manage MCP server configuration.
sec-gemini tools
Section titled “sec-gemini tools”Manage local tool configuration.
sec-gemini model
Section titled “sec-gemini model”Manage model settings.
sec-gemini config
Section titled “sec-gemini config”View or edit configuration. See the Configuration Reference for details.
Keybindings
Section titled “Keybindings”Session List Screen
Section titled “Session List Screen”| Key | Action |
|---|---|
Enter |
Create a new session |
Escape |
Quit |
? |
Show help |
Session Screen
Section titled “Session Screen”| Key | Action |
|---|---|
Escape |
Go back to session list |
Ctrl+S |
Save full session trajectory |
Ctrl+C |
Copy focused content |
Ctrl+V |
Paste from clipboard |
Ctrl+P |
Pause / Resume session |
Ctrl+L |
Toggle right panel |
Ctrl+U |
Upload file |
? |
Show help |
Prompt Input
Section titled “Prompt Input”| Key | Action |
|---|---|
Enter |
Send message |
Shift+Enter |
Insert newline |
Session Screen Layout
Section titled “Session Screen Layout”Event Bar
Section titled “Event Bar”Compact ticker at the top showing recent agent events. Each event has a type tag (RSP, TOOL->, TOOL<-, PROG, ERR, WARN, DONE, etc.) with a timestamp and summary.
Chat View
Section titled “Chat View”Scrollable message container with markdown rendering. Agent thoughts and tool call/result pairs are displayed in collapsible blocks.
Right Panel
Section titled “Right Panel”Toggle with Ctrl+L. A 40-character wide sidebar with independently scrollable sections:
| Section | Content |
|---|---|
| Top Tools | Bar chart of tool invocation counts (purple = local, blue = remote) |
| Tasks | Hierarchical task tree with state indicators |
| Skills | Loaded skills with descriptions and origin |
| Memory | Categorized memory entries from the agent |
| Files | Uploaded session files (appears only when files exist) |
Prompt Input
Section titled “Prompt Input”Multi-line text area (3–8 lines). Enter sends, Shift+Enter adds a newline. Upload (Ctrl+U) and Send buttons alongside.
Status Footer
Section titled “Status Footer”Single-line bar at the bottom: session name, cloud/BYOT status dots (color-coded), tool counts (local / remote), skill count, elapsed time, and a clickable View Logs link.
Configuration
Section titled “Configuration”See the Configuration Reference for the full config.toml format, environment variables, and log file locations.