Define intent. Let Soothe handle the rest.
Soothe is a goal-driven orchestration framework for 24/7 autonomous agents. It keeps humans out of the execution loop: you describe what you want, and Soothe plans, executes, and steers the work to completion — across sessions, across goals, across time.
Built on soothe-nano and an enhanced deepagents, it adds a persistent agentic loop and goal engine: context carries across sessions, long-running goals keep moving, and interdependent objectives coordinate through a typed dependency graph. Move from human-in-the-loop to agent-in-the-loop.
We believe autonomous agents should work the way great teams do: given a clear objective, they plan, act, remember, and adapt — without someone watching every step.
Soothe is built on five ideas:
- 🎯 Goals, not prompts — A goal is a first-class, persisted entity with its own lifecycle, not a string in a prompt. Soothe tracks dependencies between goals, coordinates them, and keeps each one moving.
- 🔁 A loop that thinks — StrangeLoop is a compiled plan → assess → execute graph that actively pulls the next ready goal and reports back. Two-phase planning keeps it frugal; evidence-bound steps keep it honest.
- 🧠 One memory, one truth — A single DAG is the source of truth for goals, steps, and the message ledger. Every record stores the reasoning that created it, so projections show why, not just what.
- 🔄 Always-on, never-loses — A persistent daemon owns 24/7 state.
/detachkeeps a loop running while your client exits; crash recovery bounds re-execution loss to one bundle of work per goal. - 🌐 One wire contract — A published AsyncAPI 3.0 spec is the single source of truth for the WebSocket protocol. Schema validation at the transport boundary, capability negotiation, full
subscribe → next → completelifecycle. No compatibility shims.
| Capability | Features |
|---|---|
| Autonomous Execution | Multi-step workflows, file ops, code execution, shell commands |
| Long-Running Ops | Background daemon, thread/loop management, persistent state, /detach / /reattach |
| Custom Plugins | @tool, @subagent, @plugin decorators, MCP server integration |
| Status | Milestone |
|---|---|
| ✅ | Single-Session Autonomy — End-to-end goal execution |
| ✅ | Cross-Thread Continuity — Persistent context across threads |
| ✅ | Multi-Goal Orchestration — Interdependent long-horizon workflows |
| ⏳ | Benchmark Reproduction — Compiler experiment |
pip install -U soothe-cli soothe-daemon
soothed setup
soothed start
soothe -p "Your first task"# requires a running daemonOr submit a long-running Autopilot job from a GOAL.md:
soothed start
cd /path/to/repo
soothe autopilot submit -f GOAL.md --rail greenfield-system
soothe autopilot top # live jobs / goals / loops dashboard📖 Quick Start guide — install, Docker, local daemon, first prompt.
| Package | Latest | |
|---|---|---|
| Python | soothe-client-python |  |
| TypeScript | @mirasoth/soothe-client |  |
| Go | soothe-client-go |  |
| Rust | soothe-client |  |
📖 Clients guide — install, API tiers, protocol notes.
| Resource | Description |
|---|---|
| Wiki | User, operator, and developer guides |
| Quick Start | Install, daemon, first prompt |
| Language clients | Python / TypeScript / Go / Rust WebSocket SDKs |
| Configuration guide | YAML, env vars, zero-config |
| RFCs | Architecture specs |
| AGENTS.md | AI agent dev guide |
MIT