Skip to content

basecamp v0.15.1

Choose a tag to compare

@github-actions github-actions released this 21 Oct 12:19
· 83 commits to main since this release
Immutable release. Only release title and notes can be modified.
7f6707d

Upgrading a host that runs basecamp connect

This release keeps each connector's local state in its own folder per profile. The move happens once and doesn't undo itself. Read this before upgrading a host that runs a connector.

  • Stop every older connector for the agent on this host first, normal and shadow, along with anything that restarts one (a launchd or systemd unit, a Claude Code session). Run which -a basecamp. An old binary still on PATH, or named in a supervisor, is how two builds end up running side by side.
  • Start the existing profile with this build: basecamp connect -P <profile>. Its first verified run renames <account>-<agent> to <account>-<agent>-<profile> under ~/.local/state/basecamp/connect (and connect-shadow), and a WARN names both paths. The ledger, cursor and any hold move with it, and a held connector stays held. Check with basecamp connect status -P <profile> and basecamp connect doctor -P <profile>.
  • Never run an older build beside this one on the same host. After the move, an older build recreates the old folder, can't see the new lock, and can answer the same request twice.
  • Downgrading needs the runbook. If the folder isn't renamed back, the older build starts empty, and held work and the cursor are silently left behind.
  • Don't reconnect to upgrade, and don't add a second profile for the same agent yet. Connecting again from another computer or profile still replaces the existing connection.
  • When Basecamp no longer accepts the connection, the connector now says Profile "<profile>"'s connection to <agent> was disconnected in Basecamp, or replaced by a newer connection. The error code is unchanged.

Shadow connectors, held work and the full procedure: docs/agent-connections-rollout.md.


What's Changed

Other Changes

  • Keep agent connector profiles safe across server upgrades by @robzolkos in #907
  • List the person's projects in the agent's account by @robzolkos in #920
  • Update nix flake and plugin version for v0.15.0 by @jeremy in #930
  • Clear the connector's boost once the agent has replied by @robzolkos in #929
  • Satisfy gosec and unconvert in the darwin process-start reader by @jeremy in #931
  • Build with Go 1.26.10 and update nix flake and plugin version for v0.15.1 by @jeremy in #932

Full Changelog: v0.14.0...v0.15.1