Skip to content

Instantly share code, notes, and snippets.

@rstacruz
Created August 24, 2025 23:36
Show Gist options
  • Select an option

  • Save rstacruz/aed08f8a447a3b532d2215e86ca7155f to your computer and use it in GitHub Desktop.

Select an option

Save rstacruz/aed08f8a447a3b532d2215e86ca7155f to your computer and use it in GitHub Desktop.

Revisions

  1. rstacruz revised this gist Aug 24, 2025. 1 changed file with 0 additions and 4 deletions.
    4 changes: 0 additions & 4 deletions opencode_changes.md
    Original file line number Diff line number Diff line change
    @@ -1,7 +1,3 @@
    ---
    createdAt: 2025-08-21T02:03:19Z
    ---

    # Opencode: User-facing Changes

    ## v0.5.24 (24 Aug 2025)
  2. rstacruz created this gist Aug 24, 2025.
    23 changes: 23 additions & 0 deletions 0-keeping-up-with-a-changelog.md
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,23 @@
    # Keeping up with a changelog

    Got a fast-moving changelog like in https://github.com/sst/opencode/releases ? [OpenCode](https://opencode.ai/) itself can help you keep track.

    1. Add this file

    - Add `opencode_changes.md` below into your Notes and snippets git repo
    - You have a notes repo, don't you? If not, start a repo where you dump random Markdown files. It's useful for a lot of things

    2. Ask OpenCode to update it

    - When a new release is out, ask OpenCode to update it
    - eg, `opencode run "read @opencode_changes.md and update it"`
    - There are instructions at the end of the file on how to update it

    You're done :sparkles:

    ## Beyond change logs

    I've found this "notes wtih embedded instructions" pattern is pretty useful for a lot of things. Some other use cases I've found are

    - List of Google Analytics calls in a repo (with instructions on what patterns to grep to update it)
    - An overview of commands defined in commands/*.js (with instructions to look in those files when updating)
    210 changes: 210 additions & 0 deletions opencode_changes.md
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,210 @@
    ---
    createdAt: 2025-08-21T02:03:19Z
    ---

    # Opencode: User-facing Changes

    ## v0.5.24 (24 Aug 2025)

    - No notable user-facing changes

    ## v0.5.23 (24 Aug 2025)

    - Fix: command model selection

    ## v0.5.18 (23 Aug 2025)

    - Chore: set correct content type for server-sent events
    - Add SSE streaming to SDK
    - Fix: count reasoning tokens
    - Feature: option to disable LSPs installing automatically

    ## v0.5.15 (22 Aug 2025)

    - Await config hooks
    - Fix: preserve cache dir on cleanup
    - Fix: types in session.chat for JS SDK
    - Allow importing SDK from @opencode-ai/sdk/server and @opencode-ai/sdk/client
    - Fix SDK config type
    - Fix: LSP spawn errors not injecting into edit diagnostics
    - Add createOpencodeServer to JS SDK and wait for readiness
    - Tweak: adjust plan agent to ask when running bash
    - Deal with non-existing cache folder
    - Fix: error logging
    - Fix: correct typo in LSP documentation
    - Update duplicate-issues.yml
    - Add slash commands
    - Fix: format error log

    ## v0.5.13 (21 Aug 2025)

    - Fix: ignore case when checking Qwen in model ID for todos
    - Tweak: adjust plan -> build transition prompt
    - Add plugin hook for config
    - Await config hooks
    - Fix: preserve cache dir on cleanup

    ## v0.5.12 (20 Aug 2025)

    - Removed auto browser open for now

    ## v0.5.10 (20 Aug 2025)

    - No notable user-facing changes

    ## v0.5.9 (20 Aug 2025)

    - Updated Copilot authentication version

    ## v0.5.8 (20 Aug 2025)

    - Blacklisted `gpt-5-chat-latest` model
    - Fixed: name field incorrectly added in options
    - Improved agent creation error handling
    - Fixed: interface conversion panic
    - Added type checking for MCP tool path parameters
    - Fixed: TUI panic from logger
    - TUI: made shimmer effect less pronounced
    - Notify agent when switching from plan mode to build mode
    - Fixed: agent casing issue
    - Fixed: keybind panic
    - Prevented `--continue` from accessing subagent session
    - Added support for Sonic model

    ## v0.5.7 (18 Aug 2025)

    - Fixed Anthropic console authentication

    ## v0.5.6 (18 Aug 2025)

    - Added top-level tool config
    - Markdown agent files in subfolders are now discoverable
    - Fixed: install script now uses `-e` flag
    - Fixed LSP bug
    - Added Rust Analyzer LSP support
    - Added ULID dependency
    - Improved binary file detection
    - Fixed: `gh install` trims remote origin

    ## v0.5.5 (16 Aug 2025)

    - Removed unsupported mode flag, changed to agent
    - Plan prompt is now more explicit about not modifying files
    - TUI: Retains cache when cycling between subagent/parent sessions for better performance
    - TUI: Fixed text selection not cleared on click+release without dragging

    ## v0.5.4 (15 Aug 2025)

    - Fixed: run command
    - Tweak: fixed scroll speed

    ## v0.5.3 (15 Aug 2025)

    - Added scroll speed to config
    - TUI: Improved UX with message navigation modal to jump and restore to specific messages
    - Fixed: shell commands expecting stdin would hang indefinitely
    - Shell: Loads `.zshenv` and respects `ZDOTDIR` if present
    - Fixed: visual bugs in dialogs

    ## v0.5.2 (15 Aug 2025)

    - Small tweak to support Nushell
    - Lander: matched alternatives h3 font size with figcaption on mobile
    - TUI: Fixed agent types agents modal
    - Fixed: Fish shell support
    - More permissive owner/repo detection
    - Render tool metadata after permission rejection
    - Added Vue LSP and enabled ESLint for `.vue` files
    - TUI: Support cycling recent models in reverse
    - TUI: Fixed rendering markdown tables
    - Added missing keybinds to config
    - Keybind docs now in sync
    - Improved queued visual
    - More commands cleanup
    - Added `/tui/show-toast` API
    - API: Get session and session children routes
    - TUI: Navigate child sessions (subagents)

    ## v0.5.1 (14 Aug 2025)

    - Fixed: Fish shell support
    - Fixed: Session stuck in "Working..."
    - Plugins can now create custom auth providers

    ## v0.4.45 (13 Aug 2025)

    - Fixed: Error [ERR_DLOPEN_FAILED]
    - Bash now hides stdout from zshrc

    ## v0.4.44 (13 Aug 2025)

    - Attachments are converted to text on delete
    - Default scroll speed is now slower
    - Fixed incorrect AUR namespace
    - Re-enabled AUR
    - Fixed: Error [ERR_DLOPEN_FAILED]

    ## v0.4.43 (13 Aug 2025)

    - Fixed: Duplicates bot prompt
    - Fixed: JS plugin support as per documentation
    - Fixed: Grammatical error in agent launch example
    - CLI docs: Documented !bash commands and session persistence
    - Added support for !shell commands
    - Attachments are converted to text on delete

    ## v0.4.42 (13 Aug 2025)

    - Better error message when config has invalid references
    - Fixed: Task tool prompt
    - Fixed: Reasoning not supported
    - Fixed: Permission prompting issues
    - Default agent permissions now merge with global config
    - Updated read tool description to exclude binary/image files
    - Attachments outside CWD are now allowed, SVG supported
    - Fixed: Messages layout instability

    ## v0.4.41 (13 Aug 2025)

    - Fixed: unzip not found printing to TUI
    - Updated Copilot prompt

    ## v0.4.40 (12 Aug 2025)

    - Disabled todo tools for Qwen models to improve compatibility
    - Bash: Truncate by character max instead of line max
    - Agent modal: revamped UI/UX
    - Added session rename functionality to TUI modal
    - Added OpenAI prompt cache key
    - TUI: Fixed subagent surfacing in agents modal

    ## v0.4.37 (12 Aug 2025)

    - Limited bash tool to 1000 lines of output
    - Disabled todo tools for Qwen models to improve compatibility

    ## v0.4.36 (12 Aug 2025)

    - Fixed: @ tagging files error
    - Fixed: Word wrapping with hyphens
    - Fixed: Markdown lists

    ## v0.4.34 (12 Aug 2025)

    - Fixed: Long word and attachment wrapping in editor
    - Added agent-level permissions with whitelist/blacklist support
    - Support for OPENCODE_PERMISSION JSON env variable

    _Source: [sst/opencode releases](https://github.com/sst/opencode/releases)_

    ---

    ## How to update this document

    1. Visit [sst/opencode releases](https://github.com/sst/opencode/releases).
    2. Review the latest release notes for user-facing changes.
    3. Add new versions to this file, using the format:
    - `## vX.Y.Z (DD MMM YYYY)`
    - List user-facing changes as bullet points.
    4. Keep changes concise and focused on what users will notice.
    5. Update the "Source" link if needed.