marius-kilocode · Oct 23, 2026 · Oct 20, 2026 · Oct 20, 2026 · Oct 20, 2026 · Oct 20, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,64 @@
 
 Release notes for OpenCode V2, newest first.
 
+## v2.1.2 — 2026-10-21
+
+### Highlights
+
+- **Clear Free-Limit Recovery**: When your free messages run out, Desktop and the TUI now show the reset time, restore your submitted prompt, and offer direct upgrade or model-switching actions instead of a generic error. ([#57466](https://github.com/anomalyco/opencode/pull/57466), [#57467](https://github.com/anomalyco/opencode/pull/57467), [#57471](https://github.com/anomalyco/opencode/pull/57471))
+- **Hide Free Models**: Set `OPENCODE_DISABLE_FREE_MODELS=1` or `true` to remove zero-cost models from OpenCode and OpenCode Go catalogs, defaults, and fallbacks. ([#57478](https://github.com/anomalyco/opencode/pull/57478))
+- **Configurable Location Unloading**: Set `experimental.location_idle_timeout` to a duration such as `"4 hours"`, or to `false`, to control when inactive location services unload. ([#57476](https://github.com/anomalyco/opencode/pull/57476))
+- **Reliable Fresh Installs**: The installer now creates `~/.zshrc` or Fish’s `config.fish` when missing, adds OpenCode to `PATH`, and tells you to run `exec $SHELL`. ([#57348](https://github.com/anomalyco/opencode/pull/57348))
+
+### Core
+
+#### Improvements
+
+- Added `OPENCODE_DISABLE_FREE_MODELS` for hiding free OpenCode and OpenCode Go models. ([#57478](https://github.com/anomalyco/opencode/pull/57478))
+- Added `experimental.location_idle_timeout`, accepting a duration string or `false`. ([#57476](https://github.com/anomalyco/opencode/pull/57476))
+
+#### Bug fixes
+
+- Fixed fresh zsh and Fish installations not adding OpenCode to `PATH` when their configuration file did not exist. ([#57348](https://github.com/anomalyco/opencode/pull/57348))
+- Kept locations loaded while sessions are waiting for input, running long tools, or owning background jobs. ([#57416](https://github.com/anomalyco/opencode/pull/57416))
+- Fixed legacy `console.opencode.ai` credentials not being forwarded to `opencode.ai/console`. ([#57588](https://github.com/anomalyco/opencode/pull/57588))
+- Reused recent Console configuration checks when inference is rejected, avoiding unnecessary repeated checks. ([#57465](https://github.com/anomalyco/opencode/pull/57465))
+
+### TUI
+
+#### Improvements
+
+- Added an inline free-limit notice with the reset time and `/connect` and `/models` actions, while restoring the submitted prompt when the composer is empty. ([#57467](https://github.com/anomalyco/opencode/pull/57467))
+- Restored the animated “Free limit reached” OpenCode Go dialog with **Subscribe**, **Dismiss**, and **Don’t show again** actions. ([#57471](https://github.com/anomalyco/opencode/pull/57471))
+
+#### Bug fixes
+
+- Stopped showing redundant failure notifications when the free-message limit is reached. ([#57467](https://github.com/anomalyco/opencode/pull/57467))
+- Only shows “location unavailable” when the server explicitly reports the location as missing. ([#57594](https://github.com/anomalyco/opencode/pull/57594))
+
+### Desktop
+
+#### Bug fixes
+
+- Restored the free-limit dialog, reset-time timeline notice, and submitted prompt after free usage is exhausted. Subscribing to OpenCode Go now updates the current session’s model instead of opening another draft. ([#57466](https://github.com/anomalyco/opencode/pull/57466))
+
+### SDK
+
+#### Improvements
+
+- Added `retryAfterMs` to structured session errors so clients can display provider-supplied retry timing. ([#57146](https://github.com/anomalyco/opencode/pull/57146))
+
+#### Bug fixes
+
+- Fixed retry timing being dropped from quota, rate-limit, and provider-internal session errors. ([#57589](https://github.com/anomalyco/opencode/pull/57589))
+- Fixed OpenAI realtime client-secret requests by supplying the required `expires_after.anchor`.
+
+### Extensions
+
+#### Bug fixes
+
+- Fixed Code Mode async jobs interleaving in the middle of statements and losing writes, while preserving concurrent tool calls. Thanks [@RhysSullivan](https://github.com/RhysSullivan)! ([#54276](https://github.com/anomalyco/opencode/pull/54276))
+
 ## v2.1.0 — 2026-10-20
 
 ### Highlights

diff --git a/bun.lock b/bun.lock
diff --git a/bunfig.toml b/bunfig.toml
@@ -2,7 +2,7 @@
 exact = true
 # Only install newly resolved package versions published at least 3 days ago.
 minimumReleaseAge = 259200
-minimumReleaseAgeExcludes = ["@ai-sdk/amazon-bedrock", "@ai-sdk/anthropic", "@brendonovich/vite-plugin-opencode", "@kitlangton/solid-motion", "@opencode/sdk", "@opencode-ai/pty", "@opencode-ai/pty-darwin-arm64", "@opencode-ai/pty-darwin-x64", "@opencode-ai/pty-linux-arm64-gnu", "@opencode-ai/pty-linux-arm64-musl", "@opencode-ai/pty-linux-x64-gnu", "@opencode-ai/pty-linux-x64-musl", "@opencode-ai/pty-win32-arm64", "@opencode-ai/pty-win32-x64", "@opentui/core", "@opentui/core-darwin-arm64", "@opentui/core-darwin-x64", "@opentui/core-linux-arm64", "@opentui/core-linux-arm64-musl", "@opentui/core-linux-x64", "@opentui/core-linux-x64-musl", "@opentui/core-win32-arm64", "@opentui/core-win32-x64", "@opentui/keymap", "@opentui/solid", "@opentunnel/client", "@opentunnel/protocol", "gitlab-ai-provider", "opencode-gitlab-auth", "@ff-labs/fff-node", "@ff-labs/fff-bun", "@ff-labs/fff-bin-darwin-arm64", "@ff-labs/fff-bin-darwin-x64", "@ff-labs/fff-bin-linux-arm64-gnu", "@ff-labs/fff-bin-linux-arm64-musl", "@ff-labs/fff-bin-linux-x64-gnu", "@ff-labs/fff-bin-linux-x64-musl", "@ff-labs/fff-bin-win32-arm64", "@ff-labs/fff-bin-win32-x64", "@pierre/diffs", "@pierre/theming", "app-builder-lib", "dmg-builder", "electron", "electron-builder", "electron-publish", "blume", "mermaid"]
+minimumReleaseAgeExcludes = ["@ai-sdk/amazon-bedrock", "@ai-sdk/anthropic", "@brendonovich/vite-plugin-opencode", "@kitlangton/solid-motion", "@opencode/sdk", "@opencode-ai/pty", "@opencode-ai/pty-darwin-arm64", "@opencode-ai/pty-darwin-x64", "@opencode-ai/pty-linux-arm64-gnu", "@opencode-ai/pty-linux-arm64-musl", "@opencode-ai/pty-linux-x64-gnu", "@opencode-ai/pty-linux-x64-musl", "@opencode-ai/pty-win32-arm64", "@opencode-ai/pty-win32-x64", "@opentui/core", "@opentui/core-darwin-arm64", "@opentui/core-darwin-x64", "@opentui/core-linux-arm64", "@opentui/core-linux-arm64-musl", "@opentui/core-linux-x64", "@opentui/core-linux-x64-musl", "@opentui/core-win32-arm64", "@opentui/core-win32-x64", "@opentui/keymap", "@opentui/solid", "@opentunnel/client", "@opentunnel/protocol", "gitlab-ai-provider", "opencode-gitlab-auth", "@ff-labs/fff-node", "@ff-labs/fff-bun", "@ff-labs/fff-bin-darwin-arm64", "@ff-labs/fff-bin-darwin-x64", "@ff-labs/fff-bin-linux-arm64-gnu", "@ff-labs/fff-bin-linux-arm64-musl", "@ff-labs/fff-bin-linux-x64-gnu", "@ff-labs/fff-bin-linux-x64-musl", "@ff-labs/fff-bin-win32-arm64", "@ff-labs/fff-bin-win32-x64", "@pierre/diffs", "@pierre/highlights", "@pierre/theming", "app-builder-lib", "dmg-builder", "electron", "electron-builder", "electron-publish", "blume", "mermaid", "bun-types"]
 
 [test]
 root = "./do-not-run-tests-from-root"
diff --git a/github/README.md b/github/README.md
@@ -119,15 +119,15 @@ To test locally:
    MODEL=anthropic/claude-sonnet-4-20250514 \
      ANTHROPIC_API_KEY=sk-ant-api03-1234567890 \
      GITHUB_RUN_ID=dummy \
-     MOCK_TOKEN=github_pat_1234567890 \
+     TOKEN=github_pat_1234567890 \
      MOCK_EVENT='{"eventName":"issue_comment",...}' \
      bun /path/to/opencode/github/index.ts
    ```
 
    - `MODEL`: The model used by opencode. Same as the `MODEL` defined in the GitHub workflow.
    - `ANTHROPIC_API_KEY`: Your model provider API key. Same as the keys defined in the GitHub workflow.
    - `GITHUB_RUN_ID`: Dummy value to emulate GitHub action environment.
-   - `MOCK_TOKEN`: A GitHub personal access token. This token is used to verify you have `admin` or `write` access to the test repo. Generate a token [here](https://github.com/settings/personal-access-tokens).
+   - `TOKEN`: A GitHub personal access token with write access to the test repo, used directly for GitHub API calls. Generate a token [here](https://github.com/settings/personal-access-tokens).
    - `MOCK_EVENT`: Mock GitHub event payload (see templates below).
    - `/path/to/opencode`: Path to your cloned opencode repo. `bun /path/to/opencode/github/index.ts` runs your local version of `opencode`.
 

diff --git a/github/index.ts b/github/index.ts
@@ -334,7 +334,6 @@ function useEnvShare() {
 function useEnvMock() {
   return {
     mockEvent: process.env["MOCK_EVENT"],
-    mockToken: process.env["MOCK_TOKEN"],
   }
 }
 
@@ -343,8 +342,7 @@ function useEnvGithubToken() {
 }
 
 function isMock() {
-  const { mockEvent, mockToken } = useEnvMock()
-  return Boolean(mockEvent || mockToken)
+  return Boolean(useEnvMock().mockEvent)
 }
 
 function isPullRequest() {
@@ -367,29 +365,17 @@ function useShareUrl() {
 }
 
 async function getAccessToken() {
-  const { repo } = useContext()
-
   const envToken = useEnvGithubToken()
   if (envToken) return envToken
+  if (isMock()) throw new Error("TOKEN is required when running with MOCK_EVENT")
 
-  let response
-  if (isMock()) {
-    response = await fetch("https://api.opencode.ai/exchange_github_app_token_with_pat", {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${useEnvMock().mockToken}`,
-      },
-      body: JSON.stringify({ owner: repo.owner, repo: repo.repo }),
-    })
-  } else {
-    const oidcToken = await core.getIDToken("opencode-github-action")
-    response = await fetch("https://api.opencode.ai/exchange_github_app_token", {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${oidcToken}`,
-      },
-    })
-  }
+  const oidcToken = await core.getIDToken("opencode-github-action")
+  const response = await fetch("https://api.opencode.ai/exchange_github_app_token", {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${oidcToken}`,
+    },
+  })
 
   if (!response.ok) {
     const responseJson = (await response.json()) as { error?: string }

diff --git a/install b/install
@@ -366,6 +366,7 @@ fi
 install_legacy_shim
 
 
+path_added=false
 add_to_path() {
     local config_file=$1
     local command=$2
@@ -375,6 +376,7 @@ add_to_path() {
     elif [[ -w $config_file ]]; then
         echo -e "\n# opencode" >> "$config_file"
         echo "$command" >> "$config_file"
+        path_added=true
         print_message info "${MUTED}Successfully added ${NC}opencode ${MUTED}to \$PATH in ${NC}$config_file"
     else
         print_message warning "Manually add the directory to $config_file (or similar):"
@@ -416,6 +418,18 @@ if [[ "$no_modify_path" != "true" ]]; then
         fi
     done
 
+    # A new Mac has no ~/.zshrc, so create the shell's main config file rather than leaving opencode off PATH.
+    if [[ -z $config_file ]]; then
+        case $current_shell in
+            zsh) new_config_file="${ZDOTDIR:-$HOME}/.zshrc" ;;
+            fish) new_config_file="$HOME/.config/fish/config.fish" ;;
+            *) new_config_file="" ;;
+        esac
+        if [[ -n $new_config_file ]] && mkdir -p "$(dirname "$new_config_file")" 2>/dev/null && touch "$new_config_file" 2>/dev/null; then
+            config_file=$new_config_file
+        fi
+    fi
+
     if [[ -z $config_file ]]; then
         print_message warning "No config file found for $current_shell. You may need to manually add to PATH:"
         print_message info "  export PATH=$INSTALL_DIR:\$PATH"
@@ -459,6 +473,9 @@ echo -e ""
 echo -e ""
 echo -e "${MUTED}OpenCode includes free models, to start:${NC}"
 echo -e ""
+if [[ $path_added == "true" ]]; then
+    echo -e "exec \$SHELL   ${MUTED}# Reload PATH (or open a new terminal)${NC}"
+fi
 echo -e "cd <project>  ${MUTED}# Open directory${NC}"
 echo -e "opencode      ${MUTED}# Run command${NC}"
 echo -e ""

diff --git a/migration-tracking/technical-notes/baseline/pinned-v2-baseline.md b/migration-tracking/technical-notes/baseline/pinned-v2-baseline.md
@@ -1,10 +1,43 @@
 # Pinned upstream v2 baseline
 
-Status: living. Refreshed 2026-10-23 on the `v2.1.1` sync branch `sync-v2-1-1`, synced to upstream `v2.1.1`. The base moves with every upstream sync (plan A4), so re-measure after each sync. The 2026-10-16 capture at `v2.0.30` and the 2026-10-11 capture at the initial base are kept below as previous captures. The 2026-08-13 capture at `76dbaf20` (old branch `johnnyeric/v2-baseline`) survives in git history only.
+Status: living. Refreshed 2026-10-23 on the `v2.1.3` sync branch `sync-v2-1-3`, synced to upstream `v2.1.3` (the sync includes `v2.1.2`). The base moves with every upstream sync (plan A4), so re-measure after each sync. The `v2.1.1` capture (2026-10-23), the 2026-10-16 capture at `v2.0.30` and the 2026-10-11 capture at the initial base are kept below as previous captures. The 2026-08-13 capture at `76dbaf20` (old branch `johnnyeric/v2-baseline`) survives in git history only.
 
 This file records the upstream release `origin/v2` is synced to, the validation commands that this tree defines, and the result of running them. Compare any failing check against this file, and against `origin/v2` before your change, before you attribute it to a change (`migration-context.md`, Conventions).
 
-## Current capture: `v2.1.1` (2026-10-23)
+## Current capture: `v2.1.3` (2026-10-23)
+
+### Refs
+
+| Ref | SHA | Date | Note |
+|---|---|---|---|
+| Sync branch (measured) | `021d6b31848` | 2026-10-23 | `sync-v2-1-3`: the `v2.1.3` sync merge `0d8ae9be328` plus `origin/v2` `2af82eef6a8` (#15405). After the later merge of `origin/v2` `aa7d29226e4` (#15345, #15407) at `d75e69380b1`, `check`, the generated-file checks, the Kilo checks and the `tui` (1,604), `plugin` (9), `kilo-plugin` (188) and `kilo-cli` (62) tests were run again and pass |
+| Current upstream base | `37d973754ba6cc31732f93421c0c18b675841573` | 2026-10-22 | Release commit of `v2.1.3` (parent of the tag) |
+| `upstream/dev` at capture | `2a3e7c0f349` | 2026-10-23 | 72 commits past the current base. Lag: 1 release (`v2.1.4`) |
+
+Measured with `bun migration-tracking/technical-notes/script/v2-baseline.ts --checks` in a clean detached worktree outside the repository. Toolchain: bun 1.4.4 (the new `packageManager`), node v25.2.1, macOS 26.6 arm64, macOS bash 3.2, `rg` on PATH (Homebrew), login shell fish. `origin/v2` `2af82eef6a8` was measured with the same script (`--only test`) and bun 1.4.2.
+
+### Results
+
+| Check | Result | Detail |
+|---|---|---|
+| `install`, `check` (`bun run check`), effect simplification lint and rule tests | pass | `bun.lock` unchanged. `check`: 28/28 turbo tasks, oxlint 209 warnings, 0 errors |
+| `test` (`bun turbo test --continue --force`, isolated) | **fail** | 25/26 tasks pass, 4 min 8 s. `@opencode/core`: 6,732 pass, 13 fail (`origin/v2`: 6,693 pass, the same 13 fail). All other packages pass, for example `@opencode/cli` 339, `@opencode/tui` 1,601, `@opencode/server` 87, `@kilocode/gateway-core` 104, `@kilocode/kilo-plugin` 188, `@kilocode/kilo-cli` 62 |
+| `client`, `www`, `protocol` `check:generated` | pass | No drift |
+| `sdk-verify-package`, `codemode-publish-dry-run` | pass | |
+| CLI build, binary version, service smoke | pass | |
+| Kilo build, host smoke, CLI startup ratchet | pass | |
+| Workflow allowlist, annotations, shared patches, progress map, Kilo import rule | pass | Shared patches: 46 files, 334 marked and 39 unmarked lines against `37d973754ba` (at `d75e69380b1`) |
+| Node build and smoke | not run | CI pins Node 26.4.0; this host has v25.2.1 |
+| `lint:effect-patterns` | **fail** | 27 errors, unchanged. Not run by CI |
+
+### Current reds
+
+The 13 `@opencode/core` cases of the `v2.1.1` capture, unchanged. The failure set is identical on `origin/v2` `2af82eef6a8` (before the sync) on this host. None is attributable to the sync or to a Kilo change.
+
+1. **macOS bash 3.2, 7 cases:** `ShellTool conditional process substitution` (4), `ShellTool compound syntax approval compatibility` (2), `real-shell compound syntax > bash` (1). Green on Linux CI.
+2. **Login shell, 6 cases:** `Session.shell > …` (`packages/core/test/session-shell.test.ts`) times out when `SHELL` is fish. With `SHELL=/bin/zsh` the file passes (9 pass).
+
+## Previous capture: `v2.1.1` (2026-10-23)
 
 ### Refs
 

diff --git a/nix/hashes.json b/nix/hashes.json
@@ -1,7 +1,7 @@
 {
   "nodeModules": {
-    "x86_64-linux": "sha256-XWwlhjvmCdt68mIHTUQsmDO/lBzrYjO34/3tob3d1tA=",
-    "aarch64-linux": "sha256-/310R94wlUd6rSDE9PJFf1FVXSyS6hAan8zi2NqEj4k=",
-    "aarch64-darwin": "sha256-0NZH0SXQ7e64wiCy2C9sKlygrr41fqe7JRoBLD8rRIg="
+    "x86_64-linux": "sha256-y9Zr4/sIxFh5i/6AYl/1N9PzdFBfPnyXEyjqW/idPes=",
+    "aarch64-linux": "sha256-4JBTGcwS4GsfSSvnKvcBR/6aCBghTwUSRz+E8lsQpO4=",
+    "aarch64-darwin": "sha256-hn62idpf73/uW+nCLLO5hhn/HTwwdV2NmmkqNTqo+2g="
   }
 }
diff --git a/package.json b/package.json
@@ -2,10 +2,10 @@
   "$schema": "https://json.schemastore.org/package.json",
   "name": "opencode",
   "description": "AI-powered development tool",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "private": true,
   "type": "module",
-  "packageManager": "bun@1.4.2",
+  "packageManager": "bun@1.4.4",
   "scripts": {
     "dev": "bun script/dev-isolated.ts",
     "dev:live": "sh -c 'OPENCODE_TUI_CHANNEL=dev OPENCODE_PASSWORD=\"$(opencode service get password)\" exec bun run dev \"$@\" --server \"$(opencode service status)\"' --",
@@ -50,7 +50,7 @@
       "@effect/platform-node-shared": "4.0.1",
       "@effect/sql-sqlite-bun": "4.0.1",
       "@npmcli/arborist": "9.4.0",
-      "@types/bun": "1.4.0",
+      "@types/bun": "1.4.3",
       "@types/cross-spawn": "6.0.6",
       "@octokit/rest": "22.0.0",
       "@hono/standard-validator": "0.2.0",
@@ -59,7 +59,6 @@
       "@opentui/keymap": "0.6.6",
       "@opentui/solid": "0.6.6",
       "@tanstack/solid-virtual": "3.13.37",
-      "@shikijs/stream": "4.4.3",
       "@standard-schema/spec": "1.1.0",
       "ulid": "3.0.1",
       "@kobalte/core": "0.13.13",
@@ -70,7 +69,8 @@
       "@tsconfig/node22": "22.0.2",
       "@tsconfig/bun": "1.0.9",
       "@cloudflare/workers-types": "4.20251008.0",
-      "@pierre/diffs": "1.5.1",
+      "@pierre/diffs": "1.6.1",
+      "@pierre/highlights": "0.2.0",
       "@solid-primitives/event-listener": "2.4.6",
       "@solid-primitives/media": "2.3.6",
       "@solid-primitives/resize-observer": "2.2.0",
@@ -164,7 +164,7 @@
     "@effect/platform-node-shared": "catalog:",
     "@types/bun": "catalog:",
     "@types/node": "catalog:",
-    "bun-types": "1.4.2",
+    "bun-types": "1.4.4",
     "effect": "catalog:",
     "open": "11.0.4",
     "solid-js": "catalog:"

diff --git a/packages/ai/package.json b/packages/ai/package.json
@@ -1,6 +1,6 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "name": "@opencode/ai",
   "type": "module",
   "license": "MIT",