Skip to content

fast-agent go

fast-agent go command

The go command allows you to run an interactive agent directly from the command line without creating a dedicated agent.py file.

Usage

fast-agent go [OPTIONS]

Options

  • --name TEXT: Name for the agent (default: "fast-agent")
  • --instruction, -i <path or url>: File name or URL for System Prompt (default: "You are a helpful AI Agent.")
  • --config-path, -c <path>: Path to config file
  • --servers <server1>,<server2>: Comma-separated list of server names to enable from config
  • --url TEXT: Comma-separated list of HTTP/SSE URLs to connect to directly
  • --auth TEXT: Bearer token for authorization with URL-based servers
  • --model, --models <model_string>: Override the default model (e.g., haiku, sonnet, gpt-4)
  • --model, --models <model1>,<model2>,...: Run one agent per model in parallel and print a side-by-side comparison of responses
  • --message, -m TEXT: Message to send to the agent (skips interactive mode)
  • --prompt-file, -p <path>: Path to a prompt file to use (either text or JSON)
  • --skills-dir, --skills <path>: Override the default skills directory
  • --stdio "<command> <options>": Run the command to attach a STDIO server (enclose arguments in quotes)
  • --npx "@package/name <options>": Run an NPX package as a STDIO server (enclose arguments in quotes)
  • --uvx "@package/name <options>": Run an UVX package as a STDIO server (enclose arguments in quotes)
  • --shell, -x: Enable a local shell runtime and expose the execute tool (bash or pwsh)

Global CLI options (apply to all subcommands):

  • --quiet, -q: Disable progress display and logging
  • --verbose, -v: Enable verbose mode

Examples

Note - you may omit go when supplying command line options.

# Basic usage with interactive mode
fast-agent go --model=haiku

# Basic usage with interactive mode (go omitted)
fast-agent --model haiku

# Compare responses across multiple models (comparison mode)
fast-agent --models kimi,gpt-5-mini.low

# Specifying servers from configuration
fast-agent go --servers=fetch,filesystem --model=haiku

# Directly connecting to HTTP/SSE servers via URLs
fast-agent go --url=http://localhost:8001/mcp,http://api.example.com/sse

# Connecting to an authenticated API endpoint
fast-agent go --url=https://api.example.com/mcp --auth=YOUR_API_TOKEN

# Run an NPX package directly
fast-agent --npx @modelcontextprotocol/server-everything 

# Non-interactive mode with a single message
fast-agent go --message="What is the weather today?" --model=haiku

# Using a prompt file
fast-agent go --prompt-file=my-prompt.txt --model=haiku

# Specify a system prompt file
fast-agent go -i my_system_prompt.md

# Specify a skills directory
fast-agent --skills ~/my-skills/

# Provider LLM shell access (use at your own risk)
fast-agent -x

Comparison mode (multiple models)

Pass a comma-separated list to --models (or --model) to run one agent per model in parallel and compare responses side-by-side.

How it works:

  • --instruction / -i, --servers, --url, and other connection options apply to every model agent.
  • Each model string becomes a separate agent name in the output.
  • Interactive mode (default): every prompt is sent to all models and results are shown in a comparison view.
  • Non-interactive: use --message or --prompt-file to run once and print results for each model.
fast-agent go --models sonnet,gpt-5-mini.low

URL Connection Details

The --url parameter allows you to connect directly to HTTP or SSE servers using URLs.

  • URLs must have http or https scheme
  • The transport type is determined by the URL path:
  • URLs ending with /sse are treated as SSE transport
  • URLs ending with /mcp or automatically appended with /mcp are treated as HTTP transport
  • Server names are generated automatically based on the hostname, port, and path
  • The URL-based servers are added to the agent's configuration and enabled

Authentication

The --auth parameter provides authentication for URL-based servers:

  • When provided, it creates an Authorization: Bearer TOKEN header for all URL-based servers
  • This is commonly used with API endpoints that require authentication
  • Example: fast-agent go --url=https://api.example.com/mcp --auth=12345abcde