basecamp-cli 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6ad45dc6324b786c253b79d9c76d4751e32d90a62382e90091b160a14c6a5e96
+  data.tar.gz: 3532827c6e377a67c344d9a1d4b284344c7604e304a2b65bafe4430294ca0429
+SHA512:
+  metadata.gz: 1ba797440b833e8c8c1b62aad1cc4d674d784f420bc4a079d228c5ba18117f5c4cc3dbea4d3bce5e5ad8ac2270a0b73ca23a164ff409d11940e2ba68a2e5d81e
+  data.tar.gz: da8dfe2cbbe8774d2058b8eef6fe242c8b907b278f370f80449182a31f0f73a31f425ac16550b56ab47900744aa3fad6c3005696b0532a0a8e76a09c0431200b

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,317 @@
+# Basecamp CLI
+
+A simple command-line interface for Basecamp. List projects, browse card tables (Kanban boards), view cards, and move cards between columns.
+
+## Features
+
+- **List projects** - See all projects in your Basecamp account
+- **Browse boards** - View card tables and their columns within a project
+- **List cards** - See all cards in a board, optionally filtered by column
+- **View card details** - See full card info including description and comments
+- **Move cards** - Move cards between columns
+
+## Installation
+
+### From RubyGems
+
+```bash
+gem install basecamp-cli
+```
+
+### From source
+
+```bash
+git clone https://github.com/robzolkos/ruby-basecamp-cli.git
+cd ruby-basecamp-cli
+bundle install
+```
+
+Then either:
+- Run directly: `./bin/basecamp`
+- Add to PATH: `export PATH="$PATH:/path/to/basecamp-cli/bin"`
+- Install as gem: `rake install`
+
+### Requirements
+
+- Ruby 3.0+
+
+## Setup
+
+### 1. Register your application with Basecamp
+
+Go to [launchpad.37signals.com/integrations](https://launchpad.37signals.com/integrations) and register a new application.
+
+You'll need to provide:
+- **Name**: e.g., "Basecamp CLI"
+- **Redirect URI**: `http://localhost:3002/callback`
+
+After registering, you'll receive:
+- **Client ID**
+- **Client Secret**
+
+You'll also need your **Account ID**, which is the number in your Basecamp URL:
+```
+https://3.basecamp.com/YOUR_ACCOUNT_ID/...
+```
+
+### 2. Configure the CLI
+
+Run the init command and enter your credentials:
+
+```bash
+./bin/basecamp init
+```
+
+This saves your configuration to `~/.basecamp.json`.
+
+### 3. Authenticate
+
+```bash
+./bin/basecamp auth
+```
+
+This opens your browser for OAuth authorization. After approving, the token is saved to `~/.basecamp_token.json`.
+
+## Commands
+
+### `basecamp projects`
+
+List all projects in your account.
+
+```
+$ basecamp projects
+Projects
+============================================================
+[*] 12345678  Website Redesign
+    Main company website overhaul
+[*] 23456789  Mobile App
+    iOS and Android development
+[ ] 34567890  Old Project
+    Archived project
+
+[*] = active
+```
+
+**Output:**
+- `[*]` indicates active projects, `[ ]` indicates inactive
+- Project ID and name on each line
+- Description (if set) indented below
+
+---
+
+### `basecamp boards <project_id>`
+
+List card tables (Kanban boards) in a project, with column summary.
+
+```
+$ basecamp boards 12345678
+Card Tables in: Website Redesign
+============================================================
+87654321  Development Tasks
+
+Columns:
+  - Backlog (12 cards)
+  - In Progress (3 cards)
+  - Review (2 cards)
+  - Done (45 cards)
+```
+
+**Output:**
+- Board ID and title
+- List of columns with card counts
+
+---
+
+### `basecamp cards <project_id> <board_id> [--column <name>]`
+
+List cards in a board. Use `--column` to filter by column name (partial match).
+
+```
+$ basecamp cards 12345678 87654321
+Cards: Development Tasks
+======================================================================
+
+Backlog (12)
+----------------------------------------
+  11111111  Fix login validation
+           by Jane Smith
+  22222222  Add password reset flow
+           by John Doe
+  33333333  Update API documentation
+           by Jane Smith
+
+In Progress (3)
+----------------------------------------
+  44444444  Implement dark mode
+           by John Doe
+```
+
+With column filter:
+
+```
+$ basecamp cards 12345678 87654321 --column "Progress"
+Cards: Development Tasks
+======================================================================
+
+In Progress (3)
+----------------------------------------
+  44444444  Implement dark mode
+           by John Doe
+  55555555  Refactor authentication
+           by Jane Smith
+  66666666  Add unit tests
+           by John Doe
+```
+
+**Output:**
+- Cards grouped by column
+- Card ID and title
+- Creator name
+
+---
+
+### `basecamp card <project_id> <card_id> [--comments]`
+
+View full details of a single card. Use `--comments` to include comments.
+
+```
+$ basecamp card 12345678 44444444 --comments
+Card: Implement dark mode
+======================================================================
+
+ID:       44444444
+Creator:  John Doe
+Created:  2025-01-15T09:30:00.000Z
+Updated:  2025-01-20T14:22:00.000Z
+URL:      https://3.basecamp.com/12345678/buckets/.../cards/44444444
+Assigned: Jane Smith, Bob Wilson
+
+Description:
+----------------------------------------
+Add dark mode support to the application. Should respect system
+preferences and allow manual toggle. See design specs in Figma.
+
+Comments (2):
+----------------------------------------
+
+Jane Smith (2025-01-16T10:00:00.000Z):
+I've started on the color palette. Will share preview tomorrow.
+
+John Doe (2025-01-17T09:15:00.000Z):
+Looks great! Let's also add a toggle in the settings menu.
+```
+
+**Output:**
+- Card metadata (ID, creator, timestamps, URL, assignees)
+- Full description text (HTML stripped)
+- Comments with author and timestamp (when `--comments` flag used)
+
+---
+
+### `basecamp move <project_id> <board_id> <card_id> --to <column>`
+
+Move a card to a different column.
+
+```
+$ basecamp move 12345678 87654321 44444444 --to "Review"
+Card 44444444 moved to 'Review'
+```
+
+**Output:**
+- Confirmation message with card ID and target column
+
+---
+
+## Configuration Files
+
+| File | Purpose |
+|------|---------|
+| `~/.basecamp.json` | Client credentials and account ID |
+| `~/.basecamp_token.json` | OAuth access token (auto-generated) |
+
+### `~/.basecamp.json` format
+
+```json
+{
+  "client_id": "your_client_id",
+  "client_secret": "your_client_secret",
+  "account_id": "12345678",
+  "redirect_uri": "http://localhost:3002/callback"
+}
+```
+
+## API Coverage
+
+Progress towards full [Basecamp API](https://github.com/basecamp/bc3-api) implementation.
+
+### Projects & Structure
+- [x] Projects - list
+- [ ] Projects - create, update, delete
+- [ ] Basecamps (workspaces)
+- [ ] Templates
+
+### Card Tables (Kanban)
+- [x] Card tables - list, get
+- [x] Card table cards - list, get, move
+- [ ] Card table cards - create, update, delete
+- [ ] Card table columns - list, create, update, delete
+- [ ] Card table steps
+
+### To-dos
+- [ ] Todosets
+- [ ] Todolists
+- [ ] Todolist groups
+- [ ] Todos - list, create, update, complete, delete
+
+### Communication
+- [ ] Message boards
+- [ ] Messages
+- [ ] Message types
+- [x] Comments - list (on cards)
+- [ ] Comments - create, update, delete
+- [ ] Campfires (chat)
+- [ ] Chatbots
+
+### Documents & Files
+- [ ] Vaults (folders)
+- [ ] Documents
+- [ ] Uploads
+- [ ] Attachments
+
+### Schedule
+- [ ] Schedules
+- [ ] Schedule entries
+
+### Check-ins
+- [ ] Questionnaires
+- [ ] Questions
+- [ ] Question answers
+
+### Email
+- [ ] Inboxes
+- [ ] Inbox replies
+- [ ] Forwards
+
+### Client Portal
+- [ ] Client visibility
+- [ ] Client approvals
+- [ ] Client correspondences
+- [ ] Client replies
+
+### People & Permissions
+- [ ] People - list, get
+- [ ] Subscriptions
+
+### Other
+- [ ] Events
+- [ ] Recordings
+- [ ] Reports
+- [ ] Search
+- [ ] Timeline
+- [ ] Lineup markers
+- [ ] Rich text
+- [ ] Webhooks
+
+## License
+
+MIT

data/bin/basecamp

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/basecamp/cli'
+
+Basecamp::CLI.new.run(ARGV)

data/lib/basecamp/cli.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+require 'json'
+require_relative 'version'
+require_relative 'config'
+require_relative 'client'
+require_relative 'commands/init'
+require_relative 'commands/auth'
+require_relative 'commands/projects'
+require_relative 'commands/boards'
+require_relative 'commands/cards'
+require_relative 'commands/card'
+require_relative 'commands/move'
+
+module Basecamp
+  class CLI
+    HELP = <<~HELP
+      Usage: basecamp <command> [options]
+
+      Commands:
+        init                              Configure the CLI (client_id, secret, account)
+        auth                              Authenticate with Basecamp (OAuth)
+        projects                          List all projects
+        boards <project_id>               List card tables in a project
+        cards <project_id> <board_id>     List cards (--column <name> to filter)
+        card <project_id> <card_id>       Show card details (--comments for comments)
+        move <project_id> <board_id> <card_id> --to <column>   Move a card
+        version                           Show version
+
+      Examples:
+        basecamp projects
+        basecamp boards 12345678
+        basecamp cards 12345678 87654321 --column "Doing"
+        basecamp card 12345678 11111111 --comments
+        basecamp move 12345678 87654321 11111111 --to "Done"
+    HELP
+
+    def run(args)
+      if args.empty? || args.first == 'help' || args.first == '--help' || args.first == '-h'
+        puts HELP
+        return
+      end
+
+      command = args.shift
+
+      case command
+      when 'version', '--version', '-v'
+        puts "basecamp-cli #{VERSION}"
+        return
+      when 'init'
+        Commands::Init.new.run
+      when 'auth'
+        Commands::Auth.new.run
+      when 'projects'
+        Commands::Projects.new.run
+      when 'boards'
+        project_id = args.shift or raise "Usage: basecamp boards <project_id>"
+        Commands::Boards.new.run(project_id)
+      when 'cards'
+        project_id = args.shift or raise "Usage: basecamp cards <project_id> <board_id>"
+        board_id = args.shift or raise "Usage: basecamp cards <project_id> <board_id>"
+        column = extract_option(args, '--column')
+        Commands::Cards.new.run(project_id, board_id, column: column)
+      when 'card'
+        project_id = args.shift or raise "Usage: basecamp card <project_id> <card_id>"
+        card_id = args.shift or raise "Usage: basecamp card <project_id> <card_id>"
+        comments = args.include?('--comments')
+        Commands::Card.new.run(project_id, card_id, comments: comments)
+      when 'move'
+        project_id = args.shift or raise "Usage: basecamp move <project_id> <board_id> <card_id> --to <column>"
+        board_id = args.shift or raise "Usage: basecamp move <project_id> <board_id> <card_id> --to <column>"
+        card_id = args.shift or raise "Usage: basecamp move <project_id> <board_id> <card_id> --to <column>"
+        to = extract_option(args, '--to') or raise "Usage: basecamp move ... --to <column>"
+        Commands::Move.new.run(project_id, board_id, card_id, to: to)
+      else
+        puts "Unknown command: #{command}"
+        puts HELP
+        exit 1
+      end
+    rescue => e
+      $stderr.puts "Error: #{e.message}"
+      exit 1
+    end
+
+    private
+
+    def extract_option(args, flag)
+      idx = args.index(flag)
+      return nil unless idx
+
+      args.delete_at(idx)
+      args.delete_at(idx)
+    end
+  end
+end

data/lib/basecamp/client.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'uri'
+require 'json'
+require 'openssl'
+
+module Basecamp
+  class Client
+    USER_AGENT = 'Basecamp CLI (https://github.com/rzolkos/basecamp-cli)'
+
+    def initialize
+      @token = Config.token
+    end
+
+    def get(path)
+      url = path.start_with?('http') ? path : "#{Config.api_base_url}#{path}"
+      request(:get, url)
+    end
+
+    def post(path, data = {})
+      url = path.start_with?('http') ? path : "#{Config.api_base_url}#{path}"
+      request(:post, url, data)
+    end
+
+    def put(path, data = {})
+      url = path.start_with?('http') ? path : "#{Config.api_base_url}#{path}"
+      request(:put, url, data)
+    end
+
+    # Fetch all pages of a paginated endpoint
+    def get_all(path)
+      results = []
+      url = path.start_with?('http') ? path : "#{Config.api_base_url}#{path}"
+
+      loop do
+        response = request_raw(:get, url)
+        results.concat(JSON.parse(response.body))
+
+        # Check for next page
+        link_header = response['Link']
+        break unless link_header
+
+        next_link = link_header.split(',').find { |l| l.include?('rel="next"') }
+        break unless next_link
+
+        url = next_link.match(/<([^>]+)>/)[1]
+      end
+
+      results
+    end
+
+    private
+
+    def request(method, url, data = nil)
+      response = request_raw(method, url, data)
+      return nil if response.body.nil? || response.body.empty?
+      JSON.parse(response.body)
+    end
+
+    def request_raw(method, url, data = nil)
+      uri = URI(url)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+      http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+
+      request = case method
+                when :get then Net::HTTP::Get.new(uri.request_uri)
+                when :post then Net::HTTP::Post.new(uri.request_uri)
+                when :put then Net::HTTP::Put.new(uri.request_uri)
+                end
+
+      request['Authorization'] = "Bearer #{@token}"
+      request['User-Agent'] = USER_AGENT
+      request['Content-Type'] = 'application/json' if data
+
+      request.body = data.to_json if data
+
+      response = http.request(request)
+
+      unless response.is_a?(Net::HTTPSuccess)
+        raise "API error: #{response.code} #{response.message}\n#{response.body}"
+      end
+
+      response
+    end
+  end
+end

data/lib/basecamp/commands/auth.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+require 'webrick'
+require 'net/http'
+require 'uri'
+require 'json'
+require 'openssl'
+
+module Basecamp
+  module Commands
+    class Auth
+      def run
+        puts "Basecamp OAuth Authentication"
+        puts "=" * 40
+
+        @auth_code = nil
+        start_server
+        open_authorization_url
+        wait_for_callback
+        exchange_code_for_token
+
+        puts "\nAuthentication successful!"
+        puts "Token saved to: #{Config::TOKEN_FILE}"
+      end
+
+      private
+
+      def start_server
+        port = URI(Config.redirect_uri).port || 3002
+        puts "\nStarting callback server on port #{port}..."
+
+        @server = WEBrick::HTTPServer.new(
+          Port: port,
+          Logger: WEBrick::Log.new('/dev/null'),
+          AccessLog: []
+        )
+
+        @server.mount_proc '/callback' do |req, res|
+          @auth_code = req.query['code']
+
+          res.status = 200
+          res.content_type = 'text/html'
+          res.body = if @auth_code
+                       '<html><body style="font-family:sans-serif;text-align:center;padding:50px;">' \
+                       '<h1>Authentication Successful!</h1><p>You can close this window.</p></body></html>'
+                     else
+                       '<html><body style="font-family:sans-serif;text-align:center;padding:50px;">' \
+                       '<h1>Authentication Failed</h1><p>No authorization code received.</p></body></html>'
+                     end
+        end
+
+        Thread.new { @server.start }
+        sleep 0.5
+      end
+
+      def open_authorization_url
+        params = URI.encode_www_form(
+          type: 'web_server',
+          client_id: Config.client_id,
+          redirect_uri: Config.redirect_uri
+        )
+        auth_url = "#{Config::AUTHORIZATION_URL}?#{params}"
+
+        puts "\nOpening browser for authorization..."
+        puts "URL: #{auth_url}"
+        puts "\nIf browser doesn't open, copy the URL above."
+
+        system("xdg-open '#{auth_url}' 2>/dev/null || open '#{auth_url}' 2>/dev/null || true")
+      end
+
+      def wait_for_callback
+        puts "\nWaiting for authorization..."
+
+        timeout = 120
+        start = Time.now
+
+        until @auth_code
+          sleep 0.5
+          if Time.now - start > timeout
+            @server.shutdown
+            raise 'Timeout waiting for authorization'
+          end
+        end
+
+        @server.shutdown
+        puts "Authorization code received"
+      end
+
+      def exchange_code_for_token
+        puts "\nExchanging code for token..."
+
+        uri = URI(Config::TOKEN_URL)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+
+        request = Net::HTTP::Post.new(uri.path)
+        request.set_form_data(
+          type: 'web_server',
+          client_id: Config.client_id,
+          client_secret: Config.client_secret,
+          redirect_uri: Config.redirect_uri,
+          code: @auth_code
+        )
+
+        response = http.request(request)
+
+        unless response.is_a?(Net::HTTPSuccess)
+          raise "Token exchange failed: #{response.code} #{response.message}\n#{response.body}"
+        end
+
+        token_data = JSON.parse(response.body, symbolize_names: true)
+        Config.save_token(token_data)
+      end
+    end
+  end
+end

data/lib/basecamp/commands/boards.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Commands
+    class Boards
+      def run(project_id)
+        client = Client.new
+
+        # Get project details to find the card table dock
+        project = client.get("/projects/#{project_id}.json")
+
+        puts "Card Tables in: #{project['name']}"
+        puts "=" * 60
+
+        # Find card tables in the dock
+        dock = project['dock'] || []
+        card_table_dock = dock.find { |d| d['name'] == 'kanban_board' }
+
+        unless card_table_dock
+          puts "No card table found in this project."
+          return
+        end
+
+        # Get the card table
+        card_table_url = card_table_dock['url']
+        card_table = client.get(card_table_url)
+
+        puts "#{card_table['id']}  #{card_table['title']}"
+
+        # Show columns summary
+        lists = card_table['lists'] || []
+        if lists.any?
+          puts ""
+          puts "Columns:"
+          lists.each do |list|
+            puts "  - #{list['title']} (#{list['cards_count']} cards)"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/basecamp/commands/card.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Commands
+    class Card
+      def run(project_id, card_id, comments: false)
+        client = Client.new
+
+        card = client.get("/buckets/#{project_id}/card_tables/cards/#{card_id}.json")
+
+        puts "Card: #{card['title']}"
+        puts "=" * 70
+        puts ""
+        puts "ID:       #{card['id']}"
+        puts "Creator:  #{card.dig('creator', 'name')}"
+        puts "Created:  #{card['created_at']}"
+        puts "Updated:  #{card['updated_at']}"
+        puts "URL:      #{card['app_url']}"
+
+        if card['assignees'] && !card['assignees'].empty?
+          names = card['assignees'].map { |a| a['name'] }.join(', ')
+          puts "Assigned: #{names}"
+        end
+
+        puts ""
+        puts "Description:"
+        puts "-" * 40
+        description = strip_html(card['content'] || card['description'] || 'No description')
+        puts description
+        puts ""
+
+        if comments && card['comments_count']&.positive?
+          puts "Comments (#{card['comments_count']}):"
+          puts "-" * 40
+
+          all_comments = client.get_all(card['comments_url'])
+
+          all_comments.each do |comment|
+            author = comment.dig('creator', 'name') || 'Unknown'
+            content = strip_html(comment['content'] || '')
+            created = comment['created_at']
+
+            puts ""
+            puts "#{author} (#{created}):"
+            puts content
+          end
+        end
+      end
+
+      private
+
+      def strip_html(html)
+        return '' unless html
+        html.gsub(/<[^>]*>/, ' ').gsub(/\s+/, ' ').strip
+      end
+    end
+  end
+end

data/lib/basecamp/commands/cards.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Commands
+    class Cards
+      def run(project_id, board_id, column: nil)
+        client = Client.new
+
+        # Get the card table
+        card_table = client.get("/buckets/#{project_id}/card_tables/#{board_id}.json")
+
+        puts "Cards: #{card_table['title']}"
+        puts "=" * 70
+
+        lists = card_table['lists'] || []
+
+        if lists.empty?
+          puts "No columns found."
+          return
+        end
+
+        lists.each do |list|
+          column_name = list['title']
+
+          # Filter by column if specified
+          if column
+            next unless column_name.downcase.include?(column.downcase)
+          end
+
+          next if list['cards_count'].zero?
+
+          puts ""
+          puts "#{column_name} (#{list['cards_count']})"
+          puts "-" * 40
+
+          # Fetch cards from this column
+          cards = client.get(list['cards_url'])
+
+          cards.each do |card|
+            creator = card.dig('creator', 'name') || 'Unknown'
+            puts "  #{card['id']}  #{card['title']}"
+            puts "           by #{creator}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/basecamp/commands/init.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Commands
+    class Init
+      def run(client_id: nil, client_secret: nil, account_id: nil, redirect_uri: nil)
+        puts "Basecamp CLI Configuration"
+        puts "=" * 40
+
+        config = {}
+
+        config[:client_id] = client_id || prompt("Client ID")
+        config[:client_secret] = client_secret || prompt("Client Secret")
+        config[:account_id] = account_id || prompt("Account ID")
+        config[:redirect_uri] = redirect_uri || prompt("Redirect URI", default: "http://localhost:3002/callback")
+
+        Config.save(config)
+
+        puts "\nConfiguration saved to: #{Config::CONFIG_FILE}"
+        puts "Run 'basecamp auth' to authenticate."
+      end
+
+      private
+
+      def prompt(label, default: nil)
+        if default
+          print "#{label} [#{default}]: "
+        else
+          print "#{label}: "
+        end
+
+        value = $stdin.gets.chomp
+        value.empty? ? default : value
+      end
+    end
+  end
+end

data/lib/basecamp/commands/move.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Commands
+    class Move
+      def run(project_id, board_id, card_id, to:)
+        client = Client.new
+
+        # Get the card table to find the target column
+        card_table = client.get("/buckets/#{project_id}/card_tables/#{board_id}.json")
+
+        lists = card_table['lists'] || []
+        target_column = lists.find { |l| l['title'].downcase == to.downcase }
+
+        unless target_column
+          puts "Column '#{to}' not found."
+          puts "Available columns: #{lists.map { |l| l['title'] }.join(', ')}"
+          return
+        end
+
+        # Move the card
+        client.post("/buckets/#{project_id}/card_tables/cards/#{card_id}/moves.json", {
+          column_id: target_column['id']
+        })
+
+        puts "Card #{card_id} moved to '#{target_column['title']}'"
+      end
+    end
+  end
+end

data/lib/basecamp/commands/projects.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Commands
+    class Projects
+      def run
+        client = Client.new
+        projects = client.get('/projects.json')
+
+        if projects.empty?
+          puts "No projects found."
+          return
+        end
+
+        puts "Projects"
+        puts "=" * 60
+
+        projects.each do |project|
+          status = project['status']
+          status_icon = status == 'active' ? '*' : ' '
+
+          puts "[#{status_icon}] #{project['id']}  #{project['name']}"
+          puts "    #{project['description']}" if project['description'] && !project['description'].empty?
+        end
+
+        puts ""
+        puts "[*] = active"
+      end
+    end
+  end
+end

data/lib/basecamp/config.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module Basecamp
+  class Config
+    CONFIG_FILE = File.expand_path('~/.basecamp.json')
+    TOKEN_FILE = File.expand_path('~/.basecamp_token.json')
+
+    # OAuth endpoints
+    AUTHORIZATION_URL = 'https://launchpad.37signals.com/authorization/new'
+    TOKEN_URL = 'https://launchpad.37signals.com/authorization/token'
+
+    class << self
+      def load
+        return @config if @config
+
+        unless File.exist?(CONFIG_FILE)
+          raise "Config file not found: #{CONFIG_FILE}\nRun 'basecamp init' to create one."
+        end
+
+        @config = JSON.parse(File.read(CONFIG_FILE), symbolize_names: true)
+      end
+
+      def save(config)
+        File.write(CONFIG_FILE, JSON.pretty_generate(config))
+        @config = config
+      end
+
+      def client_id
+        load[:client_id]
+      end
+
+      def client_secret
+        load[:client_secret]
+      end
+
+      def account_id
+        load[:account_id]
+      end
+
+      def redirect_uri
+        load[:redirect_uri] || 'http://localhost:3002/callback'
+      end
+
+      def api_base_url
+        "https://3.basecampapi.com/#{account_id}"
+      end
+
+      def token
+        return @token if @token
+
+        unless File.exist?(TOKEN_FILE)
+          raise "Not authenticated. Run 'basecamp auth' first."
+        end
+
+        token_data = JSON.parse(File.read(TOKEN_FILE), symbolize_names: true)
+
+        if token_data[:expires_at] && Time.now.to_i > token_data[:expires_at]
+          raise "Token expired. Run 'basecamp auth' to refresh."
+        end
+
+        @token = token_data[:access_token]
+      end
+
+      def save_token(token_data)
+        token_data[:expires_at] = Time.now.to_i + token_data[:expires_in] if token_data[:expires_in]
+        File.write(TOKEN_FILE, JSON.pretty_generate(token_data))
+        @token = token_data[:access_token]
+      end
+
+      def clear_token_cache
+        @token = nil
+      end
+    end
+  end
+end

data/lib/basecamp/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Basecamp
+  VERSION = '0.1.0'
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification
+name: basecamp-cli
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Rob Zolkos
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-01-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: webrick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+description: A simple CLI for Basecamp. List projects, browse card tables, view cards,
+  and move cards between columns.
+email:
+- rob@zolkos.com
+executables:
+- basecamp
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/basecamp
+- lib/basecamp/cli.rb
+- lib/basecamp/client.rb
+- lib/basecamp/commands/auth.rb
+- lib/basecamp/commands/boards.rb
+- lib/basecamp/commands/card.rb
+- lib/basecamp/commands/cards.rb
+- lib/basecamp/commands/init.rb
+- lib/basecamp/commands/move.rb
+- lib/basecamp/commands/projects.rb
+- lib/basecamp/config.rb
+- lib/basecamp/version.rb
+homepage: https://github.com/robzolkos/ruby-basecamp-cli
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/robzolkos/ruby-basecamp-cli
+  source_code_uri: https://github.com/robzolkos/ruby-basecamp-cli
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Command-line interface for Basecamp
+test_files: []