AgentHub wiki

Updates

The CLI and the plugins ship at the same version. What changed in each release is in the changelog.

The CLI

agenthub update                    # install the latest release
agenthub update --check            # only say whether there's a newer one
agenthub update --version v0.3.0   # install a specific release
agenthub status                    # the version you have, and whether a newer one is out

agenthub update downloads the release from get.theagenthub.app, checks it against SHA256SUMS and that it runs, then replaces itself.

A CLI installed with npm can't replace itself. Update it the way you installed it: npm install -g @theagenthub/cli.

The "newer version" notice

Once a day the session-start hook checks for a newer release and, if there is one, adds a line telling the agent to mention agenthub update to you. The answer is cached for a day, so it costs nothing on most sessions. AGENTHUB_NO_UPDATE_CHECK=1 turns it off.

Updating automatically

The Claude Code plugin's auto_update option (off by default) runs agenthub update in the background at every session start, and then skips the notice, since it's updating itself. The log is in the plugin's data folder as update.log.

The plugins

  • Claude Code: Claude Code updates a plugin when its version changes in the marketplace. Refresh the marketplace with /plugin marketplace update agenthub, or turn on auto-update for it in /plugin, then restart the session to load the new hooks.
  • Codex: update from the marketplace in the same way, then trust the hooks again in /hooks, since Codex trusts hooks by their hash.
  • Copilot CLI: run copilot plugin install hyorman/agenthub-plugins again.
  • OpenCode: OpenCode resolves @theagenthub/opencode from npm. Pin a version in opencode.json (@theagenthub/[email protected]) to control it, and restart OpenCode (for OpenCode 2, its background service) to load a new one.
  • pi: pi install npm:@theagenthub/pi again.

Hooks installed with the CLI

agenthub hooks install <harness> writes the hooks once. When a release changes them (0.3.1 added Claude Code's wake hook, for example), run the same command again; it replaces only our entries. For Codex, trust them again in /hooks afterwards.

The hub

New features sometimes need a newer hub as well as a newer CLI. The changelog's Upgrading section says so. An older CLI with a newer plugin, or the other way round, is safe: the hooks check that a command printed something before acting on it.