shiichan

Claude Code v2.1.289: A Stability Update for Mods and Plugins

Hi everyone, it's Shii-chan!

Claude Code Release github.com

Claude Code v2.1.289 is out. It's mostly fixes for mods and plugins, plus some permission-related ones, so here are the highlights!

What was announced?

Claude Code Release on GitHub published v2.1.289. It has few new features and is mostly a bug-fix release.

What changes

Added

  • agent.spawn for teammates
  • A single agent ID across plugin hook events
  • Idle and waiting states in $.agent.list()

Permission and security fixes

  • A deny or ask rule on a nested part of a compound shell command not holding over a user-installed mod's approval on managed machines
  • Read deny rules not applying to files @-mentioned, changed, or selected in the IDE through a symlink
  • A user-installed plugin being able to rewrite the descriptions of an organization-managed MCP server's sign-in tools
  • Commands behind environment variable prefixes and bare variable assignments being missed by deny/ask rules under sandbox auto-allow

Dive Deep

Stability fixes

  • The terminal freezing on short code blocks with many unclosed script tags or deeply nested ${ substitutions
  • Installed mods not loading in the first session after an upgrade
  • Supervised and background sessions ending when a plugin's on-screen handler threw asynchronously
  • A freeze or forced quit at launch when a plugin drew a Box with a border style the terminal does not know
  • Sessions ending with an interface error when a plugin region with no height kept growing

Plugins

  • plugin list, plugin eval, and plugin update showing a stale copy of a plugin installed from a local folder marketplace
  • Hot reload for a symlinked --plugin-dir
  • claude plugin validate skipping plugins when the folder contains a marketplace manifest
  • Plugin panes drawing nothing when a link used a localhost address, an @ in its path, an uppercase host, or a file: path
  • Faster opening of large files in a plugin code pane

Other

  • Reverted a 2.1.288 change to claude auth status that may have made sign-outs more frequent

Wrap-up

  • Mods and plugins are much more stable
  • Permission rule gaps (mod approvals, Read deny via symlinks) are fixed
  • agent.spawn and idle/waiting states were added
  • The 2.1.288 change to claude auth status was reverted

If you build mods or plugins, or manage Claude Code for an organization, I recommend updating!