Skip to main content
๐Ÿ’ป Terminal User Interface

TUI Guide

Master the Snow-Flow terminal interface. Learn keyboard shortcuts, commands, and agent modes to maximize your productivity.

Interface Overview

Status Bar Shows agent, model, and session info
Message Pane Conversation history with AI responses
Input Area Type your prompts here

Agent Modes

Switch between agents using Tab or /agents. Each agent has different capabilities:

๐Ÿ”จ

Build

General purpose agent for building and implementing features. Can read, write, and execute code.

๐Ÿ“‹

Plan

Planning agent that creates detailed implementation plans before coding. Focuses on architecture and design.

Keyboard Shortcuts

Navigation

Ctrl+X Leader key (prefix for most commands)
Tab Switch to next agent
Shift+Tab Switch to previous agent
F2 Cycle to next recent model
Shift+F2 Cycle to previous recent model
Ctrl+Right Next child session
Ctrl+Left Previous child session

Input

Enter Submit message
Shift+Enter Insert newline
Ctrl+J Insert newline (alternative)
Ctrl+C Clear input / Exit
Ctrl+V Paste content
Esc Interrupt running operation

Scrolling

PgUp Page up
PgDown Page down
Ctrl+Alt+U Half page up
Ctrl+Alt+D Half page down
Ctrl+G Jump to first message
Ctrl+Alt+G Jump to last message

Leader Key Commands

Press Ctrl+X first, then the second key. Leader key can be customized in config.

Ctrl+X H Show help
Ctrl+X N New session
Ctrl+X L List sessions
Ctrl+X G Show timeline
Ctrl+X S Share session
Ctrl+X C Compact session
Ctrl+X X Export conversation
Ctrl+X M List models
Ctrl+X A List agents
Ctrl+X T List themes
Ctrl+X E Open external editor
Ctrl+X D Toggle tool details
Ctrl+X B Toggle thinking blocks
Ctrl+X I Initialize project (AGENTS.md)
Ctrl+X Y Copy message
Ctrl+X U Undo last message
Ctrl+X R Redo message
Ctrl+X Q Exit application

Slash Commands

Type these commands in the input area. All commands start with /

/help Show available commands
/new, /clear Start a new session
/sessions, /resume List and resume sessions
/timeline, /history Show session timeline
/models List and select AI models
/agents List available agents
/themes Switch color theme
/share Share current session
/unshare Stop sharing session
/compact, /summarize Compact session history
/export Export conversation
/editor Open external editor
/init Create/update AGENTS.md
/details Toggle tool details view
/thinking Toggle thinking blocks
/undo Undo last message
/redo Redo message
/auth, /login Authenticate with providers
/debug Toggle debug mode
/exit, /quit, /q Exit application

Tips & Tricks

๐Ÿ’ก

Multi-line Input

Use Shift+Enter to write multi-line prompts. Perfect for code blocks or detailed instructions.

๐Ÿ”„

Quick Model Switch

Press F2 to quickly cycle through your recently used models without opening the model list.

๐Ÿ“ฆ

Session Compacting

Use /compact when context gets long. It summarizes history while keeping important context.

โช

Undo/Redo

Made a mistake? Use Ctrl+X U to undo or /undo. This reverts to the previous conversation state.

๐ŸŽจ

Custom Themes

Use /themes to switch themes. You can also create custom themes in your config directory.

๐Ÿ“ค

Share Sessions

Use /share to create a shareable link to your conversation. Great for collaboration.

Configuration

Customize the TUI through your config file:

~/.config/snow-flow/config.json
{
  "theme": "snow-dark",
  "keybinds": {
    "leader": "ctrl+x"
  },
  "tui": {
    "scrollSpeed": 3
  }
}

Ready to Start?

Install Snow-Flow and launch the TUI to start building ServiceNow solutions.