cli

Tambo CLI

适合 Agent 使用的 CLI，用于项目初始化和组件管理。

快速开始

npx tambo init --api-key=sk_...              # Initialize with API key
npx tambo add message-thread-full --yes      # Add a component
npx tambo create-app my-app --template=standard  # New app from template

非交互模式

CLI 会检测非交互环境，并提供操作指引，而不是一直等待：

# In CI or piped environments, this returns guidance (exit 2) instead of prompting
npx tambo init
# Error: Project name required.
# Run one of:
#   tambo init --project-name=myapp    # Create new project
#   tambo init --project-id=abc123     # Use existing project

检测逻辑

满足以下任意条件时，即为非交互模式：

• process.stdin.isTTY 为 false（输入通过管道传入）
• process.stdout.isTTY 为 false（输出通过管道传出）
• 已设置 CI 环境变量
• GITHUB_ACTIONS=true

使用 FORCE_INTERACTIVE=1 覆盖（需要真实的 TTY）。

退出代码

代码	含义
0	成功
1	错误（网络、无效参数等）
2	需要用户操作——查看 stderr 获取准确命令

供 Agent 使用的命令

初始化项目

# Option 1: Direct API key (simplest for agents)
npx tambo init --api-key=sk_...

# Option 2: Create new project (requires prior auth)
npx tambo init --project-name=myapp

# Option 3: Use existing project
npx tambo init --project-id=abc123

# Skip all prompts with defaults
npx tambo init --yes --project-name=myapp

添加组件

npx tambo add form --yes                    # Skip confirmation
npx tambo add form graph --yes              # Multiple components
npx tambo add form --prefix=src/components  # Custom directory
npx tambo add form --dry-run                # Preview changes
npx tambo add form --legacy-peer-deps       # For dependency conflicts

组件库

在 ui.tambo.co 浏览并预览所有组件。

可用组件

组件	描述
message-thread-full	完整的消息线程，包含所有内容和交互
message-thread-panel	在侧边面板或模态框中显示消息线程
message-thread-collapsible	可展开或折叠的消息线程
message	支持 Markdown 的独立消息
message-input	撰写并发送对话消息
message-suggestions	AI 生成的建议，帮助用户撰写回复
control-bar	界面中的控件和操作
input-fields	可重复使用的输入字段，带有样式和验证
graph	可视化基于图的数据结构
form	收集用户输入并支持验证
map	支持聚类和热力图的交互式地图
canvas-space	显示聊天消息中的渲染组件
thread-history	对话线程的时间顺序历史记录
thread-dropdown	可折叠聊天线程的下拉菜单
thread-content	显示线程中的消息
scrollable-message-container	自动滚动到新消息的容器
edit-with-tambo-button	用于可交互组件的内嵌 AI 编辑器按钮
elicitation-ui	用于用户输入请求的 MCP elicitation UI
mcp-components	MCP 提示词和资源选择按钮

你将获得

每个组件都包含：

• 源代码，复制到你的项目中（不是依赖项）
• Tambo 集成，已预先配置好钩子
• 通过 Tailwind CSS 提供的样式（可自定义）
• TypeScript 和完整的类型定义

示例：完整聊天界面

npx tambo add message-thread-full control-bar --yes

这会添加一个完整的聊天 UI，其中包含：

• 消息历史记录显示
• AI 生成的组件渲染
• 带发送按钮的输入栏
• 流式状态指示器

列出组件（无提示词）

npx tambo list --yes

创建新应用

npx tambo create-app my-app --template=standard

身份验证

npx tambo auth login --no-browser   # Prints URL instead of opening browser
npx tambo auth status               # Check current auth (no prompts)

完整设置（一条命令）

npx tambo full-send    # Complete setup with components

Agent 文档

CLI 会自动创建/更新 AGENTS.md，其中包含 Tambo 文档：

npx tambo add form --yes   # Also updates AGENTS.md

生成的部分包含适用于非交互模式的 CLI 命令。

关键标志摘要

标志	命令	用途
--yes、-y	init、add、list	跳过所有提示
--api-key	init	直接输入 API 密钥
--project-name	init	创建新项目
--project-id	init	使用现有项目
--no-browser	auth login	输出 URL，而不是打开网页
--dry-run	add	预览但不安装
--prefix	add、list	自定义组件目录