docs(sillytavern): post-review polish pass (DEV-1430)

- Clarify installer step 4 — the plugin seeds config.json if absent
- 'Puzzle piece' -> 'three-cubes' for the Extensions icon (current ST UI)
- API key step notes the UI-overrides-config precedence explicitly
- 'Honcho workspace ID' -> 'default Honcho workspace ID (configurable)'
- Add Note after Context-modes table — Context only is session-scoped
  and returns empty until enough messages accumulate; Reasoning is the
  better default for fresh peers
- Next Steps gains two cards: Install SillyTavern (upstream docs) and
  the Claude Code setup skill (skills/setup/SKILL.md)

Follow-ups tracked separately — tool rename (observation -> conclusion,
matching the /conclusion endpoint), architecture Excalidraw.
This commit is contained in:
Erosika 2026-04-21 18:17:17 -04:00
parent 1e7a3461e5
commit 2ffe30bd4f
1 changed files with 16 additions and 4 deletions

View File

@ -43,7 +43,7 @@ The installer:
1. Clones the extension into `public/scripts/extensions/third-party/sillytavern-honcho`
2. Symlinks the server plugin to `plugins/honcho-proxy`
3. Installs the `@honcho-ai/sdk` dependency
4. Detects your `~/.honcho/config.json` if it exists
4. Detects your `~/.honcho/config.json` if it exists (if not, the plugin seeds a minimal one on first run)
### Step 3: Restart SillyTavern
@ -51,10 +51,10 @@ Stop and restart SillyTavern so the server plugin loads. If you have in-progress
### Step 4: Configure
Open **Extensions** (puzzle piece icon) and expand **Honcho Memory**:
Open **Extensions** (three-cubes icon, top-right) and expand **Honcho Memory**:
1. Check **Enable Honcho Memory**
2. Click the API key field to set your key
2. Click the API key field to set your key (if auto-detected from `~/.honcho/config.json`, you can still enter one here to override)
3. Enter your workspace ID
4. Status indicator should show **Ready**
@ -62,7 +62,7 @@ Open **Extensions** (puzzle piece icon) and expand **Honcho Memory**:
If you already use Honcho with other tools (Claude Code, Cursor, Hermes), the extension reads from `~/.honcho/config.json` on startup when resolvable keys are present. Resolution order: `hosts.sillytavern.apiKey` → root-level `apiKey` → fall through to the Extensions-panel key if neither resolves. The Extensions-panel key (SillyTavern's secret manager) takes priority at request time, so entering one in the UI overrides the config file without touching it.
Note that "sillytavern" appears in two namespaces here: as the Honcho workspace ID (a Honcho concept — what you see in the dashboard) and as the `hosts.sillytavern` host key in the config file (a local convention for which tool's settings are which).
Note that "sillytavern" appears in two namespaces here: as the default Honcho workspace ID (a Honcho concept — what you see in the dashboard; configurable) and as the `hosts.sillytavern` host key in the config file (a local convention for which tool's settings are which).
Flat form:
@ -110,6 +110,10 @@ The **enrichment mode** controls what layers on top of the base context:
Both the context and reasoning layers use stale-while-revalidate with configurable refresh intervals. After the first turn of a session, there is zero added latency.
<Note>
**Context only** mode relies on `session.context()`, which is session-scoped — it returns empty output until the session has enough messages for Honcho to derive a representation and summary. For fresh sessions or peers with little history, Reasoning mode is a better default: it queries `peer.chat()` across all of the peer's history, not just the current session.
</Note>
### Tool Call Mode
In tool call mode, the extension registers three function tools that the LLM can invoke:
@ -182,6 +186,14 @@ The server plugin reads API credentials from SillyTavern's secrets store first,
## Next Steps
<CardGroup cols={2}>
<Card title="Install SillyTavern" icon="download" href="https://docs.sillytavern.app/installation/">
New to SillyTavern? Start here — install guide for macOS, Linux, Windows, Docker.
</Card>
<Card title="Claude Code Setup Skill" icon="wand-magic-sparkles" href="https://github.com/plastic-labs/sillytavern-honcho/blob/main/skills/setup/SKILL.md">
Agent-assisted install — idempotent, structural patches, end-to-end verification.
</Card>
<Card title="GitHub Repository" icon="github" href="https://github.com/plastic-labs/sillytavern-honcho">
Source code, issues, and install scripts.
</Card>