Skip to content

install.md

Latest commit

 

History

History
145 lines (102 loc) · 3.27 KB

install.md

File metadata and controls

145 lines (102 loc) · 3.27 KB

Basecamp CLI Installation Guide

Install the Basecamp CLI and connect it to your AI agent. Execute all steps autonomously.

DONE WHEN: basecamp --version && basecamp auth status both succeed.

TODO

  • Install Basecamp CLI
  • Authenticate with Basecamp
  • Connect agent (optional)

Step 1: Install Basecamp CLI

Run this in your terminal:

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

Note: The install script auto-detects non-interactive environments (CI, piped input, coding agents) and skips the interactive setup wizard. You can also explicitly skip it with BASECAMP_SKIP_SETUP=1.

Alternatively install manually:

Option A: Homebrew (macOS/Linux) — Recommended

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

Option B: Scoop (Windows)

scoop bucket add basecamp https://github.com/basecamp/homebrew-tap
scoop install basecamp-cli

Option C: Linux package (Debian/Ubuntu, Fedora/RHEL, Alpine)

# Download the matching package 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.

Option D: Nix

nix profile install github:basecamp/basecamp-cli

Option E: Go install

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

Option F: GitHub Release

Download the archive for your platform from Releases, extract, and move basecamp to a directory on your PATH.

Verify:

basecamp --version
# Expected: basecamp version X.Y.Z

If basecamp: command not found, add to PATH:

export PATH="$HOME/.local/bin:$PATH"
# or for go install:
export PATH="$HOME/go/bin:$PATH"

Step 2: Authenticate

basecamp auth login

Opens browser for OAuth. Grant access when prompted.

Verify:

basecamp auth status
# Expected: Authenticated (BC3 OAuth may show "Authenticated (scope: read)")

EXECUTE NOW: Start with Step 1. Mark TODO items complete as you go. Stop when basecamp --version && basecamp auth status both succeed.

Optional: Connect Your Agent

Do not execute this section unless explicitly requested. The core installation is complete when DONE WHEN passes.

Claude Code

basecamp setup claude

This registers the marketplace and installs the plugin with skills, hooks, and agent workflow support.

Other Agents

Point your agent at the skill file for full Basecamp workflow coverage:

skills/basecamp/SKILL.md

Every command supports --help --agent for structured JSON discovery.

Quick Test

basecamp projects --json
basecamp search "meeting" --json

Troubleshooting

Not authenticated:

basecamp auth login

Wrong account:

cat ~/.config/basecamp/config.json
basecamp auth logout && basecamp auth login

Permission denied (read-only, BC3 OAuth only):

basecamp auth login --scope full