AgentSys 6.1.0 installs every plugin at the exact commit its marketplace pins

2 hours ago

AgentSys 6.1 makes every install land on the commit the marketplace pins. Until now, Claude Code read a different key, and the npm installer skipped the pin. Now Claude Code, OpenCode, Codex, Cursor and Kiro all get the same plugin code. Here's what changed, and one thing to check before you upgrade.

Ask about this presentation

Chapters

  1. 0:00Every plugin at its pinned commit
  2. 0:20Claude Code reads sha
  3. 0:38The npm installer follows the pin
  4. 0:59A first install installs
  5. 1:20Skills arrive whole
  6. 1:39Which skill folders a reinstall replaces
  7. 2:00Codex names and Windows shims
  8. 2:22Newer plugins come with it
  9. 2:46Upgrade, and check one folder
Show transcript
  1. AgentSys 6.1 makes every install land on the commit the marketplace pins. Until now, Claude Code read a different key, and the npm installer skipped the pin. Now Claude Code, OpenCode, Codex, Cursor and Kiro all get the same plugin code. Here's what changed, and one thing to check before you upgrade.

    Slide text
    agentsys 6.1.0
    release

    Every plugin now installs at the commit its pin names

    Claude Code OpenCode Codex Cursor Kiro
    AgentSys logo
  2. Claude Code's url plugin source reads url, ref and sha, and ignores the commit key the pins lived in. So every entry now carries sha, set to the same commit. Before, Claude Code installed the ref tag for 9 entries and the default branch for the other 15.

    Slide text
    agentsys 6.1.0
    fixed · claude code

    Claude Code reads sha, so every pin now carries one

    .claude-plugin/marketplace.json
    "prepare-delivery" source:
    {
      "source": "url",
      "url": "…/agent-sh/prepare-delivery.git",
      "commit": "5df28a4b76aa…",
      "sha":    "5df28a4b76aa…",  "ref": "v0.3.0"
    }
    Before 6.1.0

    9 entries got their ref tag

    15 entries got the default branch HEAD

  3. The npm installer, which fetches plugins for OpenCode, Codex, Cursor and Kiro, skipped the pin and tried a version tag, then main. So 14 of the 24 plugins arrived at another commit. Now it fetches the pinned commit and checks the archive came from it. A pin GitHub doesn't serve stops the install with an error.

    Slide text
    agentsys 6.1.0
    fixed · npm installer

    The npm installer now fetches the same commit Claude Code installs

    14/24

    plugins reached OpenCode, Codex, Cursor and Kiro at another commit

    8 from main 6 from a version tag at another commit
    Now: the pinned commit, checked against the archive, or an error
  4. A first install of a plugin on OpenCode, Codex, Cursor or Kiro fetched it, then replaced the whole agentsys folder, which deleted the plugin. The install still reported success. Now the local install is set up first, a failed fetch stops with an error, and installed.json keeps your earlier records.

    Slide text
    agentsys 6.1.0
    fixed · opencode codex cursor kiro

    A first agentsys install on the other four platforms now installs the plugin

    Before

    Fetch the plugin~/.agentsys/plugins/
    →
    Replace the folder~/.agentsys
    →
    Plugin deleted, success reported

    Now

    Set up the local installkeeps installed.json
    →
    Fetch at the pin~/.agentsys/plugins/
    →
    Installed, or stops with an error
  5. On those same platforms, the installer copied only the skill file, so skills from consult, debate, deslop and others lost their references and scripts. Now the whole directory is copied. And Codex installs plugin skills as well as commands, so skill-only plugins like mojo and ada-spark reach it.

    Slide text
    agentsys 6.1.0
    fixed · skills

    Skills now arrive with their references/ and scripts/

    ~/.kiro/skills/<name>/
    ├── SKILL.md
    ├── references/└── scripts/

    Codex installs plugin skills as well as commands

    mojo ada-spark orchestrate-review enhance-docs perf-*
  6. Each skill folder agentsys installs gets a marker file with the plugin's name and version. A marked folder is replaced, and so is an old one holding only files the skill ships, so upgrading needs no manual step. Any other folder, or a symlink, is skipped with a warning. Before, Cursor and Kiro deleted it.

    Slide text
    agentsys 6.1.0
    fixed · reinstall

    A reinstall replaces only skill folders agentsys could have written

    <name>/
    ├── .agentsys-skill├── SKILL.md
    ├── references/
    └── scripts/
    Marked by agentsysreplaced
    Unmarked, only files the skill shipsreplaced, marked
    Unmarked with any other file, or a symlinkskipped, warning
  7. On Codex, a command file named dot dot md resolved to the skills directory itself, and the install deleted every skill in it. Odd names are now skipped with a warning. On Windows, with delayed expansion on, a name between exclamation marks in an argument became that variable's value. Shims now turn delayed expansion off.

    Slide text
    agentsys 6.1.0
    fixed · codex, windows

    Two install edge cases on Codex and Windows are closed

    Codex skips odd command names

    A file named ..md mapped to ~/.codex/skills, and the install deleted every skill in it.

    Names with anything but letters, digits, - and _ are skipped with a warning.

    Windows keeps !NAME! literal

    With delayed expansion on, cmd.exe replaced !NAME! in an argument with the value of NAME.

    .cmd and .bat shims now run with /v:off.

  8. The pins also move to each plugin's current main. banthis goes from 0.3.1 to 0.6.0. Its ban triggers fire only when you explicitly ask, and it writes a rule only after you confirm the wording. ship, next-task, deslop and drift-detect move too. The orientation plugin is removed, because its lookups returned missing or stale history.

    Slide text
    agentsys 6.1.0
    changed · marketplace pins

    Upgrading also moves you to each plugin's current main

    banthis
    0.3.1 → 0.6.0
    ship
    1.1.2 → 1.3.0
    next-task
    1.1.2 → 1.3.0
    deslop
    1.0.0 → 1.3.0
    drift-detect
    1.0.0 → 5.4.0
    orientation
    removed
  9. One check before you upgrade. If your own skill shares a plugin skill's name and holds only a skill file, OpenCode, Cursor, Kiro and Codex command skills still replace it, since it looks like an older agentsys install. Add any other file and it stays. Then install with the npm line from the README, and every plugin lands at the commit its pin names.

    Slide text
    agentsys 6.1.0
    upgrade

    Before you upgrade, check any skill of yours that is only a SKILL.md

    Still replaced Your own skill under a plugin skill's name, holding only a SKILL.md, on OpenCode, Cursor, Kiro and Codex command skills. Add any other file to keep it.
    zsh
    $ npm install -g agentsys && agentsys

    github.com/agent-sh/agentsys/releases/tag/v6.1.0

What happened in AI today, in your inbox

One short email each evening. Read it and you’re caught up.

Built in New York with ❤️