skykoi 2026.3.11 → 2026.3.13

package/docs/gateway/bridge-protocol.md

@@ -15,7 +15,7 @@ should use the unified Gateway WebSocket protocol instead.
 If you are building an operator or node client, use the
 [Gateway protocol](/gateway/protocol).
 
-**Note:** Current SkyKoi builds no longer ship the TCP bridge listener; this document is kept for historical reference.
+**Note:** Current SKYKOI builds no longer ship the TCP bridge listener; this document is kept for historical reference.
 Legacy `bridge.*` config keys are no longer part of the config schema.
 
 ## Why we have both
@@ -78,7 +78,7 @@ Payload fields (all optional unless noted):
 ## Tailnet usage
 
 - Bind the bridge to a tailnet IP: `bridge.bind: "tailnet"` in
-  `~/.skykoi/skykoi.json`.
+  `~/.SKYKOI/SKYKOI.json`.
 - Clients connect via MagicDNS name or tailnet IP.
 - Bonjour does **not** cross networks; use manual host/port or wide-area DNS‑SD
   when needed.

package/docs/gateway/cli-backends.md

@@ -9,7 +9,7 @@ title: "CLI Backends"
 
 # CLI backends (fallback runtime)
 
-SkyKoi can run **local AI CLIs** as a **text-only fallback** when API providers are down,
+SKYKOI can run **local AI CLIs** as a **text-only fallback** when API providers are down,
 rate-limited, or temporarily misbehaving. This is intentionally conservative:
 
 - **Tools are disabled** (no tool calls).
@@ -22,16 +22,16 @@ want “always works” text responses without relying on external APIs.
 
 ## Beginner-friendly quick start
 
-You can use Claude Code CLI **without any config** (SkyKoi ships a built-in default):
+You can use Claude Code CLI **without any config** (SKYKOI ships a built-in default):
 
 ```bash
-SkyKoi agent --message "hi" --model claude-cli/opus-4.6
+SKYKOI agent --message "hi" --model claude-cli/opus-4.6
 ```
 
 Codex CLI also works out of the box:
 
 ```bash
-SkyKoi agent --message "hi" --model codex-cli/gpt-5.3-codex
+SKYKOI agent --message "hi" --model codex-cli/gpt-5.3-codex
 ```
 
 If your gateway runs under launchd/systemd and PATH is minimal, add just the
@@ -78,7 +78,7 @@ Add a CLI backend to your fallback list so it only runs when primary models fail
 Notes:
 
 - If you use `agents.defaults.models` (allowlist), you must include `claude-cli/...`.
-- If the primary provider fails (auth, rate limits, timeouts), SkyKoi will
+- If the primary provider fails (auth, rate limits, timeouts), SKYKOI will
   try the CLI backend next.
 
 ## Configuration overview
@@ -135,7 +135,7 @@ The provider id becomes the left side of your model ref:
 ## How it works
 
 1. **Selects a backend** based on the provider prefix (`claude-cli/...`).
-2. **Builds a system prompt** using the same SkyKoi prompt + workspace context.
+2. **Builds a system prompt** using the same SKYKOI prompt + workspace context.
 3. **Executes the CLI** with a session id (if supported) so history stays consistent.
 4. **Parses output** (JSON or plain text) and returns the final text.
 5. **Persists session ids** per backend, so follow-ups reuse the same CLI session.
