CLI

CLI Commands

Common commands for downcity and downfed

CLI Commands

downcity (city)

Global init and update

# Initialize City global state
downcity init

# Update CLI to latest version
downcity update

Agent lifecycle

# Create a new Agent project
downcity agent create my-project

# List registered Agent projects
downcity agent list

# Start an Agent in the background
downcity agent start

# Start an Agent in the foreground
downcity agent start --foreground

# Stop the Agent daemon
downcity agent stop

# Restart the Agent daemon
downcity agent restart

# Check Agent status
downcity agent status

# Diagnose daemon issues
downcity agent doctor
# Fix stale daemon state
downcity agent doctor --fix

# Chat with an Agent
downcity agent chat
# Send a one-shot message
downcity agent chat -m "hello"

Agent history

# Clean a conversation history
downcity agent history clean
# Clean a specific session
downcity agent history clean --session-id <id>

Environment variables

# List env vars
downcity env list
# Set an env var
downcity env set KEY=value
# Delete an env var
downcity env delete KEY
# Export env vars to .env
downcity env copy

Tokens

# List API tokens
downcity token list
# Create a new token
downcity token create
# Delete a token
downcity token delete <id>

Plugins

# Manage plugins interactively
downcity plugins
# Schedule plugin actions
downcity plugins schedule

Chat

# Manage chat resources interactively
downcity chat
# Set chat authorization
downcity chat auth set <platform>:<userId>

downfed

# Open interactive Federation manager
downfed

# Open admin interface
downfed manage

# Add a Federation server
downfed server add

# Enter a server workspace
downfed server manage

# Query Federation API
downfed query GET /health

# Create a new project
downfed create my-project

# Deploy a project
downfed deploy
# Deploy with options
downfed deploy --verify --dry-run

Continue with: