@zoobbe/cli

Manage your Zoobbe boards, cards, and projects from the terminal.

Installation

npm install -g @zoobbe/cli

Requires Node.js 18 or later.

Quick Start

# Login via browser (recommended)
zoobbe auth login

# Or authenticate directly with an API key
zoobbe auth login --token zb_live_xxxxx

# Set your active workspace
zoobbe workspace list
zoobbe workspace switch <workspace-id>

# Start managing your work
zoobbe board list
zoobbe card list --board <board-id>

Authentication

Browser Login (Recommended)

Simply run zoobbe auth login — the CLI opens your browser where you authorize access. The token is sent back automatically via a secure localhost callback.

$ zoobbe auth login
  Opening browser for authentication...
  ✓ Logged in as Akash M

If the browser doesn't open or the callback times out after 2 minutes, the CLI falls back to a manual paste prompt.

Direct Token Login

You can also pass an API key directly. Generate one from Settings > API Keys in your workspace:

zoobbe auth login --token zb_live_your_api_key_here

Self-Hosted Instances

For self-hosted Zoobbe instances, set your API URL first:

zoobbe auth login --url https://api.your-instance.com

Auth Commands

zoobbe auth whoami     # Show current user
zoobbe auth status     # Show auth details
zoobbe auth logout     # Clear credentials
zoobbe auth clear      # Reset apiUrl and webUrl

Commands

Workspaces

zoobbe workspace list              # List your workspaces
zoobbe workspace switch <name>     # Set active workspace
zoobbe workspace create <name>     # Create a new workspace
zoobbe workspace info              # Show active workspace details
zoobbe workspace members           # List workspace members
zoobbe workspace update --name <n> # Rename active workspace
zoobbe workspace delete            # Delete active workspace
zoobbe workspace invite -e <email> # Invite a user by email
zoobbe workspace join-link         # Generate a join link
zoobbe workspace join-link --delete
zoobbe workspace add-member -u <id>
zoobbe workspace remove-member -u <id>
zoobbe workspace member-role -u <id> --role admin

Boards

zoobbe board list                  # List boards in active workspace
zoobbe board list --all            # Include archived boards
zoobbe board create <name>         # Create a new board
zoobbe board create <name> -v Public
zoobbe board info <id>             # Show board details
zoobbe board open <id>             # Open board in browser
zoobbe board update <id> -t <title> -d <desc>
zoobbe board archive <id>          # Archive a board
zoobbe board restore <id>          # Restore an archived board
zoobbe board delete <id>           # Permanently delete a board
zoobbe board members <id>          # List board members
zoobbe board add-member <id> -u <userId> --role admin
zoobbe board remove-member <id> -u <userId>
zoobbe board invite <id> -e <email>
zoobbe board join-link <id>        # Generate join link
zoobbe board labels <id>           # List board labels
zoobbe board label-create <id> --text "Bug" --color red
zoobbe board label-delete <id> --label <labelId>
zoobbe board visibility <id> Public
zoobbe board activities <id>       # Show board activity log

Lists

zoobbe list ls -b <boardId>        # List all lists on a board
zoobbe list create <title> -b <boardId>
zoobbe list update <listId> -t <title> --color "#ff0000"
zoobbe list delete <listId>        # Delete list and all cards
zoobbe list archive <listId>       # Archive a list
zoobbe list archive --unarchive    # Unarchive a list
zoobbe list archive-cards <listId> # Archive all cards in a list
zoobbe list copy <listId>          # Copy list with all cards
zoobbe list watch <listId>         # Toggle watch
zoobbe list archived -b <boardId>  # Show archived lists

Cards

