basecamp-cli

Small Basecamp CLI written in Rust.

Basecamp Integration

This CLI works with your own Basecamp integration (OAuth client), not a shared app managed by this project.

1. Create or manage your integration in Basecamp Launchpad:

• https://launchpad.37signals.com/integrations

2. Store your integration credentials in the CLI:

basecamp-cli integration set \
  --client-id <your_client_id> \
  --client-secret <your_client_secret> \
  --redirect-uri <your_redirect_uri>

Or interactive mode:

basecamp-cli integration set

3. Verify what is configured:

basecamp-cli integration show

Install

macOS / Linux (latest)

curl -fsSL https://raw.githubusercontent.com/mkv27/basecamp-cli/main/install.sh | sh

Windows PowerShell (latest)

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

Advanced Install Options

Install a specific version (macOS / Linux)

BASECAMP_CLI_VERSION=v0.1.0 \
sh -c "$(curl -fsSL https://raw.githubusercontent.com/mkv27/basecamp-cli/main/install.sh)"

Install a specific version (Windows PowerShell)

$env:BASECAMP_CLI_VERSION = "v0.1.0"
irm https://raw.githubusercontent.com/mkv27/basecamp-cli/main/install.ps1 | iex

Install from a custom fork/repo

BASECAMP_CLI_REPO=your-org/your-repo \
sh -c "$(curl -fsSL https://raw.githubusercontent.com/mkv27/basecamp-cli/main/install.sh)"

$env:BASECAMP_CLI_REPO = "your-org/your-repo"
irm https://raw.githubusercontent.com/mkv27/basecamp-cli/main/install.ps1 | iex

Verify

basecamp-cli --help

Installers validate downloaded release archives against GitHub release asset digests (sha256) before extraction, with SHA256SUMS as a fallback.

Install path defaults

• macOS/Linux: ~/.local/bin/basecamp-cli
• Windows: %LOCALAPPDATA%\Programs\basecamp-cli\bin\basecamp-cli.exe

If needed, add that directory to your PATH.

Release

Automated:

scripts/release.sh 0.2.0

Manual:

# 1) Update package version
# edit Cargo.toml -> [package].version

# 2) Keep lock file in sync
cargo check --locked

# 3) Commit + tag + push
git add Cargo.toml Cargo.lock
git commit -m "release: v0.2.0"
git tag v0.2.0
git push origin HEAD
git push origin v0.2.0