soothe-cli 0.5.0

Soothe CLI client - communicates with daemon via WebSocket

Soothe CLI Client

WebSocket-based CLI client for Soothe daemon.

Installation

pip install soothe-cli

Usage

The soothe command provides both CLI and TUI interfaces:

# Interactive TUI mode
soothe

# Headless single-prompt mode
soothe -p "Research AI advances"

# Loop management
soothe loop list
soothe loop continue loop_abc123

Architecture

This package is the client component that communicates with the Soothe daemon via WebSocket.

• No direct dependencies on daemon runtime - all communication through WebSocket
• Lightweight dependencies - only typer, textual, rich, and SDK
• WebSocket-only transport - bidirectional streaming protocol

Dependencies

• soothe-sdk>=0.2.0 - WebSocket client, protocol, types
• typer>=0.9.0 - CLI framework
• textual>=8.0.0 - TUI framework
• rich>=13.0.0 - Console output

Configuration

CLI uses cli_config.yml:

daemon:
  transports:
    websocket:
      host: "127.0.0.1"
      port: 8765

# Optional: logging_level for ~/.soothe/logs/soothe-cli.log (DEBUG, INFO, …)
# logging_level: INFO

tui:
  theme: "default"

Related Packages

• soothed: Server package (agent runtime)
• soothe-sdk: Shared SDK (WebSocket client, types)