# Changelog

## Breaking Changes ⚠️
- Rename AUR package: `basecamp-bin` → `basecamp-cli`. Update your dependencies accordingly.

## Features
- Add AUR install method to the README.

## Improvements
- Update release install instructions to use package managers.

## Bug Fixes
- Adjust circuit breaker test to use a more realistic timeout and fix half-open state transition logic.

Install

macOS:

brew install --cask basecamp/tap/basecamp
basecamp auth login

Arch Linux / Omarchy:

yay -S basecamp-cli
basecamp auth login

Other platforms: download the matching archive from the assets below.

What's Changed

Bug Fixes

• Rename AUR package: basecamp-bin → basecamp-cli by @jeremy in #175

Full Changelog: v0.2.0...v0.2.1

Changelog

Breaking Changes ⚠️

• ⚠️ Migrate CLI to flat SDK routes, removing bucketID arguments in various commands, impacting how project-related commands are executed.
• ⚠️ Remove legacy Docker release channel.

Features

• Add --bundle flag for cosign v4 compatibility.
• Add support for structured JSON help with --help --agent.
• Introduce new --hints and --no-hints global flags to toggle follow-up suggestions in CLI output.
• Self-describing CLI: Add structured JSON output for --help --agent and include --help --agent support for all commands.
• Add new basecamp upgrade command for seamless upgrade process.

Improvements

• Update CLI to use random delimiters for changelog environment files to avoid heredoc collisions.
• Use cosign bundle-only signing for v4 compatibility.
• Enhance error logging during OAuth discovery and fallback.

Bug Fix

Install

Linux (Omarchy):

gh release download v0.2.0 --repo basecamp/basecamp-cli --pattern '*linux_amd64*'
tar xzf basecamp_0.2.0_linux_amd64.tar.gz
sudo mv basecamp /usr/local/bin/
basecamp auth login

macOS (Apple Silicon):

gh release download v0.2.0 --repo basecamp/basecamp-cli --pattern '*darwin_arm64*'
tar xzf basecamp_0.2.0_darwin_arm64.tar.gz
sudo mv basecamp /usr/local/bin/
basecamp auth login

Other platforms: download the matching archive from the assets below.

What's Changed

Features

• V1 CLI ship polish by @jeremy in #160
• Security hardening for public release by @jeremy in #161
• Migrate CLI to flat SDK routes by @jeremy in #132
• Second round SDK CI/CD sync + exceed by @jeremy in #167
• Remove Docker release channel by @jeremy in #170
• Sync skills to distribution repo on release by @jeremy in #172

Bug Fixes

• Fix security review followups from #161 by @jeremy in #162
• Address PR #166 review feedback by @jeremy in #173
• Address PR #166 review feedback by @jeremy in #174

Documentation

• Release engineering: script, package managers, completions, docs by @jeremy in #171

Other Changes

• Prep for v0.2.0 release by @jeremy in #163
• Self-describing CLI: --help --agent, embedded skills, doctor integration by @jeremy in #164
• Import SDK CI/CD tooling: labeling, CodeQL, surface checks, AI changelog by @jeremy in #166

Full Changelog: v0.1.1...v0.2.0

Install

Linux (Omarchy):

gh release download v0.1.1 --repo basecamp/basecamp-cli --pattern '*linux_amd64*'
tar xzf basecamp_0.1.1_linux_amd64.tar.gz
sudo mv basecamp /usr/local/bin/
basecamp auth login

macOS (Apple Silicon):

gh release download v0.1.1 --repo basecamp/basecamp-cli --pattern '*darwin_arm64*'
tar xzf basecamp_0.1.1_darwin_arm64.tar.gz
sudo mv basecamp /usr/local/bin/
basecamp auth login

Requires gh CLI with access to the basecamp org. Other platforms: grab the matching archive from the assets below.

What's Changed

Other Changes

• Fix Docker latest tag gating and PGO failure visibility by @jeremy in #157
• V1 ship polish: layout, visual consistency, focus lifecycle, chrome by @jeremy in #156
• Experimental feature labels for v0.1.0 by @jeremy in #158
• Switch to GitHub-native release notes by @jeremy in #159

Full Changelog: v0.1.0...v0.1.1

The first release of the Basecamp CLI. Manage projects, todos, messages, cards, schedules, timesheets, and more from your terminal — or through any AI agent.

Install

Linux (Omarchy):

gh release download v0.1.0 --repo basecamp/basecamp-cli --pattern '*linux_amd64*'
tar xzf basecamp_0.1.0_linux_amd64.tar.gz
sudo mv basecamp /usr/local/bin/
basecamp auth login

macOS (Apple Silicon):

gh release download v0.1.0 --repo basecamp/basecamp-cli --pattern '*darwin_arm64*'
tar xzf basecamp_0.1.0_darwin_arm64.tar.gz
sudo mv basecamp /usr/local/bin/
basecamp auth login

Requires gh CLI with access to the basecamp org. Other platforms: grab the matching archive from the assets below.

Highlights

• 55+ commands across projects, todos, cards, messages, campfire, files, schedules, timesheets, check-ins, lineup, and more
• Interactive workspace — basecamp tui for full terminal UI with card boards, campfire chat, Hey! inbox, and cross-account support
• AI agent ready — works with Claude Code, Codex, Copilot, Gemini. Ships with a Claude Code plugin and standalone skills.
• JSON everywhere — styled output in terminals, --json envelope with breadcrumbs, --quiet for raw data
• OAuth 2.1 with PKCE, automatic token refresh, and multi-account profiles
• Signed and verified — SHA-256 checksums, Sigstore cosign signatures, and SBOM for each archive

Contributors

@jeremy, @robzolkos, @kevinmcconnell, @flavorjones