@proletariat/cli 0.3.35 → 0.3.40

package/README.md

@@ -24,7 +24,10 @@
 **prlt** is an agent orchestration platform for AI labor. Spin up workers on demand, coordinate multi-agent development from one CLI. Isolated workspaces, secure containers, persistent state.
 
 ```bash
-npm install -g @proletariat/cli
+brew install chrismcdermut/proletariat/prlt    # macOS (Homebrew)
+# or
+npm install -g @proletariat/cli        # any platform (npm)
+
 prlt init
 prlt ticket create --title "Add OAuth" --category feature
 prlt work spawn   # Interactive: select tickets, environment, action
@@ -48,7 +51,10 @@ Agent spawns in its own branch, writes code, opens PR. You review and merge.
 # Quick Start
 
 ```bash
-npm install -g @proletariat/cli    # Install
+npm install -g @proletariat/cli    # Install (npm)
+# or
+brew install chrismcdermut/proletariat/prlt  # Install (Homebrew, macOS)
+
 prlt init                          # Create HQ, add repos, choose theme
 prlt ticket create --title "Add OAuth" --category feature
 prlt work spawn                    # Interactive: select tickets, environment, action
@@ -117,6 +123,35 @@ Select tickets to spawn, grouped by priority:
 | Starting agents is heavyweight            | **Ephemeral** - Spawn on demand, they work, they PR, they're done                            |
 | Context lost between agent runs           | **Persistent** - Tickets accumulate context, hand off between agents                         |
 
