Basecamp CLI
Manage Basecamp 4 projects, to-dos, messages, and campfires from the command line.
Setup
- Install:
npm install -g basecamp-cli - Create integration at https://launchpad.37signals.com/integrations
- Configure:
basecamp auth configure --client-id <id> --client-secret <secret> - Login:
basecamp auth login
Commands
Authentication
basecamp auth login # Login via OAuth
basecamp auth logout # Logout
basecamp auth status # Check authentication status
basecamp accounts # List available accounts
basecamp account set <id> # Set current account
Projects
basecamp projects list # List all projects
basecamp projects get <id> # Get project details
basecamp projects create --name "Name" --description "Desc" # Create project
basecamp projects archive <id> # Archive project
To-do Lists & To-dos
basecamp todolists list --project <id> # List to-do lists
basecamp todolists create --project <id> --name "Tasks" # Create to-do list
basecamp todos list --project <id> --list <list-id> # List to-dos
basecamp todos get <id> --project <project-id> # Get to-do details
basecamp todos create --project <id> --list <list-id> --content "Task"
basecamp todos complete <id> --project <project-id> # Mark complete
basecamp todos uncomplete <id> --project <project-id> # Mark incomplete
Messages
basecamp messages list --project <id> # List messages
basecamp messages get <id> --project <project-id> # Get message
basecamp messages create --project <id> --subject "Subject" --content "Content"
Campfires (Chat)
basecamp campfires list --project <id> # List campfires
basecamp campfires lines --project <id> --campfire <id> # Get recent lines
basecamp campfires send --project <id> --campfire <id> --message "Hello"
People
basecamp people list # List all people
basecamp people list --project <id> # List project members
basecamp people get <id> # Get person details
basecamp me # Get your profile
Tips
- Use
--jsonflag for JSON output on any command - Set
BASECAMP_CLIENT_IDandBASECAMP_CLIENT_SECRETenvironment variables for automatic auth - Rate limit: 50 requests per 10 seconds