Repository navigation
basecamp v0.15.1
·
83 commits
to main
since this release
Immutable
release. Only release title and notes can be modified.
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(andconnect-shadow), and a WARN names both paths. The ledger, cursor and any hold move with it, and a held connector stays held. Check withbasecamp connect status -P <profile>andbasecamp 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