Browse documentation

Chat

Interacting with Mind CLI

The Mind CLI provides an interactive chat mode that lets you have natural conversations with AI directly in your terminal. The default experience uses a rich terminal UI with syntax-highlighted code, interactive panels, and visual tool progress.

Starting a session

To start a chat session:

mind

Or start a chat with a specific context:

mind --agent myagent

To run the session in a managed cloud sandbox instead of on your machine, add --cloud:

mind --cloud "migrate the auth module"

Entering multi-line statements

Insert a newline in your prompt using any of these methods:

  • Shift+Enter — works in iTerm2, Ghostty, Kitty, Warp, and Zed
  • Ctrl+J — works in all terminals including tmux
  • Alt+Enter — works in Terminal.app and Ghostty
  • /editor — opens your default editor (defaults to vi) for composing longer prompts

You can also use the /reply command to open your editor with the most recent assistant message quoted for reply.

Running shell commands inline

Run shell commands without going through the AI by prefixing with !:

!npm run build

Output streams in real time. TTY commands like vim, ssh, and top get full terminal access.

Managing context

Use /context to view and manage what files are included in your session:

/context show # View context breakdown with per-file token usage
/context add "src/**/*.ts" # Add files by glob pattern
/context remove src/app.js # Remove a context rule
/context clear # Remove all rules

Conversation persistence

Mind can remember your conversations based on the folder where you started them. When you start a session where you previously chatted with Mind, you can tell Mind to automatically load that conversation history, allowing you to continue the same session.

Directory-based persistence

# Resume current directory:
$ mind chat --resume
# Resume specific session by ID:
$ mind chat --resume-id <SESSION_ID>
# Open interactive session picker:
$ mind chat --resume-picker

Starting a fresh conversation

You can start a fresh conversation without restarting the CLI using the /chat new command.

/chat new how do I set up a React project