v1.11.0 — symbi shell (Beta), /deploy stack, init Docker ergonomics, approval relay, cross-instance messaging
[1.11.0] - 2026-04-24
Added
symbi initDocker ergonomics:initnow accepts--dir <PATH>for targeting a mounted volume from inside a container (docker run -v $(pwd):/workspace ... init --dir /workspace), generates a ready-to-rundocker-compose.ymlwith correct volume mounts and env wiring, and writes a.envwith a freshly generatedSYMBIONT_MASTER_KEY(0600 perms) plus a safe-to-commit.env.example. Opt out with--no-docker-compose.symbi upin an empty directory now points the user atsymbi initinstead of silently starting with no agents.initis promoted to the first subcommand insymbi --help. Seedocs/docker.mdfor the new 2-command Docker quickstart.symbi shell— interactive TUI: New first-class subcommand providing a ratatui-based terminal UI for building, orchestrating, and operating agents. Inline viewport with live-streaming tool-call cards, async throbber during LLM calls, markdown + diff renderers, toggleable project-structure sidebar, agent-card widget, diff view, and ORGA-phase-colored trace timeline. Command registry with/help,/clear,/quit,/dsltoggle,/model,/cost,/status, input history, and session UUIDs. Agent lifecycle:/agents,/debug,/stop,/pause,/destroy. AI-assisted authoring:/spawn,/policy,/tool,/behavior(artifacts are persisted to disk). Orchestration: async orchestrator wired for conversational mode,/auditcommand wired to the ORGA journal, automatic context compaction with/compactand/context. Ops:/deploy,/ask,/send,/memory,/run,/chain,/debate,/tools,/skills,/doctor,/logs,/new. Remote attach:/attach,/detach,/cronover HTTP;/channelsvia remote attach;/secretsvia local encrypted store. Session persistence:/snapshot,/resume,/export. Fuzzy@mention+/commandcompletion with grouped popup, auto-trigger on/and@, arrow navigation,@pathcompletion, DSL-aware completion, in-process DSL evaluation in/dslmode./initwith deterministic profiles and conversational mode. Tree-sitter syntax highlighting for the Symbiont DSL plus Cedar and ToolClad. Artifact validation pipeline: constraint loader, DSL validator, Cedar and ToolClad validators. Theme system, OSC-8 hyperlinks, resize handling, transient-retry, Zellij detection with inline-viewport warning,--yes,--profile.- Agent deployment stack:
/deploy localvia Docker with a hardened sandbox runner,/deploy cloudrunfor Google Cloud Run (OSS single-agent), and/deploy awsfor AWS App Runner (OSS single-agent). - Cross-instance agent messaging:
RemoteCommunicationBuswith HTTP messaging endpoints wired intoRuntimeBridge's default context. Cron + heartbeat architecture documented in the spec. symbi-approval-relaycrate: Dual-channel human approval relay.symbi schemapinandsymbi policyCLI subcommands.symbi-invis-stripcrate: Zero-dependency Unicode invisible-stripping helper (ASCII C0/DEL, C1, zero-width, bidi overrides, word-joiner/invisible-operator block, BOM, variation selectors, Unicode Tag block, supplementary variation selectors). Opt-insanitize_field_with_markupvariant additionally strips<!-- ... -->HTML comments and triple-backtick fenced blocks for surfaces where renderer-hidden markup has no legitimate use.- Cedar policy linter (
scripts/lint-cedar-policies.py): Detects homoglyph identifiers and invisible control chars in.cedarfiles. Wired to the repo pre-commit hook and CI test job. - AgentPin fully wired; SchemaPin enforcement hardened.
symbi-e2eend-to-end test crate: Covers AgentPin messaging, API auth scope, cross-runtime bus, Docker volumes, messaging ingress, rate limit, and webhook signature verification.- Opt-in OpenRouter app attribution: Runtime now sets the OpenRouter app-name headers when enabled.
symbi replshim subcommand forwards to therepl-clibinary (mirrors the existingsymbi shellshim) so the command every docs page has referenced is now a first-class subcommand rather than a separately-built binary.
Changed
- OSS vs Enterprise licensing: Documented in the spec and plan.
- Docs rewrite:
docs/index.md,docs/getting-started.md,docs/docker.mdlead with a 2-command Docker init flow. Newdocs/symbi-shell.mdcovers the Beta interactive TUI end-to-end.docs/repl-guide.mdcross-links to the shell.docs/api-reference.mdgains aCLI subcommandssection coveringsymbi schemapin,symbi policy, andsymbi agents-md.docs/runtime-architecture.mdgains aCross-instance agent messagingsubsection.docs/security-model.mdgainsInvisible-Character Sanitization (symbi-invis-strip),Cedar Policy Linter, andHuman Approval Relay (symbi-approval-relay)sections. All five translations (zh-cn, es, pt, ja, de) synced. - Staleness sweep: Fixed broken copy-paste commands across all language variants —
symbiont-runtime→symbi-runtimepackage name, rewrote the Runtime HTTP API quickstart to usesymbi up --http-bind 0.0.0.0+$SYMBI_HTTP_TOKEN(not the non-existentsymbiont-runtime --http-api),docker build -f runtime/Dockerfile .→docker build ., andsymbi-runtime = { version = "1.6" }snippet →"1.11". Documented the previously-undocumentedsymbi newtemplates (webhook-min,webscraper-agent,slm-first,rag-lite) and theOPENROUTER_REFERER/OPENROUTER_TITLEenv vars. /attachscheme policy: Documentation clarified that/attachaccepts HTTP or HTTPS;https://is required for any remote or production target.
Fixed
symbi-shell:/spawn,/policy,/tool,/behaviornow actually persist their artifacts; Enter submits on first press even when the completion popup is visible; content scroll fix with all warnings eliminated; batched UX fixes.- CI: Unblocked minimal build and Docker build, added 4 missing fuzz targets, normalised
cargo fmtacross the workspace, silencedapprox_constantlint, fixed three release-workflow + test issues exposed by v1.10.0. - OSS sync: Include
tests/e2eworkspace member in the OSS allowlist and Docker context.
Security
- 2026-04-18 audit remediation: Closed H-2/H-3/H-4 (reasoning policy gate, SchemaPin SSRF/TLS, parallel-cap enforcement). Hardened medium-severity findings (M-2..M-11 subset) and low-severity findings (L-1, L-3, L-5, L-6).
- SystemTime overflow DoS in the remote envelope parser fixed; Docker proto dependencies and fuzz-target tokio runtime aligned.
- Agent scope enforcement: Applied to every
/api/v1agent, schedule, and channel route. - Bus signature verification enforced; ToolClad custom parsers gated.
- 4 new fuzz targets for the messaging attack surface.
- Dependency CVE patches; remote-bus env var unified; env-touching tests serialised to prevent cross-test interference.
Pre-Built Binaries
Note: Pre-built binaries are tested but considered less reliable than installing via
cargo install symbior Docker (ghcr.io/thirdkeyai/symbi). If you encounter issues, please try those methods first.
Quick Install
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/thirdkeyai/symbiont/main/scripts/install.sh | bashHomebrew (macOS):
brew tap thirdkeyai/tap
brew install symbiManual download:
Download the appropriate binary for your platform from the assets below. Verify checksums with checksums.txt.
Verification
Each binary is signed with Sigstore cosign. Verify with:
cosign verify-blob --certificate symbi-*.pem --signature symbi-*.sig symbi-*.tar.gz \
--certificate-identity-regexp="https://github.com/ThirdKeyAI/Symbiont" \
--certificate-oidc-issuer="https://token.actions.githubusercontent.com"SHA256 checksums are in checksums.txt (also signed).