studio agent chat

Chat with a target agent from the terminal.

This page remains as a command entry point. For the fuller explanation, see Chat with an Agent and CLI / chat.

This command uses a dedicated local CLI main session: local-cli-chat-main.

Usage

studio agent chat [--to <id>]
studio agent chat [--to <id>] --message <text> [--json]

Key options

• -t, --to <id>: target agent id; if omitted, the CLI opens an interactive picker from running agents
• -m, --message <text>: send one message and exit instead of entering the REPL
• --json: print structured output for one-shot mode
• --host <host> / --port <port>: force remote HTTP transport
• --token <token>: explicit Bearer token for remote HTTP mode

Behavior

• Defaults to interactive terminal chat when --message is omitted.
• One-shot mode works without entering the REPL.
• Requires the target agent to be running.
• Keeps sending every line into the same local CLI session instead of sharing Console UI context.
• Type /exit or /quit to leave the chat loop.

Related commands

• studio agent list
• studio agent start

Examples

$ studio agent chat --to lucas_whitman
studio v1.0.439

INFO Agent chat · lucas_whitman

lucas_whitman> summarize today's work

Today you completed the plugin interactive CLI redesign and validated the updated command tree.

$ studio agent chat --to lucas_whitman --message "summarize today's work" --json