CLI Reference

CLI Reference

The ADEPT CLI (afk) provides command-line access to the platform for session management, tool operations, file handling, and Agent-to-Agent (A2A) mesh administration.

Installation

pip install agentic-framework-sdk

After installation, the afk command is available in your shell.

Basic Usage

# Start an interactive chat session
afk chat

# Start chat with a named session for continuity
afk chat --session my-research

# Use a specific model
afk chat --model gpt-4o --session analysis

Command Reference

Command	Description
afk chat	Start an interactive chat session with the agent
afk tools	Manage registered tools (list, register, delete)
afk files	Upload, list, and download files
afk sessions	List and load saved conversation sessions
afk config	View and modify CLI configuration
afk a2a	Agent-to-Agent mesh administration

Configuration

afk config show --verbose                # Show current configuration
afk config set gateway_url <url>         # Set a configuration value
afk config init                          # Initialize interactively
afk config doctor                        # Run health check
afk config bootstrap \
  --gateway-url https://your-adept-server.example.com/v1 \
  --keycloak-url https://your-adept-server.example.com/auth \
  --username alice

Tool Management

# List all available tools
afk tools list --username alice --password secret

# Register a new MCP tool
afk tools register my-tool \
  --description "Custom analysis tool" \
  --protocol mcp \
  --url http://my-tool-server:8080 \
  --acl-groups scientists,admins

# Delete a registered tool
afk tools delete my-tool --yes

File Operations

afk files upload ./data.csv --purpose assistants --description "Experiment results"
afk files list --limit 20
afk files download file-abc123 --output ./downloaded.csv

Session Management

afk sessions list                    # List saved sessions
afk sessions load session-id-here    # Resume a previous session

A2A Commands

The afk a2a command group manages the Agent-to-Agent gateway mesh:

# Generate a service token for A2A operations
afk a2a generate-token --profile default

# Register a peer gateway
afk a2a register-peer production-gw https://peer-gateway.example.com/v1 \
  --description "Production Gateway" \
  --tags "production,us-west-2" \
  --registry-url http://gateway-registry:8086

# List all registered peer gateways
afk a2a list-peers --format table

# Test connectivity to a registered peer
afk a2a test-token <token> --gateway-url https://peer-gateway.example.com/v1

Authentication: A2A operations authenticate via Keycloak client credentials. The CLI retrieves service tokens automatically using the configured profile credentials.