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 job from GOAL.md (greenfield-system rail)
cd /path/to/repo
soothe autopilot submit -f GOAL.md --rail greenfield-system
soothe autopilot top
# 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>=1.0.0- events, display, wire contractstyper>=0.9.0- CLI frameworktextual>=8.0.0- TUI frameworkrich>=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.
Related Packages
- soothed: Server package (agent runtime)
- soothe-sdk: Shared SDK (WebSocket client, types)
1 maintainer
Metadata
1 maintainer
Release files for soothe-cli 1.0.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| soothe_cli-1.0.8.tar.gz | 403.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| soothe_cli-1.0.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 881.2 kB
Release files / soothe_cli-1.0.8.tar.gz
| Download URL | soothe_cli-1.0.8.tar.gz |
|---|---|
| Size | 403.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2dad35970cf1623cde68ecdf7c9a0097afb1a7dd755d6a15f7d4174ea6df245a
|
|
BLAKE2b-256 checksum How to use checksums |
f532ed8aa8cd48b117aa4513738c486687903cc64abc9451a8c34fd6163ec659
|
| Upload date | |
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 9, 2026.
Transparency logRelease files / soothe_cli-1.0.8-py3-none-any.whl
| Download URL | soothe_cli-1.0.8-py3-none-any.whl |
|---|---|
| Size | 477.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c23f0bb265c8c07863d98855bdae8db321ac9bbef197221c73c485a004f85d4c
|
|
BLAKE2b-256 checksum How to use checksums |
6b256200c318db0771b894aa33eb1e58d6015cae3d8e1609149922b6d8060455
|
| Upload date | |
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 9, 2026.
Transparency log
