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"

# Autopilot goal via the TUI /autopilot slash command (loop-native rail)
cd /path/to/repo
soothe
# Inside the TUI: /autopilot greenfield-system Refactor the auth module

# 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-client-python>=1.1.0 - WebSocket transport + wire/display/ux contracts
typer>=0.9.0 - CLI framework
textual>=8.0.0 - TUI framework
rich>=13.0.0 - Console output

Configuration

CLI client settings are passed as global flags on every soothe invocation:

# Connect to a daemon on a non-default host/port
soothe --daemon-host 127.0.0.1 --daemon-port 8765

# Enable debug logging for ~/.soothe/logs/cli.log
soothe --log-level DEBUG

# Disable Markdown rendering in the TUI
soothe --no-render-markdown

Flag	Default	Description
`--daemon-host`	`127.0.0.1`	Daemon WebSocket host
`--daemon-port`	`8765`	Daemon WebSocket port
`--log-level`	`INFO`	CLI log level (`SOOTHE_LOG_LEVEL` env overrides)
`--render-markdown` / `--no-render-markdown`	enabled	Markdown rendering in TUI
`--soothe-home`	`~/.soothe`	Soothe home directory
`--streaming` / `--no-streaming`	daemon default	Override output streaming
`--streaming-mode`	daemon default	`streaming` or `batch`

Global flags apply to subcommands too, e.g. soothe --daemon-port 9000 loop list.

soothed: Server package (agent runtime)
soothe-client-python: WebSocket transport client + shared client-side contracts

Metadata

Release files for soothe-cli 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for soothe-cli 1.1.0
File	Size	Uploaded
soothe_cli-1.1.0.tar.gz	414.3 kB	Oct 13, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for soothe-cli 1.1.0
File	Interpreter	ABI	Platform	Reset
soothe_cli-1.1.0-py3-none-any.whl 490.2 kB Oct 13, 2026	Python 3	none	any	Details

Total release size: 904.5 kB

Release files / soothe_cli-1.1.0.tar.gz

Download URL	soothe_cli-1.1.0.tar.gz
Size	414.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`c1ef48f97e31d528079b68490772be8bd3286efe6632da06e32fe23615da4b79`
BLAKE2b-256 checksum How to use checksums	`a9a2f3895575234529a2a19946b43d1e92b40d63320e2092f90ffe69948a3aa6`
Upload date	Oct 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/mirasoth/soothe
Publishing commit: github.com/mirasoth/soothe/tree/de263f477353f181207a08f6613a9f33cf9e19e4

Workflow

Publishing configuration: github.com/mirasoth/soothe/blob/de263f477353f181207a08f6613a9f33cf9e19e4/.github/workflows/release.yml
Publishing logs: github.com/mirasoth/soothe/actions/runs/38406770157/attempts/1

Artifact

Subject: soothe_cli-1.1.0.tar.gz
SHA-256 checksum: c1ef48f97e31d528079b68490772be8bd3286efe6632da06e32fe23615da4b79 Verifying attestations

Release files / soothe_cli-1.1.0-py3-none-any.whl

Download URL	soothe_cli-1.1.0-py3-none-any.whl
Size	490.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`f7b512b013bec9902325d4c97f502bab53a4b04efe96f45e838e7559b77e4a1a`
BLAKE2b-256 checksum How to use checksums	`cd5d362c3c19c7910d9b0cccbe3c0b0a79bd0086955f25d94806fc35a80cb56d`
Upload date	Oct 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/mirasoth/soothe
Publishing commit: github.com/mirasoth/soothe/tree/de263f477353f181207a08f6613a9f33cf9e19e4

Workflow

Publishing configuration: github.com/mirasoth/soothe/blob/de263f477353f181207a08f6613a9f33cf9e19e4/.github/workflows/release.yml
Publishing logs: github.com/mirasoth/soothe/actions/runs/38406770157/attempts/1

Artifact

Subject: soothe_cli-1.1.0-py3-none-any.whl
SHA-256 checksum: f7b512b013bec9902325d4c97f502bab53a4b04efe96f45e838e7559b77e4a1a Verifying attestations