https://sonny.sh/Recent contentHugo 0.139.4en-usSat, 24 Oct 2026 00:00:00 +0000https://sonny.sh/docs/clients/desktop/Fri, 23 Oct 2026 00:00:00 +0000https://sonny.sh/docs/clients/desktop/clientsdesktopwails Desktop App Share link Share this section Permalink Share via Twitter LinkedIn Facebook The Sonny desktop app is a Wails v2 shell around the same React UI the other clients use, bound to exactly seven narrow Go facades. It does not run sessions itself; it connects to the shared user-scoped supervisor. See Client Apps for that model and for what closing a window does and does not stop.https://sonny.sh/docs/cli/overview/Sat, 24 Oct 2026 00:00:00 +0000https://sonny.sh/docs/cli/overview/CLIcliflagsexit-codesGlobal flags shared by every sonny command, the bare-sonny alias for run, and the exit codes each classified outcome returns.https://sonny.sh/docs/getting-started/Fri, 23 Oct 2026 00:00:00 +0000https://sonny.sh/docs/getting-started/getting-startedinstallquickstart Getting Started Share link Share this section Permalink Share via Twitter LinkedIn Facebook This page takes you from a machine with nothing installed to a working Sonny chat session. Sonny is commercial software; use the distribution and access provided for your organization. See Licensing and access .https://sonny.sh/docs/clients/vscode/Fri, 23 Oct 2026 00:00:00 +0000https://sonny.sh/docs/clients/vscode/clientsvscodeeditor VS Code Extension Share link Share this section Permalink Share via Twitter LinkedIn Facebook The sonny-vscode extension is a complete Sonny session surface for VS Code. It reuses the same React session UI and daemon client as the desktop application without starting a second agent runtime.https://sonny.sh/docs/mcp/configuration/Sat, 24 Jan 2026 00:00:00 +0000https://sonny.sh/docs/mcp/configuration/mcpconfigurationreference MCP Configuration Share link Share this section Permalink Share via Twitter LinkedIn Facebook Where the files live Share link File Location User sidecar config mcp.yaml in the profile config directory — $XDG_CONFIG_HOME/sonny when set, otherwise the platform-native location Project chain .sonny/mcp.yaml in every directory from the cwd up to the filesystem root Allowlist mcp.allowlist.yaml, in the same profile config directory as the sidecar config --mcp-config <path> on sonny run, sonny mcp list, sonny tools list and sonny recipe resolve overrides the user sidecar path for that invocation only. It does not move the project chain or the allowlist.https://sonny.sh/docs/packs/authoring/Sat, 24 Oct 2026 14:57:28 -0400https://sonny.sh/docs/packs/authoring/ Authoring Recipes Share link Share this section Permalink Share via Twitter LinkedIn Facebook Learn how to create recipes for Sonny.https://sonny.sh/docs/cli/run/Sat, 24 Oct 2026 00:00:00 +0000https://sonny.sh/docs/cli/run/CLIclirunheadlessFull flag reference for sonny run: recipe discovery, isolation overrides, the –dangerously-* modes and their policy refusals, headless –prompt/–result-json, and –mesh-self.https://sonny.sh/docs/install/Fri, 23 Oct 2026 00:00:00 +0000https://sonny.sh/docs/install/Getting StartedinstallpackagesreleaseSonny ships as a single static binary plus an optional desktop package. This page covers every install path and how to confirm the result. If you just want the fastest route to a first session, use Getting Started . Version covered These instructions apply to Sonny 0.12.1. Run sonny version to check what is installed on your machine. Requirements Share link Share this section Permalink Share via Twitter LinkedIn Facebook Building from source needs Go 1.27.1 or newer (go.mod pins go 1.27.1). The Linux release binary and the deb/rpm/apk packages are built with cgo enabled (for the mesh identity resolvers), so they need a glibc-compatible Linux. The macOS and Windows binaries are cgo-free. No recipes are preinstalled. Sonny ships with one embedded recipe (sonny-base); everything else you add yourself through recipe sources . Pre-built binaries Share link Every tagged release publishes an archive per OS/architecture:https://sonny.sh/docs/clients/neovim/Fri, 23 Oct 2026 00:00:00 +0000https://sonny.sh/docs/clients/neovim/clientsneovimcompletion Neovim Plugin Share link Share this section Permalink Share via Twitter LinkedIn Facebook sonny-neovim is an AI code completion plugin for Neovim. Unlike the desktop and VS Code clients, it does not attach to the shared supervisor: it runs its own sonny-daemon and focuses on inline completion rather than agent sessions.https://sonny.sh/docs/mcp/trust-model/Sat, 24 Jan 2026 00:00:00 +0000https://sonny.sh/docs/mcp/trust-model/mcpsecurityreference MCP Trust Model Share link Share this section Permalink Share via Twitter LinkedIn Facebook A configured MCP server is not an approved MCP server. Configuration says what exists; approval decides what runs. Two gates sit between them, and both apply to every surface that enumerates tools — a TUI tab, a headless run, a sub-agent, sonny mcp list --connect, sonny tools list --mcp-config and sonny recipe resolve --connect. A surface that can only list tools is not a way around either gate.https://sonny.sh/docs/packs/providers/Sat, 24 Oct 2026 13:00:54 -0400https://sonny.sh/docs/packs/providers/ Supported Providers Share link Share this section Permalink Share via Twitter LinkedIn Facebook Sonny supports multiple LLM providers. Each provider has specific configuration requirements.https://sonny.sh/docs/cli/chat/Sat, 24 Oct 2026 00:00:00 +0000https://sonny.sh/docs/cli/chat/CLIclichatinteractionDocumentation for the ‘chat’ command in Sonny CLI, including usage, flags, and examples.https://sonny.sh/docs/mcp/servers/Sat, 24 Jan 2026 00:00:00 +0000https://sonny.sh/docs/mcp/servers/mcpreference MCP Server Catalog Share link Share this section Permalink Share via Twitter LinkedIn Facebook Ten MCP servers ship under the sonny.sh/mcp/ namespace. Each is its own Go module in its own private repository. The sonny.sh/mcp/<name> pages provide machine-readable go-import metadata for authorized consumers. Browser visitors stay on the public documentation site. These modules are commercial software; see Licensing and access .https://sonny.sh/docs/packs/models/Sat, 24 Oct 2026 13:00:54 -0400https://sonny.sh/docs/packs/models/ Model Configuration Share link Share this section Permalink Share via Twitter LinkedIn Facebook Sonny allows you to configure models for specific tasks.https://sonny.sh/docs/cli/init/Sat, 24 Oct 2026 00:00:00 +0000https://sonny.sh/docs/cli/init/CLIcliinitprojectWhat sonny init creates, its flags, and the init defaults and init project setup subcommands.https://sonny.sh/docs/packs/credentials/Sat, 24 Oct 2026 13:00:54 -0400https://sonny.sh/docs/packs/credentials/ Credential Management Share link Share this section Permalink Share via Twitter LinkedIn Facebook Sonny securely manages credentials for LLM providers.https://sonny.sh/docs/cli/config/Sat, 24 Oct 2026 00:00:00 +0000https://sonny.sh/docs/cli/config/CLIcliconfigsettingsThe sonny config subcommands and their exact flags: show, explain, validate, init, path and resource-reuse, including how precedence is reported.https://sonny.sh/docs/packs/troubleshooting/Sat, 24 Oct 2026 14:57:28 -0400https://sonny.sh/docs/packs/troubleshooting/ Troubleshooting Share link Share this section Permalink Share via Twitter LinkedIn Facebook Resolve common issues in Sonny.https://sonny.sh/docs/cli/pack/Sat, 24 Oct 2026 00:00:00 +0000https://sonny.sh/docs/cli/pack/CLIclipackpacksThe recipe/pack command group: tracked git-backed pack sources, the add flags that control pinning, model catalogs and MCP approval, plus list, default, update, reload and remove.https://sonny.sh/docs/cli/mesh/Sat, 24 Oct 2026 00:00:00 +0000https://sonny.sh/docs/cli/mesh/CLIclimeshdistributedThe sonny mesh command group: mesh serve listener flags, push/attach/detach/transfer/terminate, node and session inspection, and the persistent mTLS client flags.