+### Installation
+
+#### Homebrew (macOS)
+
+```bash
+brew install chrismcdermut/proletariat/prlt
+```
+
+Works on both Apple Silicon (arm64) and Intel (x86_64) Macs.
+
+**Upgrade:**
+
+```bash
+brew update
+brew upgrade prlt
+```
+
+**Verify:**
+
+```bash
+prlt --version
+```
+
+#### npm (all platforms)
+
+```bash
+npm install -g @proletariat/cli
+```
+
 ### Data Model
 
 ```

package/dist/commands/agent/auth.d.ts

@@ -1,5 +1,5 @@
-import { Command } from '@oclif/core';
-export default class Auth extends Command {
+import { PromptCommand } from '../../lib/prompt-command.js';
+export default class Auth extends PromptCommand {
     static description: string;
     static examples: string[];
     static flags: {
@@ -7,7 +7,13 @@ export default class Auth extends Command {
         machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         check: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'api-key': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
+    /**
+     * Try to open the workspace database for saving auth preferences.
+     * Returns null if not in an HQ directory (auth still works, just won't save preference).
+     */
+    private tryOpenDb;
     /**
      * Check if the claude-credentials volume exists
      */
@@ -30,5 +36,9 @@ export default class Auth extends Command {
      * Run the interactive login flow in a temporary container
      */
     private runLoginFlow;
+    /**
+     * Handle API key authentication flow
+     */
+    private handleApiKey;
     run(): Promise<void>;
 }

package/dist/commands/agent/auth.js

@@ -1,16 +1,22 @@
-import { Command, Flags } from '@oclif/core';
+import { Flags } from '@oclif/core';
 import { execSync, spawnSync } from 'node:child_process';
+import { PromptCommand } from '../../lib/prompt-command.js';
 import { colors } from '../../lib/colors.js';
 import { machineOutputFlags } from '../../lib/pmo/index.js';
 import { isDockerRunning } from '../../lib/execution/runners.js';
 import { shouldOutputJson, outputSuccessAsJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { findHQRoot } from '../../lib/workspace.js';
+import { getWorkspaceDbPath } from '../../lib/workspace.js';
+import { saveAuthMethod } from '../../lib/execution/config.js';
+import Database from 'better-sqlite3';
 const CLAUDE_CREDENTIALS_VOLUME = 'claude-credentials';
-export default class Auth extends Command {
+export default class Auth extends PromptCommand {
     static description = 'Set up Claude Code authentication for Docker containers (one-time setup)';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --check',
         '<%= config.bin %> <%= command.id %> --force',
+        '<%= config.bin %> <%= command.id %> --api-key',
     ];
     static flags = {
         check: Flags.boolean({
@@ -21,8 +27,30 @@ export default class Auth extends Command {
             description: 'Force re-authentication even if credentials exist',
             default: false,
         }),
+        'api-key': Flags.boolean({
+            description: 'Use ANTHROPIC_API_KEY instead of OAuth (saves preference)',
+            default: false,
+        }),
         ...machineOutputFlags,
     };
+    /**
+     * Try to open the workspace database for saving auth preferences.
+     * Returns null if not in an HQ directory (auth still works, just won't save preference).
+     */
+    tryOpenDb() {
+        try {
+            const hqPath = findHQRoot();
+            if (!hqPath)
+                return null;
+            const dbPath = getWorkspaceDbPath(hqPath);
+            const db = new Database(dbPath);
+            db.pragma('foreign_keys = ON');
+            return db;
+        }
+        catch {
+            return null;
+        }
+    }
     /**
      * Check if the claude-credentials volume exists
      */
@@ -114,12 +142,74 @@ export default class Auth extends Command {
             return false;
         }
     }
+    /**
+     * Handle API key authentication flow
+     */
+    handleApiKey(jsonMode, flags) {
+        const apiKey = process.env.ANTHROPIC_API_KEY;
+        if (!apiKey) {
+            if (jsonMode) {
+                outputErrorAsJson('API_KEY_NOT_SET', 'ANTHROPIC_API_KEY is not set in your environment. Export it and try again.', createMetadata('agent auth', flags));
+            }
+            this.error('ANTHROPIC_API_KEY is not set in your environment.\nExport it with: export ANTHROPIC_API_KEY=sk-ant-...');
+        }
+        // Save preference to config if in an HQ
+        const db = this.tryOpenDb();
+        if (db) {
+            try {
+                saveAuthMethod(db, 'apikey');
+            }
+            finally {
+                db.close();
+            }
+        }
+        if (jsonMode) {
+            outputSuccessAsJson({
+                authenticated: true,
+                method: 'apikey',
+                message: 'ANTHROPIC_API_KEY is set. Auth method saved as default.',
+            }, createMetadata('agent auth', flags));
+            return;
+        }
+        this.log(colors.success('✓ ANTHROPIC_API_KEY is set'));
+        this.log(colors.textSecondary('  Auth method saved as default: apikey'));
+        this.log(colors.textSecondary('  Containers will use your API key for authentication.'));
+        this.log('');
+        this.log(colors.warning('  Note: This uses API credits, not your Max subscription.'));
+        this.log(colors.textSecondary(`  Run "${this.config.bin} agent auth" (without --api-key) to switch to OAuth.`));
+    }
     async run() {
         const { flags } = await this.parse(Auth);
         // Check if JSON output mode is active
         const jsonMode = shouldOutputJson(flags);
-        // Check Docker is running
+        const jsonModeConfig = jsonMode ? { flags, commandName: 'agent auth' } : null;
+        // Handle --api-key shortcut: validate key and save preference
+        if (flags['api-key']) {
+            this.handleApiKey(jsonMode, flags);
+            return;
+        }
+        // Check Docker is running (needed for OAuth flow)
         if (!isDockerRunning()) {
+            // If Docker isn't running, offer API key as alternative
+            const hasApiKey = !!process.env.ANTHROPIC_API_KEY;
+            if (hasApiKey && !flags.check) {
+                this.log(colors.warning('Docker is not running.'));
+                this.log('');
+                const { authChoice } = await this.prompt([{
+                        type: 'list',
+                        name: 'authChoice',
+                        message: 'Docker is required for OAuth. Use API key instead?',
+                        choices: [
+                            { name: 'Use ANTHROPIC_API_KEY instead (API credits)', value: 'apikey', command: `${this.config.bin} agent auth --api-key --json` },
+                            { name: 'Cancel (start Docker first for OAuth)', value: 'cancel' },
+                        ],
+                        default: 'apikey',
+                    }], jsonModeConfig);
+                if (authChoice === 'apikey') {
+                    this.handleApiKey(jsonMode, flags);
+                    return;
+                }
+            }
             if (jsonMode) {
                 outputErrorAsJson('DOCKER_NOT_RUNNING', 'Docker is not running. Please start Docker Desktop and try again.', createMetadata('agent auth', flags));
             }
@@ -141,6 +231,7 @@ export default class Auth extends Command {
                 if (jsonMode) {
                     outputSuccessAsJson({
                         authenticated: true,
+                        method: 'oauth',
                         subscriptionType: info?.subscriptionType || 'unknown',
                         expiresAt: info?.expiresAt.toISOString(),
                     }, createMetadata('agent auth', flags));
@@ -166,6 +257,7 @@ export default class Auth extends Command {
             if (jsonMode) {
                 outputSuccessAsJson({
                     authenticated: true,
+                    method: 'oauth',
                     subscriptionType: info?.subscriptionType || 'unknown',
                     expiresAt: info?.expiresAt.toISOString(),
                     message: 'Credentials already configured. Use --force to re-authenticate.',
@@ -181,17 +273,49 @@ export default class Auth extends Command {
             this.log(colors.text('Use --force to re-authenticate.'));
             return;
         }
+        // Prompt for auth method choice (OAuth or API key)
+        const hasApiKey = !!process.env.ANTHROPIC_API_KEY;
+        // Only prompt if there's a real choice (API key is available)
+        let selectedMethod = 'oauth';
+        if (hasApiKey) {
+            const { selectedMethod: chosen } = await this.prompt([{
+                    type: 'list',
+                    name: 'selectedMethod',
+                    message: 'Which authentication method would you like to use?',
+                    choices: [
+                        { name: 'OAuth (recommended — uses Max subscription)', value: 'oauth', command: `${this.config.bin} agent auth --force --json` },
+                        { name: 'API key (uses API credits, not Max subscription)', value: 'apikey', command: `${this.config.bin} agent auth --api-key --json` },
+                    ],
+                    default: 'oauth',
+                }], jsonModeConfig);
+            selectedMethod = chosen;
+        }
+        if (selectedMethod === 'apikey') {
+            this.handleApiKey(jsonMode, flags);
+            return;
+        }
         // JSON mode cannot handle interactive login flow
         if (jsonMode) {
             outputErrorAsJson('INTERACTIVE_REQUIRED', 'Authentication requires interactive login. Run without --json flag to authenticate.', createMetadata('agent auth', flags));
         }
-        // Run the login flow
+        // Run the OAuth login flow
         const success = this.runLoginFlow();
         if (success && this.credentialsExist()) {
+            // Save OAuth as auth method preference
+            const db = this.tryOpenDb();
+            if (db) {
+                try {
+                    saveAuthMethod(db, 'oauth');
+                }
+                finally {
+                    db.close();
+                }
+            }
             this.log('');
             this.log(colors.success('✓ Authentication successful!'));
             this.log(colors.textSecondary('  Credentials saved to Docker volume: ' + CLAUDE_CREDENTIALS_VOLUME));
             this.log(colors.textSecondary('  All agent containers will share these credentials.'));
+            this.log(colors.textSecondary('  Auth method saved as default: oauth'));
         }
         else {
             this.log('');

package/dist/commands/agent/list.js

@@ -35,8 +35,8 @@ export default class List extends PMOCommand {
             const activeAgents = workspaceInfo.agents.filter(a => a.status === 'active');
             // Determine type filter - prompt if not provided (but not in JSON mode)
             let typeFilter = flags.type;
-            // In JSON mode without type filter, output all agents grouped by type
-            if (jsonMode && !typeFilter) {
+            // In JSON mode, output agents as JSON respecting the type filter
+            if (jsonMode) {
                 const staffAgents = activeAgents.filter(a => a.type === 'persistent');
                 const tempAgents = activeAgents.filter(a => a.type === 'ephemeral');
                 const agentsStatus = getAllAgentsStatus(workspaceInfo);
@@ -56,11 +56,20 @@ export default class List extends PMOCommand {
                         };
                     });
                 };
-                const output = {
-                    staff: formatAgentJson(staffAgents),
-                    temp: formatAgentJson(tempAgents),
-                    all: formatAgentJson(activeAgents),
-                };
+                let output;
+                if (typeFilter === 'staff') {
+                    output = { staff: formatAgentJson(staffAgents) };
+                }
+                else if (typeFilter === 'temp') {
+                    output = { temp: formatAgentJson(tempAgents) };
+                }
+                else {
+                    // No filter or 'all' - return both groups without redundant combined array
+                    output = {
+                        staff: formatAgentJson(staffAgents),
+                        temp: formatAgentJson(tempAgents),
+                    };
+                }
                 this.log(JSON.stringify(output, null, 2));
                 return;
             }

package/dist/commands/agent/status.js

@@ -1,8 +1,8 @@
 import { Args } from '@oclif/core';
 import { colors, format } from '../../lib/colors.js';
-import { getWorkspaceInfo, getAgentStatus, formatAgentList } from '../../lib/agents/commands.js';
+import { getWorkspaceInfo, getAgentStatus, getAllAgentsStatus, formatAgentList } from '../../lib/agents/commands.js';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
-import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { shouldOutputJson, outputErrorAsJson, outputSuccessAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class Status extends PMOCommand {
     static description = 'Show detailed status for a specific agent';
     static examples = [
@@ -36,6 +36,13 @@ export default class Status extends PMOCommand {
             return;
         }
         let agentName = args.name;
+        // In JSON mode with no agent specified, return all agent statuses
+        if (jsonMode && !agentName) {
+            const allStatuses = getAllAgentsStatus(workspaceInfo);
+            outputSuccessAsJson({
+                agents: allStatuses,
+            }, createMetadata('agent status', flags));
+        }
         // Agent mode config for prompts
         const agentConfig = jsonMode ? { flags, commandName: 'agent status' } : null;
         // Interactive mode if no agent specified
@@ -59,15 +66,36 @@ export default class Status extends PMOCommand {
                 }], agentConfig);
             agentName = selected;
         }
-        await this.showDetailedStatus(workspaceInfo, agentName);
+        await this.showDetailedStatus(workspaceInfo, agentName, jsonMode);
     }
-    async showDetailedStatus(workspaceInfo, agentName) {
+    async showDetailedStatus(workspaceInfo, agentName, jsonMode = false) {
         // Validate agent exists
         const agent = workspaceInfo.agents.find((a) => a.name === agentName);
         if (!agent) {
             this.error(`Agent "${agentName}" not found. Available: ${formatAgentList(workspaceInfo.agents)}`);
         }
         const agentStatus = getAgentStatus(workspaceInfo, agentName);
+        // JSON output mode
+        if (jsonMode) {
+            this.log(JSON.stringify({
+                success: true,
+                agent: {
+                    name: agentName,
+                    type: agent.type,
+                    exists: agentStatus.exists,
+                    path: `${workspaceInfo.agentsPath}/${agentName}`,
+                    branch: agentStatus.branch,
+                    repositories: agentStatus.repositories.map(r => ({
+                        name: r.name,
+                        status: r.status,
+                        commitsAhead: r.commitsAhead,
+                    })),
+                    assignedTickets: agentStatus.assignedTickets,
+                    completedTickets: agentStatus.completedTickets,
+                },
+            }, null, 2));
+            return;
+        }
         this.log(format.title(`🤖 Agent: ${agentName}`));
         // Basic status
         const statusIcon = agentStatus.exists ? '🟢' : '🔴';

package/dist/commands/board/watch.js

@@ -3,6 +3,7 @@ import * as fs from 'node:fs';
 import * as path from 'node:path';
 import chalk from 'chalk';
 import { PMOCommand, pmoBaseFlags, runWatcherForeground } from '../../lib/pmo/index.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
 import { styles } from '../../lib/styles.js';
 export default class BoardWatch extends PMOCommand {
     static description = 'Watch board.md for changes and auto-sync to SQLite';
@@ -23,6 +24,11 @@ export default class BoardWatch extends PMOCommand {
     }
     async execute() {
         const { flags } = await this.parse(BoardWatch);
+        if (shouldOutputJson(flags)) {
+            this.log(JSON.stringify({ type: 'error', error: { code: 'REQUIRES_TTY', message: 'board watch is a long-running interactive command. Use "prlt board" for non-interactive board data.' } }));
+            this.exit(1);
+            return;
+        }
         // Load PMO config
         const configPath = path.join(this.pmoPath, 'config.json');
         if (!fs.existsSync(configPath)) {

package/dist/commands/branch/list.d.ts

@@ -14,6 +14,7 @@ export default class BranchList extends PMOCommand {
         promptIfMultiple: boolean;
     };
     execute(): Promise<void>;
+    private listBranchesAcrossRepos;
     private outputTable;
     private outputCompact;
 }

package/dist/commands/branch/list.js

@@ -2,6 +2,7 @@ import { Flags } from '@oclif/core';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
 import { BRANCH_TYPES, listBranches, isGitRepo, } from '../../lib/branch/index.js';
+import { getWorkspaceRepoInfo } from '../../lib/repos/index.js';
 import { isNonTTY } from '../../lib/prompt-json.js';
 import { visualPadEnd } from '../../lib/string-utils.js';
 export default class BranchList extends PMOCommand {
@@ -40,12 +41,15 @@ export default class BranchList extends PMOCommand {
         if (flags.format === 'table' && isNonTTY()) {
             flags.format = 'json';
         }
-        // Check if in git repo
-        if (!isGitRepo()) {
-            this.error('Not in a git repository.');
+        let branches;
+        if (isGitRepo()) {
+            // In a git repo - list branches for current repo
+            branches = listBranches(undefined, flags.all);
+        }
+        else {
+            // Not in a git repo - list branches across all registered HQ repos
+            branches = this.listBranchesAcrossRepos(flags.all);
         }
-        // Get branches
-        let branches = listBranches(undefined, flags.all);
         // Filter by type
         if (flags.type) {
             branches = branches.filter((b) => b.type === flags.type);
@@ -59,31 +63,55 @@ export default class BranchList extends PMOCommand {
             }
             return;
         }
+        // Check if we have multi-repo results
+        const hasRepoInfo = branches.some((b) => b.repo);
         // Output based on format
         switch (flags.format) {
             case 'json':
                 this.log(JSON.stringify(branches, null, 2));
                 break;
             case 'compact':
-                this.outputCompact(branches);
+                this.outputCompact(branches, hasRepoInfo);
                 break;
             case 'table':
             default:
-                this.outputTable(branches);
+                this.outputTable(branches, hasRepoInfo);
                 break;
         }
     }
-    outputTable(branches) {
+    listBranchesAcrossRepos(includeRemote) {
+        let repoInfo;
+        try {
+            repoInfo = getWorkspaceRepoInfo();
+        }
+        catch {
+            this.error('Not in a git repository and no HQ workspace found.');
+        }
+        const allBranches = [];
+        for (const repo of repoInfo.repositories) {
+            if (repo.status === 'missing')
+                continue;
+            const repoBranches = listBranches(repo.fullPath, includeRemote);
+            for (const branch of repoBranches) {
+                branch.repo = repo.name;
+                allBranches.push(branch);
+            }
+        }
+        return allBranches;
+    }
+    outputTable(branches, hasRepoInfo = false) {
         this.log('');
         this.log(styles.header(`🌿 Branches (${branches.length})`));
         this.log('');
         // Header
-        this.log(styles.muted(visualPadEnd('Name', 35) +
+        const repoHeader = hasRepoInfo ? visualPadEnd('Repo', 18) : '';
+        this.log(styles.muted(repoHeader +
+            visualPadEnd('Name', 35) +
             visualPadEnd('Type', 8) +
             visualPadEnd('Owner', 12) +
             visualPadEnd('Description', 25) +
             'Status'));
-        this.log('─'.repeat(90));
+        this.log('─'.repeat(hasRepoInfo ? 108 : 90));
         // Rows
         for (const branch of branches) {
             const marker = branch.current ? '* ' : '  ';
@@ -91,6 +119,7 @@ export default class BranchList extends PMOCommand {
             const typeDisplay = branch.type || '-';
             const ownerDisplay = branch.owner || '-';
             const descDisplay = branch.description || '-';
+            const repoCol = hasRepoInfo ? visualPadEnd((branch.repo || '-').substring(0, 16), 18) : '';
             let status = 'local';
             if (branch.tracking) {
                 status = `tracking ${branch.tracking}`;
@@ -99,6 +128,7 @@ export default class BranchList extends PMOCommand {
                 status = 'current';
             }
             this.log(marker +
+                repoCol +
                 nameStyle(visualPadEnd(branch.name.substring(0, 33), 33)) +
                 visualPadEnd(typeDisplay, 8) +
                 visualPadEnd(ownerDisplay.substring(0, 10), 12) +
@@ -109,14 +139,15 @@ export default class BranchList extends PMOCommand {
         this.log(styles.muted('Legend: * = current branch'));
         this.log('');
     }
-    outputCompact(branches) {
+    outputCompact(branches, hasRepoInfo = false) {
         this.log('');
         for (const branch of branches) {
             const marker = branch.current ? '* ' : '  ';
             const icon = branch.type ? '🌿' : '  ';
             const typeInfo = branch.type ? ` (${branch.type})` : '';
+            const repoPrefix = hasRepoInfo && branch.repo ? `[${branch.repo}] ` : '';
             const nameStyle = branch.current ? styles.success : (s) => s;
-            this.log(`${icon} ${marker}${nameStyle(branch.name)}${styles.muted(typeInfo)}`);
+            this.log(`${icon} ${marker}${repoPrefix}${nameStyle(branch.name)}${styles.muted(typeInfo)}`);
         }
         this.log('');
     }

package/dist/commands/branch/where.js

@@ -2,9 +2,10 @@ import { Args } from '@oclif/core';
 import { execSync } from 'node:child_process';
 import * as path from 'node:path';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
 import { styles } from '../../lib/styles.js';
 import { isGitRepo, isTicketId } from '../../lib/branch/index.js';
-import { openWorkspaceDatabase } from '../../lib/database/index.js';
+import { findWorktreesByBranch as findDbWorktreesByBranch } from '../../lib/database/index.js';
 export default class BranchWhere extends PMOCommand {
     static description = 'Find which directory a branch is checked out in';
     static examples = [
@@ -40,7 +41,7 @@ export default class BranchWhere extends PMOCommand {
         // Combine results, preferring git worktree info
         const allMatches = this.mergeResults(matches, dbMatches);
         if (allMatches.length === 0) {
-            if (flags.json || flags.machine) {
+            if (shouldOutputJson(flags)) {
                 this.log(JSON.stringify({ found: false, search, matches: [] }, null, 2));
             }
             else {
@@ -48,7 +49,7 @@ export default class BranchWhere extends PMOCommand {
             }
             return;
         }
-        if (flags.json || flags.machine) {
+        if (shouldOutputJson(flags)) {
             this.log(JSON.stringify({
                 found: true,
                 search,
@@ -147,24 +148,13 @@ export default class BranchWhere extends PMOCommand {
             const workspacePath = this.getWorkspacePath();
             if (!workspacePath)
                 return [];
-            const db = openWorkspaceDatabase(workspacePath);
             const searchLower = search.toLowerCase();
             const isTicket = isTicketId(search);
-            // Query for matching branches
-            let query;
-            let params;
-            if (isTicket) {
-                // Match branches starting with ticket ID
-                query = 'SELECT * FROM agent_worktrees WHERE LOWER(branch) LIKE ?';
-                params = [`${searchLower}/%`];
-            }
-            else {
-                // Match branches containing the search term
-                query = 'SELECT * FROM agent_worktrees WHERE LOWER(branch) LIKE ?';
-                params = [`%${searchLower}%`];
-            }
-            const rows = db.prepare(query).all(...params);
-            db.close();
+            // Build LIKE pattern based on search type
+            const branchPattern = isTicket
+                ? `${searchLower}/%` // Match branches starting with ticket ID
+                : `%${searchLower}%`; // Match branches containing the search term
+            const rows = findDbWorktreesByBranch(workspacePath, branchPattern);
             return rows.map(row => ({
                 path: path.join(workspacePath, row.worktree_path),
                 branch: row.branch,

package/dist/commands/category/list.d.ts

@@ -3,7 +3,7 @@ export default class CategoryList extends PMOCommand {
     static description: string;
     static examples: string[];
     static flags: {
-        type: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        type: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         builtin: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         custom: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
@@ -14,5 +14,6 @@ export default class CategoryList extends PMOCommand {
         promptIfMultiple: boolean;
     };
     execute(): Promise<void>;
+    private printCategoryGroup;
     private printCategory;
 }