zoobbe card list --board <id>      # List cards on a board
zoobbe card create <title> -b <id> # Create card in first list
zoobbe card create <title> -b <id> -l <listId> --due 2026-04-01 --priority high
zoobbe card info <cardId>          # Show card details
zoobbe card update <cardId> -t <title> -d <desc>
zoobbe card move <cardId> -l <listName>
zoobbe card copy <cardId> -l <listId>
zoobbe card assign <cardId> -u <userId>
zoobbe card unassign <cardId> -u <userId>
zoobbe card members <cardId>       # List card members
zoobbe card comment <cardId> "message"
zoobbe card comments <cardId>      # List comments
zoobbe card label <cardId>         # Add/remove labels (interactive)
zoobbe card done <cardId>          # Mark as complete
zoobbe card undone <cardId>        # Mark as incomplete
zoobbe card archive <cardId>
zoobbe card delete <cardId>        # Permanently delete
zoobbe card due <cardId> 2026-05-01
zoobbe card due <cardId> --remove
zoobbe card priority <cardId> high
zoobbe card watch <cardId>
zoobbe card attachments <cardId>   # List attachments
zoobbe card attach <cardId> ./file.pdf
zoobbe card activities <cardId>    # Show activity log

Checklists

zoobbe checklist list <cardId>                   # List checklists
zoobbe checklist add <cardId> "QA Tasks"         # Add a checklist
zoobbe checklist rename <cardId> <clId> -t "New" # Rename
zoobbe checklist delete <cardId> <clId>          # Delete checklist
zoobbe checklist add-item <cardId> <clId> "Test login flow"
zoobbe checklist check <cardId> <clId> <itemId>  # Toggle complete
zoobbe checklist update-item <cardId> <clId> <itemId> -t "Updated"
zoobbe checklist delete-item <cardId> <clId> <itemId>

Timers

zoobbe timer start <cardId>            # Start stopwatch
zoobbe timer start <cardId> --mode pomodoro
zoobbe timer pause <cardId>
zoobbe timer resume <cardId>
zoobbe timer stop <cardId>             # Stop and save session
zoobbe timer reset <cardId>
zoobbe timer mode <cardId> pomodoro    # Switch mode
zoobbe timer get <cardId>              # Get current state
zoobbe timer sessions <cardId>         # List sessions
zoobbe timer status                    # Overall timer status
zoobbe timer running                   # All running timers
zoobbe timer stats                     # Timer statistics
zoobbe timer delete <cardId>           # Delete timer data

Pages

zoobbe page list                   # List pages
zoobbe page create <title>         # Create a new page
zoobbe page info <pageId>          # Show page details
zoobbe page open <pageId>          # Open page in browser
zoobbe page update <pageId> -t <title> --icon "📝"
zoobbe page delete <pageId>        # Soft delete
zoobbe page delete <pageId> --permanent
zoobbe page archive <pageId>
zoobbe page restore <pageId>
zoobbe page duplicate <pageId>
zoobbe page favorite <pageId>      # Toggle favorite
zoobbe page share <pageId> --public
zoobbe page share <pageId> --revoke
zoobbe page share <pageId> -u <userId> --role editor
zoobbe page members <pageId>
zoobbe page add-member <pageId> -u <userId> --role editor
zoobbe page remove-member <pageId> -u <userId>
zoobbe page comments <pageId>      # List comments
zoobbe page comment <pageId> "Great doc!"

Notifications

zoobbe notification list           # List notifications
zoobbe notification list --unread  # Only unread
zoobbe notification count          # Unread count
zoobbe notification read <id>      # Mark as read
zoobbe notification read-all       # Mark all as read

Activity

zoobbe activity board <boardId>    # Board activity log
zoobbe activity card <cardId>      # Card activity log
zoobbe activity me                 # Your recent activity

Analytics

zoobbe analytics board <boardId>           # Board overview
zoobbe analytics metrics <boardId> --range 30d
zoobbe analytics time <boardId>            # Time analytics
zoobbe analytics timeline <boardId>        # Full timeline
zoobbe analytics productivity <boardId>    # User productivity
zoobbe analytics workflow <boardId>        # Workflow analytics
zoobbe analytics workspace                 # Workspace analytics
zoobbe analytics user                      # Your personal analytics
zoobbe analytics trends                    # Trends
zoobbe analytics export <boardId> -o report.json

Automations

