cli
Original：🇺🇸 English
Translated
Tambo CLI reference for project setup and component installation. Agent-friendly with non-interactive mode and exit codes. Use when running tambo init, tambo add, npx tambo commands, or browsing the component library. For guided project creation with tech recommendations, use start-from-scratch skill. For adding Tambo to existing projects, use add-to-existing-project skill.
20installs
Sourcetambo-ai/tambo
Added on
NPX Install
npx skill4agent add tambo-ai/tambo cliTags
Translated version includes tags in frontmatterSKILL.md Content
View Translation Comparison →Tambo CLI
Agent-friendly CLI for project setup and component management.
Quick Start
bash
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 templateNon-Interactive Mode
The CLI detects non-interactive environments and returns guidance instead of hanging:
bash
# 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 projectDetection Logic
Non-interactive when ANY of these are true:
- is false (piped input)
process.stdin.isTTY - is false (piped output)
process.stdout.isTTY - environment variable is set
CI GITHUB_ACTIONS=true
Override with (requires real TTY).
FORCE_INTERACTIVE=1Exit Codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Error (network, invalid args, etc.) |
| 2 | User action required - check stderr for exact command |
Commands for Agents
Initialize Project
bash
# 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=myappAdd Components
bash
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 conflictsComponent Library
Browse and preview all components at ui.tambo.co.
Available Components
| Component | Description |
|---|---|
| Complete message thread with all content and interactions |
| Message thread in a side panel or modal context |
| Message threads that can be expanded or collapsed |
| Individual messages with markdown support |
| Composes and sends messages in a conversation |
| AI-generated suggestions to help users compose responses |
| Controls and actions in the interface |
| Reusable input fields with styles and validation |
| Visualizes graph-based data structures |
| Collects user input with validation support |
| Interactive map with clustering and heatmap support |
| Displays rendered components from chat messages |
| Chronological history of a conversation thread |
| Dropdown menu for collapsible chat threads |
| Displays messages within a thread |
| Container that auto-scrolls to new messages |
| Inline AI editor button for interactable components |
| MCP elicitation UI for user input requests |
| MCP prompt and resource picker buttons |
What You Get
Each component includes:
- Source code copied to your project (not a dependency)
- Tambo integration pre-configured with hooks
- Styling via Tailwind CSS (customizable)
- TypeScript with full type definitions
Example: Full Chat Interface
bash
npx tambo add message-thread-full control-bar --yesThis adds a complete chat UI with:
- Message history display
- AI-generated component rendering
- Input bar with send button
- Streaming status indicators
List Components (No Prompts)
bash
npx tambo list --yesCreate New App
bash
npx tambo create-app my-app --template=standardAuthentication
bash
npx tambo auth login --no-browser # Prints URL instead of opening browser
npx tambo auth status # Check current auth (no prompts)Full Setup (One Command)
bash
npx tambo full-send # Complete setup with componentsAgent Docs
The CLI auto-creates/updates with Tambo documentation:
AGENTS.mdbash
npx tambo add form --yes # Also updates AGENTS.mdThe generated section includes CLI commands formatted for non-interactive use.
Key Flags Summary
| Flag | Commands | Purpose |
|---|---|---|
| init, add, list | Skip all prompts |
| init | Direct API key input |
| init | Create new project |
| init | Use existing project |
| auth login | Output URL instead of opening |
| add | Preview without installing |
| add, list | Custom component directory |