basecamp /basecamp-cli

Basecamp CLI and Agent Skills

★ 300⑂ 22👁 2⑃ 860● 150▤ 50
GoMITCreated 2026-01-09basecamp.com/cli
Download: basecamp v0.30.0basecamp-0.30.0 ↓0.30.02026-11-13
+1
Daily
300
stars
22
forks
2
watchers
860
prs
150
issues
50
releases

README

Basecamp CLI

basecamp is the official command-line interface for Basecamp. Manage projects, todos, messages, and more from your terminal or through AI agents.

- Works standalone or with any AI agent (Claude, Codex, Grok, Copilot, Gemini)
- JSON output with breadcrumbs for easy navigation
- OAuth authentication with automatic token refresh
- Includes agent skills plus native Claude Code and Codex plugins; Grok Build reads the shared skill directly

 Quick Start

macOS / Linux / WSL2

bash
curl -fsSL https://basecamp.com/install-cli | bash


Windows (PowerShell)

powershell
irm https://raw.githubusercontent.com/basecamp/basecamp-cli/main/scripts/install.ps1 | iex


On Windows 11 with Smart App Control, see Troubleshooting if the install is blocked.

On an interactive terminal, the installer opens Basecamp setup: approve OAuth in your browser and the CLI uses the account granted by OAuth, otherwise preserves an existing account or selects the first available. It saves that account globally, clears the global project default, and connects every detected coding agent. Directory-specific and environment project settings continue to apply. Use basecamp setup --customize to choose those settings instead.


Other installation methods

Brew / macOS


brew install --cask basecamp/tap/basecamp-cli


Arch Linux / Omarchy (AUR):
bash
yay -S basecamp-cli


Linux (deb/rpm/apk):
bash
 Download from https://github.com/basecamp/basecamp-cli/releases/latest
sudo apt install ./basecamp-cli__linux_amd64.deb             Debian/Ubuntu
sudo dnf install ./basecamp-cli__linux_amd64.rpm             Fedora/RHEL
sudo apk add --allow-untrusted ./basecamp-cli__linux_amd64.apk   Alpine

Arm64: substitute arm64 for amd64 in the filename. Verify the SHA-256 checksum from checksums.txt before installing unsigned Alpine packages.

Scoop (Windows):
bash
scoop bucket add basecamp https://github.com/basecamp/homebrew-tap
scoop install basecamp-cli


Shell script (macOS / Linux / WSL2 / Git Bash):
bash
curl -fsSL https://raw.githubusercontent.com/basecamp/basecamp-cli/main/scripts/install.sh | bash


Nix:
bash
nix profile install github:basecamp/basecamp-cli


Go install:
bash
go install github.com/basecamp/basecamp-cli/cmd/basecamp@latest


mise:
bash
mise use --global github:basecamp/basecamp-cli@latest


GitHub Release: download from Releases.



 Upgrading

bash
basecamp upgrade


What happens depends on how the CLI was installed:

- Installer script / tarball (a binary under your home directory, e.g. ~/bin or ~/.local/bin): upgrades in place. The CLI downloads the release for your platform, verifies its Sigstore signature (the keyless checksums.txt.bundle published by the release pipeline, identity-pinned to the release workflow and tag) and SHA-256 checksum, swaps the executable transactionally, and confirms the installed binary reports the new version. On failure the previous binary is restored; in the worst case — restoration itself fails mid-swap — the error names the preserv

Top issues

Discussions

Latest release

basecamp v0.30.0 v0.30.0 2026-11-13
What's Changed
 Other Changes
 Never give the connector's monitor a timeout by @jeremy in https://github.com/basecamp/basecamp-cli/pull/1035
 Lift the connector's cap on workers, and let a start set one by @robzolkos in https://github.com/basecamp/basecamp-cli/pull/1040
 Watch a connector in a terminal, and talk to its orchestrator by @robzolkos in https://github.com/basecamp/basecamp-cli/pull/1039


Full Changelog: https://github.com/basecamp/basecamp-cli/compare/v0.29.0...v0.30.0

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON