+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
#599Direct push to main detected9 comments · 2026-08-03#871Feature request: set profile avatar and project image from the CLI2 comments · 2026-10-11#793Read and set per-person project notification settings2 comments · 2026-09-28#617Add support for opencode2 comments · 2026-08-04#904Event feed: emit an event when an automatic check-in question is asked (and when a new unread notification arrives)1 comments · 2026-10-14#903connect: chat lines in Pings (Circles) are never handed off — blocked as `read_unresolved`1 comments · 2026-10-14#897basecamp mcp: paginated results never signal the last page, and their shape varies1 comments · 2026-10-13#896basecamp mcp: rich-text fields are stored as literal Markdown instead of being converted like the CLI does1 comments · 2026-10-13
Discussions
#834Agent connections: how can an account outside 37signals get them enabled?0 comments · 2026-10-03#643Does an agent need an email address to have it's own basecamp user account?0 comments · 2026-08-20#505Basecamp 5 & Sub-Tasks1 comments · 2026-06-24#502Add support for timesheets1 comments · 2026-06-17#448Authorizing in GitHub Actions1 comments · 2026-04-24#411Add support for archiving projects0 comments · 2026-04-08#201Allow inviting people to / removing them from an account2 comments · 2026-03-05#165Welcome to Basecamp CLI Discussions!1 comments · 2026-02-28
Latest release
basecamp v0.30.0 v0.30.0 2026-11-13What'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