Basecamp CLI

@drkraft/basecamp-cli

Basecamp 4的综合命令行界面和MCP服务器。通过您的终端或人工智能助手管理项目、待办事项、消息、时间表、看板等。

特性

• 完整CLI -21个指挥组，涵盖整个API基地4
• MCP服务器 -76个AI助手集成工具（Claude等）
• 多种输出格式 -所有命令的表或JSON输出
• 分页和重试 -自动处理大型数据集和速率限制
• OAuth 2.0 -通过浏览器进行安全身份验证

安装

npm install -g @drkraft/basecamp-cli

或者搭配包子：

bun add -g @drkraft/basecamp-cli

需求

• Node.js>=20

快速开始

1.创建大本营集成

1. 首选 Basecamp集成
2. 点击“注册另一个应用程序”
3. 填写详细信息：

- 名字：您的应用程序名称 - 公司：贵公司 - 网站：您的网站 - 重定向URI: http://localhost:9292/callback

1. 注意你的 客户端ID 和 客户端密钥

2.配置凭据

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

或者通过CLI进行配置：

basecamp auth configure --client-id "your-client-id"

3.登录

basecamp auth login

这将打开您的浏览器进行OAuth身份验证。

CLI参考

认证

basecamp auth login          # Login via OAuth
basecamp auth status         # Check auth status
basecamp auth logout         # Logout

账户

basecamp accounts            # List available accounts
basecamp account set     # Set current account
basecamp account current     # Show current account

项目

basecamp projects list                                    # List all projects
basecamp projects get                                 # Get project details
basecamp projects create --name "Project" --description "Desc"  # Create project
basecamp projects archive                             # Archive project

待办事项列表和待办事项

# To-do lists
basecamp todolists list --project 
basecamp todolists create --project  --name "Tasks"
basecamp todolists delete  --project 

# To-dos
basecamp todos list --project  --list 

basecamp todos list --project  --list 
 --completed
basecamp todos get  --project 

basecamp todos create --project  --list 
 --content "Task"
basecamp todos create --project  --list 
 --content "Task" \
  --due "2025-12-31" --assignees "123,456"
basecamp todos update  --project 
 --content "Updated"
basecamp todos complete  --project 

basecamp todos uncomplete  --project 

basecamp todos delete  --project 

basecamp todos move  --project 
 --list 

# To-do groups
basecamp todogroups list --project 
basecamp todogroups create --project  --name "Sprint 1"

消息

basecamp messages list --project 
basecamp messages get  --project 

basecamp messages create --project  --subject "Subject" --content "
HTML
"

篝火（聊天）

basecamp campfires list --project 
basecamp campfires lines --project  --campfire 
basecamp campfires send --project  --campfire  --message "Hello!"

评论

basecamp comments list --project  --recording 
basecamp comments get  --project 

basecamp comments create --project  --recording  --content "
Comment
"
basecamp comments update  --project 
 --content "
Updated
"
basecamp comments delete  --project 

文件和保险库

# Vaults (folders)
basecamp vaults list --project 
basecamp vaults get  --project 

basecamp vaults create --project  --vault 
 --title "Folder Name"

# Documents
basecamp documents list --project  --vault 
basecamp documents get  --project 

basecamp documents create --project  --vault  --title "Doc" --content "
...
"
basecamp documents update  --project 
 --title "New Title"

# Uploads
basecamp uploads list --project  --vault 
basecamp uploads get  --project 

日程表

basecamp schedules get --project 
basecamp schedules entries --project 
basecamp schedules entries --project  --status upcoming
basecamp schedules create-entry --project  --summary "Meeting" \
  --starts-at "2025-02-15T10:00:00" --ends-at "2025-02-15T11:00:00"
basecamp schedules update-entry  --project 
 --summary "Updated"
basecamp schedules delete-entry  --project 

卡片表（看板）

basecamp cardtables get --project 
basecamp cardtables columns --project 
basecamp cardtables create-column --project  --title "In Progress"
basecamp cardtables cards --project  --column 
basecamp cardtables create-card --project  --column  --title "Card"
basecamp cardtables move-card  --project  --column 

网络钩子

basecamp webhooks list --project 
basecamp webhooks get  --project 

basecamp webhooks create --project  --payload-url "https://..."
basecamp webhooks update  --project 
 --active false
basecamp webhooks delete  --project 

录音和活动

# Recordings (cross-project content)
basecamp recordings list --type Todo
basecamp recordings list --type Message --status archived
basecamp recordings archive  --project 

basecamp recordings restore  --project 

basecamp recordings trash  --project 

# Events (activity feed)
basecamp events list --project  --recording 

订阅

basecamp subscriptions list --project  --recording 
basecamp subscriptions subscribe --project  --recording 
basecamp subscriptions unsubscribe --project  --recording 

搜索

basecamp search "keyword"
basecamp search "keyword" --type Todo
basecamp search "keyword" --project 

人们

basecamp people list
basecamp people list --project 
basecamp people get 
basecamp people me

输出格式

所有命令支持 --format 标志：

basecamp projects list --format table   # Default, human-readable
basecamp projects list --format json    # JSON for scripting

全局选项

basecamp --verbose projects list   # Enable debug output
basecamp -v people me              # Short form

MCP服务器

CLI包括一个用于AI助手集成的MCP（模型上下文协议）服务器。

启动服务器

basecamp-mcp
# Or
bun run mcp

可用工具（76）

使用OpenCode/Claude

添加到MCP配置中：

{
  "mcpServers": {
    "basecamp": {
      "command": "basecamp-mcp",
      "env": {
        "BASECAMP_CLIENT_ID": "",
        "BASECAMP_CLIENT_SECRET": ""
      }
    }
  }
}

或者使用明确的路径：

{
  "mcpServers": {
    "basecamp": {
      "command": "node",
      "args": ["/path/to/node_modules/@drkraft/basecamp-cli/dist/mcp.js"]
    }
  }
}

环境变量

API覆盖范围

此CLI涵盖完整的Basecamp 4 API第1层域：

发展

# Clone the repo
git clone https://github.com/drkraft/basecamp-cli
cd basecamp-cli

# Install dependencies
bun install

# Build
bun run build

# Run tests
bun test

# Run validation against real Basecamp
bun run scripts/validate.ts

贡献

看 贡献.md 作为指导方针。

许可证

麻省理工学院-见 许可证 了解详情。

学分

最初分叉自 @emredoganer/basecamp-cli.