Skip to content

cloudthinker-ai/CloudSkills / skills/connections/managing-basecamp

managing-basecamp

Unverified

Use when working with Basecamp — basecamp project management covering projects, to-do lists, messages, schedules, and team activity. Use when auditing Basecamp usage, managing to-dos and message boards, analyzing project activity, or reviewing team workload across Basecamp projects.

Managing Basecamp

Basecamp project management analysis via the Basecamp REST API.

Discovery Phase

#!/bin/bash
BC_BASE="https://3.basecampapi.com/$BASECAMP_ACCOUNT_ID"

echo "=== Current User ==="
curl -s -H "Authorization: Bearer $BASECAMP_TOKEN" \
  "https://launchpad.37signals.com/authorization.json" \
  | jq '{identity: .identity, accounts: [.accounts[] | {id, name, product}]}'

echo ""
echo "=== Projects ==="
curl -s -H "Authorization: Bearer $BASECAMP_TOKEN" \
  "$BC_BASE/projects.json" \
  | jq -r '.[] | "\(.id)\t\(.name[0:30])\t\(.status)\t\(.updated_at[0:10])"' | column -t

echo ""
echo "=== People ==="
curl -s -H "Authorization: Bearer $BASECAMP_TOKEN" \
  "$BC_BASE/people.json" \
  | jq -r '.[] | "\(.id)\t\(.name)\t\(.email_address)\t\(.admin)"' | column -t | head -20

echo ""
echo "=== Project Tools (first project) ==="
FIRST_PROJECT=$(curl -s -H "Authorization: Bearer $BASECAMP_TOKEN" \
  "$BC_BASE/projects.json" | jq -r '.[0].id')
curl -s -H "Authorization: Bearer $BASECAMP_TOKEN" \
  "$BC_BASE/projects/$FIRST_PROJECT.json" \
  | jq -r '.dock[] | "\(.name)\t\(.title)\tenabled=\(.enabled)"' | column -t

Analysis Phase

#!/bin/bash
BC_BASE="https://3.basecampapi.com/$BASECAMP_ACCOUNT_ID"
PROJECT_ID="${1:?Project ID required}"

echo "=== To-Do Lists ==="
TODOSET_ID=$(curl -s -H "Authorization: Bearer $BASECAMP_TOKEN" \
  "$BC_BASE/projects/$PROJECT_ID.json" | jq -r '.dock[] | select(.name == "todoset") | .id')
curl -s -H "Authorization: Bearer $BASECAMP_TOKEN" \
  "$BC_BASE/buckets/$PROJECT_ID/todosets/$TODOSET_ID/todolists.json" \
  | jq -r '.[] | "\(.id)\t\(.title[0:30])\tcompleted=\(.completed_ratio)"' | column -t

echo ""
echo "=== Recent Messages ==="
MSGBOARD_ID=$(curl -s -H "Authorization: Bearer $BASECAMP_TOKEN" \
  "$BC_BASE/projects/$PROJECT_ID.json" | jq -r '.dock[] | select(.name == "message_board") | .id')
curl -s -H "Authorization: Bearer $BASECAMP_TOKEN" \
  "$BC_BASE/buckets/$PROJECT_ID/message_boards/$MSGBOARD_ID/messages.json" \
  | jq -r '.[:10][] | "\(.created_at[0:10])\t\(.creator.name)\t\(.subject[0:40])"' | column -t

echo ""
echo "=== Upcoming Schedule Entries ==="
SCHEDULE_ID=$(curl -s -H "Authorization: Bearer $BASECAMP_TOKEN" \
  "$BC_BASE/projects/$PROJECT_ID.json" | jq -r '.dock[] | select(.name == "schedule") | .id')
curl -s -H "Authorization: Bearer $BASECAMP_TOKEN" \
  "$BC_BASE/buckets/$PROJECT_ID/schedules/$SCHEDULE_ID/entries.json" \
  | jq -r '.[:10][] | "\(.starts_at[0:10])\t\(.title[0:30])\t\(.creator.name)"' | column -t

echo ""
echo "=== Campfire (recent chat) ==="
CAMPFIRE_ID=$(curl -s -H "Authorization: Bearer $BASECAMP_TOKEN" \
  "$BC_BASE/projects/$PROJECT_ID.json" | jq -r '.dock[] | select(.name == "chat") | .id')
curl -s -H "Authorization: Bearer $BASECAMP_TOKEN" \
  "$BC_BASE/buckets/$PROJECT_ID/chats/$CAMPFIRE_ID/lines.json" \
  | jq -r '.[-10:][] | "\(.created_at[0:16])\t\(.creator.name)\t\(.content[0:50])"' | column -t

Output Format

BASECAMP PROJECT HEALTH: [project_name]
Status:        [status]
People:        [count]
Last Updated:  [date]

TO-DO LISTS
List                 Completed  Total
[title]              [n]        [n]

RECENT ACTIVITY
Date         Author       Type      Subject
[date]       [name]       message   [subject]
[date]       [name]       todo      [title]

SCHEDULE
Date         Event
[date]       [title]

Anti-Hallucination Rules

  1. NEVER assume resource names — always discover via CLI/API in Phase 1 before referencing in Phase 2.
  2. NEVER fabricate metric names or dimensions — verify against the service documentation or --help output.
  3. NEVER mix CLI commands between service versions — confirm which version/API you are targeting.
  4. ALWAYS use the discovery → verify → analyze chain — every resource referenced must have been discovered first.
  5. ALWAYS handle empty results gracefully — an empty response is valid data, not an error to retry.

Counter-Rationalizations

ShortcutCounterWhy
"I'll skip discovery and check known resources"Always run Phase 1 discovery firstResource names change, new resources appear — assumed names cause errors
"The user only asked for a quick check"Follow the full discovery → analysis flowQuick checks miss critical issues; structured analysis catches silent failures
"Default configuration is probably fine"Audit configuration explicitlyDefaults often leave logging, security, and optimization features disabled
"Metrics aren't needed for this"Always check relevant metrics when availableAPI/CLI responses show current state; metrics reveal trends and intermittent issues
"I don't have access to that"Try the command and report the actual errorAssumed permission failures prevent useful investigation; actual errors are informative
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 192kUpdated Claude CodeCodexVerifiedInstall