Skip to main content

CLI

The chatwalaau command runs the server and acts as a client to a running instance.

Server commands​

chatwalaau                                Start the server
chatwalaau init                           Generate .env from template
chatwalaau init --force                   Overwrite existing .env
chatwalaau env diff                       Report .env drift vs the bundled template
chatwalaau env sync                       Re-render .env to the template (dry-run)
chatwalaau env sync --write               Apply (timestamped backup first)
chatwalaau hash-password                  Generate AUTH_PASSWORD_HASH (interactive)
chatwalaau hash-password --stdin --quiet  Generate hash from stdin (scripted)
chatwalaau --host 0.0.0.0                 Bind to all interfaces
chatwalaau --port 9000                    Use a custom port
chatwalaau --skip-auth-check              Skip the Azure CLI login check
chatwalaau --ssl-certfile cert.pem \
           --ssl-keyfile key.pem          Enable HTTPS (LAN access)
chatwalaau --version                      Show version

Client commands​

Interact with a running instance from the command line. All client commands support --json for machine-readable output and --base-url / --api-key for remote servers.

# Chat with the agent (single-shot)
chatwalaau chat "What is the weather in Tokyo?"

# Interactive chat (REPL mode)
chatwalaau chat -i

# Specific model and session
chatwalaau chat "hello" -m gpt-4o -s <session-id>

# Sessions
chatwalaau sessions list
chatwalaau sessions get <id> --messages
chatwalaau sessions delete <id>
chatwalaau sessions export <id> -o backup.json

# Templates
chatwalaau templates list
chatwalaau templates create -n "Bug Report" -c "Describe the bug..."

# Models
chatwalaau models list

# Text-to-Speech
chatwalaau tts "Hello world" -o greeting.mp3

# File upload
chatwalaau upload document.pdf -s <session-id>

# JSON output for scripting / agent-to-agent
chatwalaau sessions list --json | jq '.[].thread_id'

# Remote server with HTTPS (self-signed cert)
chatwalaau sessions list --base-url https://192.168.1.10:8000 --no-verify

chatwalaau upload validates the file before sending: it must exist, the sanitized filename must stay valid, the MIME type must be a supported image format or PDF, and the size must be within 20MB (images) or 50MB (PDFs).

Client configuration​

CHATWALAAU_URL=http://localhost:8000     # default server URL
CHATWALAAU_API_KEY=sk-your-key           # Bearer token (reuses API_KEY if unset)