Command Reference

This page provides a complete reference for all Wabee CLI commands.

task

Send tasks to the agent and receive responses.

task new

Start a new task with the agent.

wabee task new [message]

Options:

Option	Default	Description
`--stream`	`true`	Stream response in real-time

Examples:

# Simple message
wabee task new "What is the weather in NYC?"

# Disable streaming
wabee task new --stream=false "Quick question"

# Pipe input from file
cat prompt.txt | wabee task new

# Output as JSON
wabee task new --output json "List 5 items"

Output:

In streaming mode (default), the CLI shows live status updates while the agent processes your request:

Thinking... - Agent is processing the request
Planning... - Agent is planning its approach
Reasoning... - Agent is reasoning about the task
Selecting tool... - Agent is choosing a tool to use
Executing tool... - Agent is running a tool
Processing tool output... - Agent is analyzing tool results
Delegating to sub-agent... - Agent is delegating to another agent

After completion, the response is displayed along with the session and request IDs for reference.

task followup

Continue a conversation in an existing session.

wabee task followup --session <session-id> [message]

Options:

Option	Short	Required	Default	Description
`--session`	`-s`	Yes		Session ID to continue
`--stream`		No	`true`	Stream response in real-time

Examples:

# Continue a conversation
wabee task followup --session abc123 "And tomorrow?"

# Stream the response
wabee task followup --session abc123 --stream "Tell me more"

# Pipe input from file
cat followup.txt | wabee task followup --session abc123

sessions

Manage and inspect agent sessions.

sessions list

List recent sessions.

wabee sessions list

Options:

Option	Default	Description
`--limit`	`10`	Maximum number of sessions to return
`--before`		Return sessions before this session ID (for pagination)

Examples:

# List recent sessions
wabee sessions list

# List more sessions
wabee sessions list --limit 20

# Paginate through sessions
wabee sessions list --before abc123

sessions get

Get detailed information about a specific session.

wabee sessions get <session-id>

Examples:

# Get session details
wabee sessions get abc123

# Output as JSON
wabee sessions get abc123 --output json

sessions trace

View the execution trace for a session. This is useful for debugging agent behavior and understanding how the agent processed a request.

wabee sessions trace <session-id>

Options:

Option	Default	Description
`--request-id`		Filter by specific request ID
`--max-content-length`	`200`	Maximum content length to display
`--full`	`false`	Show full content without truncation

Examples:

# View trace
wabee sessions trace abc123

# Filter by request
wabee sessions trace abc123 --request-id req-001

# Show full content
wabee sessions trace abc123 --full

# Set max content length
wabee sessions trace abc123 --max-content-length 500

# Output as tree view
wabee sessions trace abc123 --output tree

# Output as JSON
wabee sessions trace abc123 --output json

agent

Get information about the connected agent.

agent info

Display metadata about the connected agent.

wabee agent info

Examples:

# Get agent info
wabee agent info

# Output as JSON
wabee agent info --output json

agent tools

List all tools available to the agent.

wabee agent tools

Examples:

# List tools
wabee agent tools

# Output as table
wabee agent tools --output table

# Output as JSON
wabee agent tools --output json

config

Manage CLI configuration.

config init

Initialize the CLI configuration interactively.

wabee config init

This command guides you through setting up your API endpoint and credentials.

config set

Set a configuration value.

wabee config set <key> <value>

Available keys:

Key	Description
`endpoint`	API endpoint URL
`api-key`	API key for authentication
`auth-token`	Authentication token
`timeout`	Request timeout in seconds
`output`	Default output format (json, table, text, tree)
`stream`	Default streaming mode (true/false)
`color`	Color output mode (auto, always, never)

Examples:

wabee config set endpoint https://your-agent.wabee.ai
wabee config set api-key your-api-key
wabee config set timeout 120
wabee config set output json

config show

Display the current configuration settings.

wabee config show

Use --verbose to see all profiles and sensitive information.

config use

Switch to a different profile.

wabee config use <profile>

Example:

wabee config use production

config profile

Manage configuration profiles.

config profile list

List available profiles.

wabee config profile list

config profile create

Create a new profile interactively.

wabee config profile create <name>

config profile set

Set the active profile.

wabee config profile set <name>

config profile delete

Delete a profile.

wabee config profile delete <name>

version

Print version information.

wabee version

Use --verbose to see commit hash and build date.

Global Options

These options can be used with any command:

Option	Short	Description
`--config`		Path to config file (default: `~/.wabee/config.yaml`)
`--endpoint`	`-e`	API endpoint URL
`--api-key`	`-k`	API key
`--profile`	`-p`	Configuration profile
`--output`	`-o`	Output format (json, table, text, tree)
`--quiet`	`-q`	Suppress non-essential output
`--verbose`	`-v`	Verbose output
`--no-color`		Disable colors
`--timeout`		Request timeout (seconds)

Output Formats

The CLI supports multiple output formats:

Format	Description
`text`	Human-readable text output (default)
`json`	JSON output for parsing and automation
`table`	Formatted table output
`tree`	Tree view (useful for traces)

Example:

# Default text output
wabee task new "Hello"

# JSON for scripting
wabee task new --output json "Hello" | jq '.answer'

# Table format
wabee sessions list --output table