@@ -162,8 +162,8 @@ imageArg: "--image",
 imageMode: "repeat"
 ```
 
-SkyKoi will write base64 images to temp files. If `imageArg` is set, those
-paths are passed as CLI args. If `imageArg` is missing, SkyKoi appends the
+SKYKOI will write base64 images to temp files. If `imageArg` is set, those
+paths are passed as CLI args. If `imageArg` is missing, SKYKOI appends the
 file paths to the prompt (path injection), which is enough for CLIs that auto-
 load local files from plain paths (Claude Code CLI behavior).
 
@@ -182,7 +182,7 @@ Input modes:
 
 ## Defaults (built-in)
 
-SkyKoi ships a default for `claude-cli`:
+SKYKOI ships a default for `claude-cli`:
 
 - `command: "claude"`
 - `args: ["-p", "--output-format", "json", "--dangerously-skip-permissions"]`
@@ -193,7 +193,7 @@ SkyKoi ships a default for `claude-cli`:
 - `systemPromptWhen: "first"`
 - `sessionMode: "always"`
 
-SkyKoi also ships a default for `codex-cli`:
+SKYKOI also ships a default for `codex-cli`:
 
 - `command: "codex"`
 - `args: ["exec","--json","--color","never","--sandbox","read-only","--skip-git-repo-check"]`
@@ -208,12 +208,12 @@ Override only if needed (common: absolute `command` path).
 
 ## Limitations
 
-- **No SkyKoi tools** (the CLI backend never receives tool calls). Some CLIs
+- **No SKYKOI tools** (the CLI backend never receives tool calls). Some CLIs
   may still run their own agent tooling.
 - **No streaming** (CLI output is collected then returned).
 - **Structured outputs** depend on the CLI’s JSON format.
 - **Codex CLI sessions** resume via text output (no JSONL), which is less
-  structured than the initial `--json` run. SkyKoi sessions still work
+  structured than the initial `--json` run. SKYKOI sessions still work
   normally.
 
 ## Troubleshooting

package/docs/gateway/configuration-examples.md

@@ -1,9 +1,9 @@
 ---
-summary: "Schema-accurate configuration examples for common SkyKoi setups"
+summary: "Schema-accurate configuration examples for common SKYKOI setups"
 read_when:
-  - Learning how to configure SkyKoi
+  - Learning how to configure SKYKOI
   - Looking for configuration examples
-  - Setting up SkyKoi for the first time
+  - Setting up SKYKOI for the first time
 title: "Configuration Examples"
 ---
 
@@ -17,12 +17,12 @@ Examples below are aligned with the current config schema. For the exhaustive re
 
 ```json5
 {
-  agent: { workspace: "~/.skykoi/workspace" },
+  agent: { workspace: "~/.SKYKOI/workspace" },
   channels: { whatsapp: { allowFrom: ["+15555550123"] } },
 }
 ```
 
-Save to `~/.skykoi/skykoi.json` and you can DM the bot from that number.
+Save to `~/.SKYKOI/SKYKOI.json` and you can DM the bot from that number.
 
 ### Recommended starter
 
@@ -34,7 +34,7 @@ Save to `~/.skykoi/skykoi.json` and you can DM the bot from that number.
     emoji: "🦞",
   },
   agent: {
-    workspace: "~/.skykoi/workspace",
+    workspace: "~/.SKYKOI/workspace",
     model: { primary: "anthropic/claude-sonnet-4-5" },
   },
   channels: {
@@ -89,7 +89,7 @@ Save to `~/.skykoi/skykoi.json` and you can DM the bot from that number.
   // Logging
   logging: {
     level: "info",
-    file: "/tmp/SkyKoi/SkyKoi.log",
+    file: "/tmp/SKYKOI/SKYKOI.log",
     consoleLevel: "info",
     consoleStyle: "pretty",
     redactSensitive: "tools",
@@ -97,7 +97,7 @@ Save to `~/.skykoi/skykoi.json` and you can DM the bot from that number.
 
   // Message formatting
   messages: {
-    messagePrefix: "[SkyKoi]",
+    messagePrefix: "[SKYKOI]",
     responsePrefix: ">",
     ackReaction: "👀",
     ackReactionScope: "group-mentions",
@@ -106,7 +106,7 @@ Save to `~/.skykoi/skykoi.json` and you can DM the bot from that number.
   // Routing + queue
   routing: {
     groupChat: {
-      mentionPatterns: ["@SkyKoi", "SkyKoi"],
+      mentionPatterns: ["@SKYKOI", "SKYKOI"],
       historyLimit: 50,
     },
     queue: {
@@ -159,7 +159,7 @@ Save to `~/.skykoi/skykoi.json` and you can DM the bot from that number.
       discord: { mode: "idle", idleMinutes: 10080 },
     },
     resetTriggers: ["/new", "/reset"],
-    store: "~/.skykoi/agents/default/sessions/sessions.json",
+    store: "~/.SKYKOI/agents/default/sessions/sessions.json",
     typingIntervalSeconds: 5,
     sendPolicy: {
       default: "allow",
@@ -192,7 +192,7 @@ Save to `~/.skykoi/skykoi.json` and you can DM the bot from that number.
       dm: { enabled: true, allowFrom: ["steipete"] },
       guilds: {
         "123456789012345678": {
-          slug: "friends-of-SkyKoi",
+          slug: "friends-of-SKYKOI",
           requireMention: false,
           channels: {
             general: { allow: true },
@@ -212,7 +212,7 @@ Save to `~/.skykoi/skykoi.json` and you can DM the bot from that number.
       dm: { enabled: true, allowFrom: ["U123"] },
       slashCommand: {
         enabled: true,
-        name: "SkyKoi",
+        name: "SKYKOI",
         sessionPrefix: "slack:slash",
         ephemeral: true,
       },
@@ -222,7 +222,7 @@ Save to `~/.skykoi/skykoi.json` and you can DM the bot from that number.
   // Agent runtime
   agents: {
     defaults: {
-      workspace: "~/.skykoi/workspace",
+      workspace: "~/.SKYKOI/workspace",
       userTimezone: "America/Chicago",
       model: {
         primary: "anthropic/claude-sonnet-4-5",
@@ -275,9 +275,9 @@ Save to `~/.skykoi/skykoi.json` and you can DM the bot from that number.
       sandbox: {
         mode: "non-main",
         perSession: true,
-        workspaceRoot: "~/.skykoi/sandboxes",
+        workspaceRoot: "~/.SKYKOI/sandboxes",
         docker: {
-          image: "SkyKoi-sandbox:bookworm-slim",
+          image: "SKYKOI-sandbox:bookworm-slim",
           workdir: "/workspace",
           readOnlyRoot: true,
           tmpfs: ["/tmp", "/var/tmp", "/run"],
@@ -342,7 +342,7 @@ Save to `~/.skykoi/skykoi.json` and you can DM the bot from that number.
   // Cron jobs
   cron: {
     enabled: true,
-    store: "~/.skykoi/cron/cron.json",
+    store: "~/.SKYKOI/cron/cron.json",
     maxConcurrentRuns: 2,
   },
 
@@ -352,7 +352,7 @@ Save to `~/.skykoi/skykoi.json` and you can DM the bot from that number.
     path: "/hooks",
     token: "shared-secret",
     presets: ["gmail"],
-    transformsDir: "~/.skykoi/hooks",
+    transformsDir: "~/.SKYKOI/hooks",
     mappings: [
       {
         id: "gmail-hook",
@@ -372,7 +372,7 @@ Save to `~/.skykoi/skykoi.json` and you can DM the bot from that number.
       },
     ],
     gmail: {
-      account: "SkyKoi@gmail.com",
+      account: "SKYKOI@gmail.com",
       label: "INBOX",
       topic: "projects/<project-id>/topics/gog-gmail-watch",
       subscription: "gog-gmail-watch-push",
@@ -391,7 +391,7 @@ Save to `~/.skykoi/skykoi.json` and you can DM the bot from that number.
     mode: "local",
     port: 18789,
     bind: "loopback",
-    controlUi: { enabled: true, basePath: "/SkyKoi" },
+    controlUi: { enabled: true, basePath: "/SKYKOI" },
     auth: {
       mode: "token",
       token: "gateway-token",
@@ -429,7 +429,7 @@ Save to `~/.skykoi/skykoi.json` and you can DM the bot from that number.
 
 ```json5
 {
-  agent: { workspace: "~/.skykoi/workspace" },
+  agent: { workspace: "~/.SKYKOI/workspace" },
   channels: {
     whatsapp: { allowFrom: ["+15555550123"] },
     telegram: {
@@ -493,7 +493,7 @@ If more than one person can DM your bot (multiple entries in `allowFrom`, pairin
     },
   },
   agent: {
-    workspace: "~/.skykoi/workspace",
+    workspace: "~/.SKYKOI/workspace",
     model: {
       primary: "anthropic/claude-sonnet-4-5",
       fallbacks: ["anthropic/claude-opus-4-6"],
@@ -532,7 +532,7 @@ If more than one person can DM your bot (multiple entries in `allowFrom`, pairin
     },
   },
   agent: {
-    workspace: "~/.skykoi/workspace",
+    workspace: "~/.SKYKOI/workspace",
     model: {
       primary: "anthropic/claude-opus-4-6",
       fallbacks: ["minimax/MiniMax-M2.1"],
@@ -550,7 +550,7 @@ If more than one person can DM your bot (multiple entries in `allowFrom`, pairin
     theme: "professional assistant",
   },
   agent: {
-    workspace: "~/work-SkyKoi",
+    workspace: "~/work-SKYKOI",
     elevated: { enabled: false },
   },
   channels: {
@@ -571,7 +571,7 @@ If more than one person can DM your bot (multiple entries in `allowFrom`, pairin
 ```json5
 {
   agent: {
-    workspace: "~/.skykoi/workspace",
+    workspace: "~/.SKYKOI/workspace",
     model: { primary: "lmstudio/minimax-m2.1-gs32" },
   },
   models: {