Skip to content

Instantly share code, notes, and snippets.

@rstacruz

rstacruz/0-keeping-up-with-a-changelog.md

Created August 24, 2025 23:36
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save rstacruz/aed08f8a447a3b532d2215e86ca7155f to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save rstacruz/aed08f8a447a3b532d2215e86ca7155f to your computer and use it in GitHub Desktop.
Download ZIP
Keeping up with a changelog
Raw
0-keeping-up-with-a-changelog.md

Keeping up with a changelog

Got a fast-moving changelog like in https://github.com/sst/opencode/releases ? OpenCode 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 ✨

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)
Raw
opencode_changes.md

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

How to update this document

  1. Visit 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.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment