basecamp-cli

# Basecamp CLI

This repo contains a standalone CLI.

## Install

```bash
npm i -g @emredoganer/basecamp-cli
```

## Auth

Create an integration (OAuth app) in 37signals Launchpad:
- https://launchpad.37signals.com/integrations

Then:
```bash
basecamp auth configure --client-id <id> --redirect-uri http://localhost:9292/callback
export BASECAMP_CLIENT_SECRET="<secret>"
basecamp auth login
```

## Notes

- This uses the Basecamp API docs published under bc3-api: https://github.com/basecamp/bc3-api
- `BASECAMP_CLIENT_SECRET` is intentionally NOT stored on disk by the CLI.

# Basecamp CLI

A command-line interface for managing Basecamp (via the official bc3 API / 37signals Launchpad) projects, to-dos, messages, and campfires.

## Installation

```bash
npm install -g @emredoganer/basecamp-cli
```

## Setup

### 1. Create a Basecamp Integration

1. Go to [Basecamp Integrations](https://launchpad.37signals.com/integrations)
2. Click "Register another application"
3. Fill in the details:
   - Name: Your app name
   - Company: Your company
   - Website: Your website
   - Redirect URI: `http://localhost:9292/callback`
4. Note your Client ID and Client Secret

### 2. Configure Credentials

Set environment variables:

```bash
export BASECAMP_CLIENT_ID="your-client-id"
export BASECAMP_CLIENT_SECRET="your-client-secret"
```

Or configure via CLI:

```bash
basecamp auth configure --client-id "your-client-id" --client-secret "your-client-secret"
```

### 3. Login

```bash
basecamp auth login
```

This will open your browser for OAuth authentication.

## Usage

### Authentication

```bash
# Login via OAuth
basecamp auth login

# Check auth status
basecamp auth status

# Logout
basecamp auth logout
```

### Accounts

```bash
# List available accounts
basecamp accounts

# Set current account
basecamp account set <id>

# Show current account
basecamp account current
```

### Projects

```bash
# List all projects
basecamp projects list

# Get project details
basecamp projects get <id>

# Create a project
basecamp projects create --name "My Project" --description "Description"

# Archive a project
basecamp projects archive <id>
```

### To-do Lists

```bash
# List to-do lists in a project
basecamp todolists list --project <id>

# Create a to-do list
basecamp todolists create --project <id> --name "Tasks"
```

### To-dos

```bash
# List to-dos
basecamp todos list --project <id> --list <list-id>

# Show completed to-dos
basecamp todos list --project <id> --list <list-id> --completed

# Get to-do details
basecamp todos get <id> --project <project-id>

# Cr...