Chat CLI

The nodetool chat command starts an interactive terminal interface for conversing with language models and running tools.

Starting the Interface

Run nodetool chat from your shell. A welcome panel appears with the current model, agent status, and workspace path. Type /help at any time to see available commands.

CLI Commands

Commands use a / prefix. Important commands include:

• /help – Show available commands and workspace operations.
• /provider – Show current provider and authentication status.
• /providers – List available providers.
• /models – List models from the current provider.
• **/model ** – Select the language model to use.

• **/agent [on

  off]** – Toggle agent mode for tool‑augmented conversations.

• /tools [name] – List available tools or show details for one.
• /usage – Show usage statistics for the current provider.
• /exit – Quit the chat session.

Workspace Commands

Within the chat you can manage files in a sandboxed workspace located under ~/.nodetool-workspaces. Workspace operations do not use the / prefix:

• pwd – Print the current directory.
• ls [path] – List directory contents.
• cd [path] – Change directory.
• mkdir <dir> – Create a directory.
• rm <path> – Remove a file or directory.
• open <file> – Open a file with the system default application.
• cat <file> – Display file contents with syntax highlighting.
• cp <src> <dest> – Copy files or directories.
• mv <src> <dest> – Move or rename items.
• grep <pattern> [path] – Search text within files.
• cdw – Jump to the workspace root.

Settings and History

Session settings are stored in ~/.nodetool_settings and command history in ~/.nodetool_history. These files allow the chat interface to remember your model choice, agent mode, and other options between runs.