Tambo CLI

Agent-friendly CLI for project setup and component management.

Quick Start

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

Non-Interactive Mode

The CLI detects non-interactive environments and returns guidance instead of hanging:

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

Detection Logic

Non-interactive when ANY of these are true:

• process.stdin.isTTY is false (piped input)
• process.stdout.isTTY is false (piped output)
• CI environment variable is set
• GITHUB_ACTIONS=true

Override with FORCE_INTERACTIVE=1 (requires real TTY).

Exit Codes

Commands for Agents

Initialize Project

bash
1# Option 1: Direct API key (simplest for agents)
2npx tambo init --api-key=sk_...
3
4# Option 2: Create new project (requires prior auth)
5npx tambo init --project-name=myapp
6
7# Option 3: Use existing project
8npx tambo init --project-id=abc123
9
10# Skip all prompts with defaults
11npx tambo init --yes --project-name=myapp

Add Components

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

Component Library

Browse and preview all components at ui.tambo.co.

Available Components

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
1npx tambo add message-thread-full control-bar --yes

This 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
1npx tambo list --yes

Create New App

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

Authentication

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

Full Setup (One Command)

bash
1npx tambo full-send    # Complete setup with components

Agent Docs

The CLI auto-creates/updates AGENTS.md with Tambo documentation:

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

The generated section includes CLI commands formatted for non-interactive use.

Key Flags Summary