From ee7ef1f1677f21465f5982c015284cfd3926c7e1 Mon Sep 17 00:00:00 2001 From: Erosika Date: Thu, 23 Apr 2026 12:55:11 -0400 Subject: [PATCH] docs(sillytavern): move Global Config after How It Works --- docs/v3/guides/integrations/sillytavern.mdx | 102 ++++++++++---------- 1 file changed, 51 insertions(+), 51 deletions(-) diff --git a/docs/v3/guides/integrations/sillytavern.mdx b/docs/v3/guides/integrations/sillytavern.mdx index e8923794..9749e69e 100644 --- a/docs/v3/guides/integrations/sillytavern.mdx +++ b/docs/v3/guides/integrations/sillytavern.mdx @@ -55,57 +55,6 @@ Open **Extensions** (puzzle piece icon) and expand **Honcho Memory**: 4. Enter **Your peer name** (saves to `hosts.sillytavern.peerName`; auto-synced from your SillyTavern persona on first boot) 5. Status indicator should show **Ready** -## Global Config (Multi-Tool Setups) - -If you already use Honcho with other tools (Claude Code, Cursor, Hermes), the extension reads from `~/.honcho/config.json` on startup. - -**Resolution order** for `apiKey`, `workspace`, and `peerName`: - -1. `hosts.sillytavern.` (host-specific override) -2. Root-level `` (shared default across tools) -3. For `apiKey` only: fall through to the Extensions-panel key (SillyTavern's secret manager), which takes priority at request time — entering one in the UI overrides the file without touching it. - -**Writes** are scoped to `hosts.sillytavern.*`. The extension never mutates other tools' entries. Panel edits for Workspace ID and peer name save back to `hosts.sillytavern.workspace` and `hosts.sillytavern.peerName` respectively (debounced). Empty values clear the host override and fall through to the root value. - -Flat form (single-tool setup): - -```json -{ - "apiKey": "your-honcho-api-key", - "peerName": "your-name", - "workspace": "sillytavern", - "enabled": true -} -``` - -Nested form (multiple tools sharing the file): - -```jsonc -{ - "apiKey": "hch-v2-...", - "peerName": "alice", - "workspace": "default", - "hosts": { - "sillytavern": { - "workspace": "sillytavern", - "peerName": "alice-rp" - }, - "claude_code": { "...": "..." }, - "cursor": { "...": "..." } - } -} -``` - -### Disable / Enable global config - -A toggle button in the panel opts out of auto-detection entirely. When disabled, the extension skips the config fetch on load, hides the source line, and saves peer-name edits to the local SillyTavern extension settings instead of the global file. Re-enabling opens a diff-aware dialog if local and global values diverge, offering: - -- **Inherit** — pull global values into this SillyTavern install -- **Push local** — overwrite the global host entry with your local values -- **Cancel** — leave both untouched - -Empty local values are never pushed, so a blank field cannot accidentally delete a host key. - ## How It Works ### Context Architecture @@ -166,6 +115,57 @@ By default, only the user peer accumulates derived memory — Honcho observes th | User sends message | Stores message in Honcho session | | AI responds | Stores response in Honcho session | +## Global Config (Multi-Tool Setups) + +If you already use Honcho with other tools (Claude Code, Cursor, Hermes), the extension reads from `~/.honcho/config.json` on startup. + +**Resolution order** for `apiKey`, `workspace`, and `peerName`: + +1. `hosts.sillytavern.` (host-specific override) +2. Root-level `` (shared default across tools) +3. For `apiKey` only: fall through to the Extensions-panel key (SillyTavern's secret manager), which takes priority at request time — entering one in the UI overrides the file without touching it. + +**Writes** are scoped to `hosts.sillytavern.*`. The extension never mutates other tools' entries. Panel edits for Workspace ID and peer name save back to `hosts.sillytavern.workspace` and `hosts.sillytavern.peerName` respectively (debounced). Empty values clear the host override and fall through to the root value. + +Flat form (single-tool setup): + +```json +{ + "apiKey": "your-honcho-api-key", + "peerName": "your-name", + "workspace": "sillytavern", + "enabled": true +} +``` + +Nested form (multiple tools sharing the file): + +```jsonc +{ + "apiKey": "hch-v2-...", + "peerName": "alice", + "workspace": "default", + "hosts": { + "sillytavern": { + "workspace": "sillytavern", + "peerName": "alice-rp" + }, + "claude_code": { "...": "..." }, + "cursor": { "...": "..." } + } +} +``` + +### Disable / Enable global config + +A toggle button in the panel opts out of auto-detection entirely. When disabled, the extension skips the config fetch on load, hides the source line, and saves peer-name edits to the local SillyTavern extension settings instead of the global file. Re-enabling opens a diff-aware dialog if local and global values diverge, offering: + +- **Inherit** — pull global values into this SillyTavern install +- **Push local** — overwrite the global host entry with your local values +- **Cancel** — leave both untouched + +Empty local values are never pushed, so a blank field cannot accidentally delete a host key. + ## Architecture ```