@zoobbe/cli 1.1.1 → 1.2.1

package/README.md

@@ -13,11 +13,10 @@ Requires Node.js 18 or later.
 ## Quick Start
 
 ```bash
-# Authenticate with your API key
-zoobbe auth login --token zb_live_xxxxx
+# Login via browser (recommended)
+zoobbe auth login
 
-# Or point to a self-hosted instance
-zoobbe config set apiUrl https://your-instance.com
+# Or authenticate directly with an API key
 zoobbe auth login --token zb_live_xxxxx
 
 # Set your active workspace
@@ -31,18 +30,41 @@ zoobbe card list --board <board-id>
 
 ## Authentication
 
-Generate an API key from your workspace settings at **Settings > API Keys**, then:
+### 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.
+
+```bash
+$ 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:
 
 ```bash
 zoobbe auth login --token zb_live_your_api_key_here
 ```
 
-Check your login status:
+### Self-Hosted Instances
+
+For self-hosted Zoobbe instances, set your API URL first:
+
+```bash
+zoobbe auth login --url https://api.your-instance.com
+```
+
+### Auth Commands
 
 ```bash
 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
@@ -51,9 +73,18 @@ zoobbe auth logout     # Clear credentials
 
 ```bash
 zoobbe workspace list              # List your workspaces
-zoobbe workspace switch <id>       # Set active workspace
-zoobbe workspace info [id]         # Show workspace details
+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
@@ -62,24 +93,98 @@ zoobbe workspace members           # List workspace members
 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  # Create with visibility
+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
+
+```bash
+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
 
 ```bash
 zoobbe card list --board <id>      # List cards on a board
-zoobbe card create <title> -b <board-id>           # Create card in first list
-zoobbe card create <title> -b <id> -l <list-id>    # Create card in specific list
-zoobbe card create <title> -b <id> --due 2026-04-01 --priority high
-zoobbe card info <card-id>         # Show card details
-zoobbe card move <card-id> -l <list-name>           # Move card to another list
-zoobbe card assign <card-id> -u <user-id>           # Assign a user
-zoobbe card comment <card-id> "your message"        # Add a comment
-zoobbe card done <card-id>         # Mark card as complete
+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
+
+```bash
+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
+
+```bash
+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
@@ -87,8 +192,99 @@ zoobbe card done <card-id>         # Mark card as complete
 ```bash
 zoobbe page list                   # List pages
 zoobbe page create <title>         # Create a new page
-zoobbe page info <page-id>         # Show page details
-zoobbe page open <page-id>         # Open page in browser
+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
+
+```bash
+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
+
+```bash
+zoobbe activity board <boardId>    # Board activity log
+zoobbe activity card <cardId>      # Card activity log
+zoobbe activity me                 # Your recent activity
+```
+
+### Analytics
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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
+
+```bash
+zoobbe import trello --key <trelloKey> --token <trelloToken>
+zoobbe import status <jobId>       # Check import progress
+zoobbe import jobs                 # List all import jobs
 ```
 
 ### Search
@@ -146,25 +342,27 @@ zoobbe board list --format table   # Table (default)
 
 Most commands have short aliases:
 
-| Command     | Alias |
-|-------------|-------|
-| `board`     | `b`   |
-| `card`      | `c`   |
-| `page`      | `p`   |
-| `list`      | `ls`  |
+| 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`   |
 
 ```bash
 zoobbe b ls              # Same as: zoobbe board list
 zoobbe c ls -b <id>      # Same as: zoobbe card list --board <id>
-```
-
-## Self-Hosted
-
-For self-hosted Zoobbe instances, set your API URL before logging in:
-
-```bash
-zoobbe config set apiUrl https://your-instance.com
-zoobbe auth login --token zb_live_xxxxx
+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
 ```
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zoobbe/cli",
-  "version": "1.1.1",
+  "version": "1.2.1",
   "description": "Zoobbe CLI - Manage boards, cards, and projects from the terminal",
   "main": "src/index.js",
   "bin": {

package/src/commands/activity.js

@@ -0,0 +1,102 @@
+const { Command } = require('commander');
+const client = require('../lib/client');
+const { output, error } = require('../lib/output');
+const { withSpinner } = require('../utils/spinner');
+const { formatRelativeTime } = require('../utils/format');
+
+const activity = new Command('activity')
+  .description('Activity log commands');
+
+activity
+  .command('board <boardId>')
+  .description('Show activity log for a board')
+  .option('--limit <n>', 'Number of activities', '20')
+  .option('-f, --format <format>', 'Output format')
+  .action(async (boardId, options) => {
+    try {
+      const data = await withSpinner('Fetching activities...', () =>
+        client.get(`/boards/${boardId}/activities`)
+      );
+
+      const activities = data.activities || data.data || data;
+      const actArr = Array.isArray(activities) ? activities : [];
+      const limited = actArr.slice(0, parseInt(options.limit));
+
+      const rows = limited.map(a => ({
+        action: a.action || a.type || 'unknown',
+        user: a.user?.userName || a.user?.name || 'N/A',
+        target: a.target || a.card?.title || '',
+        time: formatRelativeTime(a.createdAt),
+      }));
+
+      output(rows, {
+        headers: ['Action', 'User', 'Target', 'Time'],
+        format: options.format,
+      });
+    } catch (err) {
+      error(`Failed to fetch activities: ${err.message}`);
+    }
+  });
+
+activity
+  .command('card <cardId>')
+  .description('Show activity log for a card')
+  .option('--limit <n>', 'Number of activities', '20')
+  .option('-f, --format <format>', 'Output format')
+  .action(async (cardId, options) => {
+    try {
+      const data = await withSpinner('Fetching activities...', () =>
+        client.get(`/cards/${cardId}/activities`)
+      );
+
+      const activities = data.activities || data.data || data;
+      const actArr = Array.isArray(activities) ? activities : [];
+      const limited = actArr.slice(0, parseInt(options.limit));
+
+      const rows = limited.map(a => ({
+        action: a.action || a.type || 'unknown',
+        user: a.user?.userName || a.user?.name || 'N/A',
+        detail: (a.detail || a.description || '').substring(0, 60),
+        time: formatRelativeTime(a.createdAt),
+      }));
+
+      output(rows, {
+        headers: ['Action', 'User', 'Detail', 'Time'],
+        format: options.format,
+      });
+    } catch (err) {
+      error(`Failed to fetch activities: ${err.message}`);
+    }
+  });
+
+activity
+  .command('me')
+  .description('Show your recent activity')
+  .option('--limit <n>', 'Number of activities', '20')
+  .option('-f, --format <format>', 'Output format')
+  .action(async (options) => {
+    try {
+      const data = await withSpinner('Fetching activities...', () =>
+        client.get('/users/me/activities')
+      );
+
+      const activities = data.activities || data.data || data;
+      const actArr = Array.isArray(activities) ? activities : [];
+      const limited = actArr.slice(0, parseInt(options.limit));
+
+      const rows = limited.map(a => ({
+        action: a.action || a.type || 'unknown',
+        target: a.target || a.card?.title || a.board?.name || '',
+        time: formatRelativeTime(a.createdAt),
+      }));
+
+      output(rows, {
+        headers: ['Action', 'Target', 'Time'],
+        format: options.format,
+      });
+    } catch (err) {
+      error(`Failed to fetch activities: ${err.message}`);
+    }
+  });
+
+module.exports = activity;