zoobbe automation list -b <boardId>
zoobbe automation create -b <boardId>      # Interactive creation
zoobbe automation update <id> -b <boardId> --name "New name"
zoobbe automation delete <id> -b <boardId>
zoobbe automation toggle <id> -b <boardId> # Enable/disable
zoobbe automation logs <id> -b <boardId>   # Execution logs
zoobbe automation options -b <boardId>     # Available triggers/actions
zoobbe automation info <id> -b <boardId>

Webhooks

zoobbe webhook list                        # List webhooks
zoobbe webhook create --url <url> --events card.created,card.moved --name "My Hook"
zoobbe webhook update <id> --url <newUrl>
zoobbe webhook delete <id>
zoobbe webhook logs <id>                   # Delivery logs

API Keys

zoobbe api-key list                # List your API keys
zoobbe api-key create --name "CI"  # Create a new key
zoobbe api-key delete <id>
zoobbe api-key rename <id> --name "Production"
zoobbe api-key regenerate <id>     # Regenerate key

Note: Some API key operations may require session auth (browser login) rather than API key auth.

Import

zoobbe import trello --key <trelloKey> --token <trelloToken>
zoobbe import status <jobId>       # Check import progress
zoobbe import jobs                 # List all import jobs

Search

zoobbe search "query"              # Search across boards, cards, and pages

Status

zoobbe status                      # Show your cards across all boards

AI (Experimental)

Requires an AI provider key configured on the backend.

zoobbe ask "what cards are due this week?"
zoobbe ask "move all overdue cards to Review"
zoobbe ask "create a sprint board with 3 lists" --provider openai

Configuration

zoobbe config set apiUrl https://api.zoobbe.com   # Set API URL
zoobbe config set format json                      # Default output format
zoobbe config get apiUrl                           # Get a config value
zoobbe config list                                 # Show all config
zoobbe config path                                 # Show config file location

Output Formats

Use the --format flag or set a default:

zoobbe board list --format json    # JSON output
zoobbe board list --format plain   # Plain text
zoobbe board list --format table   # Table (default)

Global Options

-f, --format <format>    Output format: table | json | plain
--workspace <id>         Override active workspace for this command
-V, --version            Show version
-h, --help               Show help

Aliases

Most commands have short aliases:

| Command | Alias | |----------------|--------| | workspace | ws | | board | b | | card | c | | list | l | | checklist | cl | | page | p | | timer | t | | notification | n | | analytics | an | | automation | auto | | webhook | wh | | api-key | ak |

zoobbe b ls              # Same as: zoobbe board list
zoobbe c ls -b <id>      # Same as: zoobbe card list --board <id>
zoobbe cl ls <cardId>    # Same as: zoobbe checklist list <cardId>
zoobbe t start <cardId>  # Same as: zoobbe timer start <cardId>
zoobbe n ls --unread     # Same as: zoobbe notification list --unread

MCP Server (AI Integration)

The CLI includes a built-in MCP server that lets AI agents like Claude interact with your Zoobbe workspace directly.

Setup

# Install the CLI (includes MCP server)
npm install -g @zoobbe/cli

# Make sure you're logged in
zoobbe auth login

# Connect to Claude Code
claude mcp add zoobbe -- zoobbe-mcp

What Claude can do

Once connected, Claude can read and manage your workspace through natural language:

• "What cards are assigned to me?"
• "Show overdue tasks on the Sprint board"
• "Create a high-priority card for the login bug"
• "Move card abc123 to Done"
• "What happened on the board this week?"

Source Attribution

All changes made through the MCP server are automatically tagged in activity logs as (via AI Agent), and CLI commands are tagged as (via CLI). This lets your team distinguish between manual and automated actions when reviewing card or board history.

Available tools (28)

| Category | Tools | |----------|-------| | Boards | list_boards, get_board, list_lists, board_members, board_activities, board_labels, board_analytics | | Cards | list_cards, get_card, card_comments, card_checklists, card_activities | | Actions | create_card, update_card, move_card, assign_card, add_comment, mark_card_done, mark_card_undone, set_due_date, set_priority, archive_card | | General | my_status, search, list_notifications, mark_notifications_read, create_board, create_list |

Zero extra dependencies — the MCP server implements the protocol natively over stdio.

License

MIT