webinstall.dev/basecamp Star on GitHub

To update or switch versions, run webi basecamp@stable (or @v0.7, @beta, etc).

Files

These are the files / directories that are created and/or modified with this install:

~/.config/envman/PATH.env
~/.local/bin/basecamp
~/.local/opt/basecamp-VERSION/bin/basecamp
~/.local/opt/basecamp-VERSION/completions/

Cheat Sheet

basecamp is the official CLI for Basecamp 3. It provides full API coverage for projects, todos, messages, cards, schedule, files, and more — all from the command line.

How to authenticate

basecamp auth login

For headless environments (CI, remote servers):

basecamp auth login --device-code

Check auth status:

basecamp auth status

How to list projects and todos

basecamp projects list --md

basecamp todos list --assignee me --in PROJECT_ID --md

Cross-project view of your assigned work:

basecamp assignments --md

How to create and complete todos

basecamp todo "Write release notes" --in PROJECT_ID --list TODOLIST_ID --assignee me --due tomorrow

basecamp done TODO_ID

How to post a message or comment

basecamp message "Sprint Update" "Shipped v2.1 to production." --in PROJECT_ID

basecamp comment RECORDING_ID "Looks good." --in PROJECT_ID

How to move cards through a workflow

basecamp cards columns --in PROJECT_ID --md

basecamp cards move CARD_ID --to COLUMN_ID --in PROJECT_ID

How to set up per-project defaults

Create .basecamp/config.json in your repo (commit it):

{
  "project_id": "12345",
  "todolist_id": "67890"
}

Then trust it once:

basecamp config trust

After that, you can omit --in for most commands in that repo.

Shell completions

Completions for bash, fish, and zsh ship with the installer. Find them at:

~/.local/opt/basecamp-VERSION/completions/

Bash:

echo "source ~/.local/opt/basecamp-VERSION/completions/basecamp.bash" >> ~/.bashrc

Fish:

ln -s ~/.local/opt/basecamp-VERSION/completions/basecamp.fish ~/.config/fish/completions/

Zsh:

echo "fpath+=( ~/.local/opt/basecamp-VERSION/completions )" >> ~/.zshrc