CLI / TUI Usage

Interactive TUI (Default)

memo

Best for multi-turn chat, visualized tool calls, approval dialogs, and session resume.

One-shot Mode (--once)

memo "your prompt" --once

Best for scripts, CI, and pipelines. Note: one-shot mode usually cannot run interactive approvals (see Tool Approval and Safety).

Version (--version)

memo --version

1) File Reference (@)

Type @ followed by a path fragment to trigger file suggestions (Tab accepts). Useful when telling the model exactly which files to inspect.

Examples:

• Read @package.json and explain scripts
• Compare approval logic in @packages/core/src/runtime/session.ts

2) Session Resume (resume)

Type resume (optionally with keywords) in the input box to show historical sessions. Selecting one loads the previous context into the current session.

Examples:

• resume (list recent sessions)
• resume approval (filter by keyword)

3) Slash Commands (/)

Type / to see command suggestions; you can also type commands directly and press Enter.

Common commands:

• /help: help and shortcut hints
• /new: start a new session (and clear screen)
• /exit or typing exit: exit
• /models: view/switch models (loaded from provider config)
• /context: set context cap (80k/120k/150k/200k)
• /mcp: view configured MCP servers

4) Local Shell Execution ($ <cmd>)

Commands starting with $ run directly in local cwd and show output as system messages. This is user-initiated local execution, not model tool approval flow.

Examples:

• $ git status
• $ rg "createAgentSession" -n

Current implementation:

• Enter: send
• Shift+Enter: newline
• Tab: accept current suggestion (file/command/history/model/context)
• Up/Down: move in suggestions or browse input history
• Esc: close suggestion list
• Esc Esc: cancel running task (busy) or clear input (idle)
• Ctrl+L: new session + clear screen
• Ctrl+C: exit

• Approval dialog and --dangerous: Tool Approval and Safety
• /models and provider config: Configuration
• History files and resume: Sessions and Logs