Tanager

Tanager Forms CLI — surveys, lists, responses, and AI insights for agents and humans.

Installation

npm install -g tanager-forms

Quick Start

# Configure your API key and workspace
tanager config set apiKey tnfr_live_...
tanager config set workspaceId <your-workspace-uuid>

# Check authentication
tanager auth status

# Create a form and get a shareable link
tanager ask "What's your favorite color?"

# List your surveys
tanager surveys list

# Generate AI insights
tanager insights <surveyId>

Configuration

The CLI reads configuration from (highest priority first):

1. Environment variables: TANAGER_API_KEY, TANAGER_WORKSPACE_ID, TANAGER_URL
2. Config file: ~/.config/tanager/config.json
3. Defaults: tanagerUrl defaults to https://app.tanagerforms.com

Getting an API Key

1. Log in to the Tanager web app
2. Go to Settings > API Keys
3. Click Create API Key and assign it to your workspace(s)
4. Copy the key (shown once!) and run tanager config set apiKey tnfr_live_...

CLI Commands

tanager config set <key> <value>         Set apiKey, workspaceId, or tanagerUrl
tanager config get <key>                 Show a config value
tanager config list                      Show all config

tanager auth setup                       Setup instructions
tanager auth status                      Check auth + usage

tanager surveys list                     List all surveys
tanager surveys get <id>                 Show survey details
tanager surveys create [--template name] Create a survey
tanager surveys launch <id>              Launch a draft survey
tanager surveys generate <description>   AI-generate from description
tanager surveys delete <id>              Delete a survey

tanager lists list                       List respondent lists
tanager lists create <name>              Create a list
tanager lists members <id>               Show list members
tanager lists import <listId> <file>     Import members from JSON

tanager responses get <surveyId>         Get responses
tanager responses export <id> [--format] Export as CSV or JSON

tanager insights <surveyId>              AI-generated insights

tanager ask <description>                Quick: create form + share link
tanager approve <description>            Quick: approval request + link

tanager templates list                   Show available templates
tanager templates use <name>             Create survey from template

tanager skills add --claude              Install skill for Claude Code
tanager skills add --codex               Install skill for Codex
tanager skills add --gemini              Install skill for Gemini CLI
tanager skills add --all                 Install for all agents
tanager skills add --all --global        Install to user-level (all projects)
tanager skills remove --all              Remove skill from all agents
tanager skills list                      Show installation status

Agent Skill

Tanager bundles a SKILL.md that teaches AI coding agents how to use the CLI. Install it with one command:

# Install for your agent(s)
tanager skills add --claude --codex

# Or install for all supported agents
tanager skills add --all

| Agent | Directory | Notes | |---|---|---| | Claude Code | .claude/skills/tanager/ | Native skill discovery | | Codex | .agents/skills/tanager/ | Native skill discovery | | Gemini CLI | .gemini/skills/tanager/ | Native skill discovery | | OpenCode | (automatic) | Auto-discovers .claude/ and .agents/ skills |

Use --global to install to your home directory (applies to all projects).

License

MIT