https://sonny.sh/tags/reference/Recent content on ReferenceHugo 0.139.4en-usSat, 24 Oct 2026 00:00:00 +0000https://sonny.sh/docs/cli/Sat, 24 Oct 2026 00:00:00 +0000https://sonny.sh/docs/cli/CLIclicommandsreferenceReference for the sonny command line: the run command, configuration, credentials, init, mesh and recipe (recipe) commands, with exact flags and defaults.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/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/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/tui/Sat, 24 Oct 2026 00:00:00 +0000https://sonny.sh/docs/tui/DocumentationtuireferenceA walkthrough of every region of the Sonny TUI, with rendered captures taken from the repository’s own golden test fixtures and reference documentation rather than from a live session.https://sonny.sh/docs/tui/shortcuts/Sat, 24 Oct 2026 00:00:00 +0000https://sonny.sh/docs/tui/shortcuts/DocumentationtuireferenceThe complete keybinding reference for the Sonny terminal UI: which bindings are remappable in tui.yaml and which are fixed, how the transcript window moves, how find behaves after SONNY-2560, and why ctrl+→ selects a hint instead of moving the caret.https://sonny.sh/docs/configuration/Fri, 23 Oct 2026 00:00:00 +0000https://sonny.sh/docs/configuration/ConfigurationconfigurationreferenceThe layout of Sonny’s configuration: XDG directories, the .sonny.yaml file, the precedence chain, environment variables, and project dotfiles.https://sonny.sh/docs/glossary/Fri, 23 Oct 2026 00:00:00 +0000https://sonny.sh/docs/glossary/DocumentationreferenceconceptsOne-paragraph definitions of Sonny’s vocabulary, each pointing at the page that goes deeper: recipe terms, provider and model terms, session and mesh terms, and the approval and authority vocabulary.https://sonny.sh/docs/troubleshooting/Fri, 23 Oct 2026 00:00:00 +0000https://sonny.sh/docs/troubleshooting/DocumentationtroubleshootingreferenceEvery quoted error string reproduced from the binary, with its cause and its fix, plus the diagnostic commands to run when no row matches.