CLI Reference¶

The FastAgentic CLI streamlines project scaffolding, local development, introspection, and contract testing. This reference documents each command and its key options.

Global Options¶

fastagentic new¶

Scaffold a new application.

fastagentic new my-service --adapter langgraph --auth oidc

Generated structure:

• app.py with an App instance
• models/ for Pydantic schemas
• endpoints/ with sample decorators
• config/settings.yaml and .env
• tests/test_contracts.py for schema parity

fastagentic add endpoint¶

Create decorator stubs within an existing project.

fastagentic add endpoint support triage --type agent --stream --durable

The generator creates files under endpoints/ or prompts/ with Pydantic model placeholders.

fastagentic run¶

Launches the ASGI application server. Supports both development (Uvicorn) and production (Gunicorn) modes.

# Development with auto-reload
fastagentic run --reload

# Production with Gunicorn
fastagentic run --server gunicorn --workers 4

# Production with concurrency limits
fastagentic run --server gunicorn --workers 4 --max-concurrent 100

Server Options¶

Scalability Options¶

Connection Pool Options¶

Examples¶

# Development
fastagentic run --reload

# Staging
fastagentic run --server gunicorn --workers 2 --max-concurrent 50

# Production
fastagentic run \
  --server gunicorn \
  --workers 4 \
  --max-concurrent 100 \
  --redis-pool-size 20 \
  --instance-id worker-1

See the Scaling Guide for detailed production deployment documentation.

fastagentic tail¶

Streams logs, events, and telemetry in real time.

fastagentic tail --runs 10 --events token,node_start

tail can connect to local or remote deployments by reading configuration from environment variables or the specified config file.

fastagentic test contract¶

Validates that REST and MCP schemas remain in sync.

fastagentic test contract --fail-on-drift

The command compares:

• OpenAPI operation IDs vs. MCP tool names
• Security scopes across both surfaces
• Pydantic model serialization for inputs/outputs
• Prompt metadata and example alignments

fastagentic inspect¶

Interactively explore registered decorators, schemas, and runtime configuration.

fastagentic inspect --schema tool:summaries

fastagentic templates¶

Manage project templates.

templates list¶

fastagentic templates list [--category official|community] [--verbose]

templates search¶

fastagentic templates search "multi-agent"

templates info¶

fastagentic templates info pydanticai

templates refresh¶

Refresh template cache from remote repository.

fastagentic templates refresh

fastagentic mcp¶

MCP protocol operations.

mcp validate¶

Validate MCP schema against specification.

fastagentic mcp validate [--spec-version 2025-11-25]

mcp manifest¶

Generate MCP manifest file.

fastagentic mcp manifest > mcp.json
fastagentic mcp manifest -o mcp.yaml --format yaml

mcp call¶

Test tool invocation.

fastagentic mcp call summarize_text --input '{"text": "..."}'
fastagentic mcp call analyze_data --file input.json

mcp stdio¶

Start interactive stdio session.

fastagentic mcp stdio --interactive

fastagentic a2a¶

A2A protocol operations.

a2a validate¶

Validate A2A Agent Card.

fastagentic a2a validate [--spec-version 0.3]

a2a card¶

Display or export Agent Card.

fastagentic a2a card
fastagentic a2a card -o agent.json --extended

a2a list¶

List registered agents.

fastagentic a2a list [--internal] [--external]

a2a invoke¶

Invoke an agent skill.

fastagentic a2a invoke support-triage --input '{"title": "..."}'
fastagentic a2a invoke deep-research --stream --input '{"query": "..."}'

a2a ping¶

Check connectivity to external agent.

fastagentic a2a ping https://external-agent.example.com

fastagentic agent¶

Interactive agent testing and development CLI. Provides a Claude Code / Gemini CLI-like experience for working with agents.

agent chat¶

Start an interactive chat session.

fastagentic agent chat
fastagentic agent chat --url http://localhost:8000 --endpoint /chat
fastagentic agent chat --verbose

REPL Commands:

agent query¶

Send a single message to an agent.

fastagentic agent query "Hello, how are you?"
echo "Summarize this" | fastagentic agent query -
fastagentic agent query "Generate code" -o output.txt

agent config¶

View or modify CLI configuration.

fastagentic agent config --show
fastagentic agent config --url http://production:8000
fastagentic agent config --api-key sk-xxx

Configuration is stored in ~/.fastagentic/config.json.

agent history¶

Manage conversation history.

fastagentic agent history --list
fastagentic agent history --load conv-123
fastagentic agent history --delete conv-123
fastagentic agent history --clear

Conversations are stored in ~/.fastagentic/history/.

See the Agent CLI Guide for detailed documentation.

fastagentic config¶

Configuration management.

config show¶

Display resolved configuration.

fastagentic config show [--env production] [--secrets]

config validate¶

Validate configuration file.

fastagentic config validate config/settings.yaml

config init¶

Generate default configuration.

fastagentic config init -o config/settings.yaml
fastagentic config init -o .env --format env

Environments and Configuration¶

CLI commands read configuration in this order:

1. Command-line flags
2. Environment variables (FASTAGENTIC_*)
3. Project config/settings.yaml
4. Local .env file

This hierarchy keeps local development flexible while preserving predictable deployment behavior.

Environment Variables¶

General¶

Server Configuration¶

Connection Pools¶

Exit Codes¶

Shell Completion¶

# Bash
fastagentic --install-completion bash

# Zsh
fastagentic --install-completion zsh

# Fish
fastagentic --install-completion fish