city 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

city agent chat [--to <agentName>]
city agent chat [--to <agentName>] --message <text> [--json]

Key options

• -t, --to <name>: target agent name; 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

• city agent list
• city agent start

Examples

$ city agent chat --to lucas_whitman
downcity 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.

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