Chat in the terminal
Chat with a Toolang agent, inspect its work, and adjust the model or runnable without leaving the terminal.
Open Chat
Create an agent using the Quickstart, then open a new thread:
toolang alice chatContinue the latest thread with a bare -t, or supply a thread ID:
toolang alice chat -t
toolang alice chat -t THREADA shared definition also works directly:
toolang https://toolang.ai/dev.too chatSend and queue input
Press Enter to send input. If a run is already active, the input is queued for a later run. Meta+Enter sends it as steering input to the active run.
| Shortcut | Action |
|---|---|
| Enter | Send input or queue it |
| Ctrl+J | Insert a newline; Shift+Enter also works in supported terminals |
| Meta+Enter | Steer the active run |
| Esc Esc | Cancel the active run |
| Tab / Shift+Tab | Switch focus between input and queue |
| Ctrl+C | Clear input, otherwise cancel the run; press twice to exit |
With the queue focused, use the arrow keys to select input, Space to expand
it, e to edit it, and d to delete it. Use /keys for the complete list.
Choose models and runnables
Slash commands change session settings or inspect the agent. Submit each slash command on its own.
| Command | Purpose |
|---|---|
/models | List allowed models |
/tools | List allowed tools |
/caps | List allowed caps |
/agics / /flows | List available runnables |
/model MODEL | Set the session model |
/model effort=high | Set the model's reasoning effort, when supported |
/agic NAME / /flow NAME | Select a session runnable |
/runnable default | Return to the default runnable |
/output | Show the latest run's output |
/output RUN | Show a specific run's output |
/help | List commands |
/exit | Exit Chat |
/models, /tools, and /caps accept a collection query to filter results.
Add -a to inspect all available resources, including those outside the session's
allowed set. Use toolang query COLLECTION for query syntax and fields.
Set resource and run limits
Session settings apply to subsequent submissions:
/allow tools=fs/* skills=review*
/limit tokens=20000 time=120/allow sets resource ceilings; it does not grant resources excluded by the
agent's configuration. /limit sets run budgets. Use /allow or /limit
without arguments for focused help.
Override one run
Put colon directives before the input in a single submission. These settings apply only to that run:
:model effort=high
:limit tokens=10000
Compare the two approaches and recommend one.To select a runnable and supply named inputs for one run:
:agic review focus=security
Review this file for security issues.
@src/auth.pyThis assumes the agent defines an agic named review with a focus parameter.
Type :? for the supported overrides.
Include files and prompts
Place a file reference such as @README.md on its own line to include its
content. Quote paths containing spaces: @"release notes.md". Prompt calls also
start at the beginning of a line, for example
$review focus=security -- explain this change, when that prompt is available.
Use @@, $$, //, or :: at the start of a line to write a literal marker
instead of a file reference, prompt call, slash command, or colon directive.