linear-cli-agents 0.4.1 → 0.5.0

package/dist/commands/issues/bulk-label.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+export default class IssuesBulkLabel extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        ids: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'add-labels': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'remove-labels': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/issues/bulk-label.js

@@ -0,0 +1,113 @@
+import { Command, Flags } from '@oclif/core';
+import { getClient } from '../../lib/client.js';
+import { success, print } from '../../lib/output.js';
+import { handleError, CliError, ErrorCodes } from '../../lib/errors.js';
+import { resolveIssueId } from '../../lib/issue-utils.js';
+export default class IssuesBulkLabel extends Command {
+    static description = 'Add or remove labels from multiple issues';
+    static examples = [
+        '<%= config.bin %> issues bulk-label --ids ENG-1,ENG-2,ENG-3 --add-labels LABEL_ID1,LABEL_ID2',
+        '<%= config.bin %> issues bulk-label --ids ENG-1,ENG-2 --remove-labels LABEL_ID1',
+        '<%= config.bin %> issues bulk-label --ids ENG-1,ENG-2,ENG-3 --add-labels LABEL_ID1 --remove-labels LABEL_ID2',
+    ];
+    static flags = {
+        ids: Flags.string({
+            description: 'Comma-separated issue IDs or identifiers (e.g., ENG-1,ENG-2,ENG-3)',
+            required: true,
+        }),
+        'add-labels': Flags.string({
+            description: 'Comma-separated label IDs to add',
+        }),
+        'remove-labels': Flags.string({
+            description: 'Comma-separated label IDs to remove',
+        }),
+    };
+    async run() {
+        try {
+            const { flags } = await this.parse(IssuesBulkLabel);
+            const client = getClient();
+            const addLabelIds = flags['add-labels']?.split(',').map((id) => id.trim()) ?? [];
+            const removeLabelIds = flags['remove-labels']?.split(',').map((id) => id.trim()) ?? [];
+            if (addLabelIds.length === 0 && removeLabelIds.length === 0) {
+                throw new CliError(ErrorCodes.INVALID_INPUT, 'No label operations specified. Use --add-labels and/or --remove-labels');
+            }
+            // Parse issue identifiers
+            const identifiers = flags.ids.split(',').map((id) => id.trim());
+            if (identifiers.length === 0) {
+                throw new CliError(ErrorCodes.INVALID_INPUT, 'No issue IDs provided');
+            }
+            // Process all label operations
+            const results = [];
+            // Process each issue
+            await Promise.all(identifiers.map(async (identifier) => {
+                try {
+                    const issueId = await resolveIssueId(client, identifier);
+                    const issue = await client.issue(issueId);
+                    if (!issue) {
+                        results.push({
+                            identifier,
+                            id: issueId,
+                            success: false,
+                            error: 'Issue not found',
+                        });
+                        return;
+                    }
+                    // Get existing labels
+                    const existingLabels = await issue.labels();
+                    const existingLabelIds = existingLabels.nodes.map((l) => l.id);
+                    // Calculate new label set
+                    const labelsToAdd = addLabelIds.filter((id) => !existingLabelIds.includes(id));
+                    const labelsToRemove = removeLabelIds.filter((id) => existingLabelIds.includes(id));
+                    // Build new label array
+                    const newLabelIds = [
+                        ...existingLabelIds.filter((id) => !removeLabelIds.includes(id)),
+                        ...labelsToAdd,
+                    ];
+                    // Update the issue
+                    const payload = await client.updateIssue(issueId, {
+                        labelIds: newLabelIds,
+                    });
+                    if (!payload.success) {
+                        results.push({
+                            identifier,
+                            id: issueId,
+                            success: false,
+                            error: 'Failed to update labels',
+                        });
+                        return;
+                    }
+                    const updatedIssue = await payload.issue;
+                    results.push({
+                        identifier: updatedIssue?.identifier ?? identifier,
+                        id: issueId,
+                        success: true,
+                        labelsAdded: labelsToAdd.length > 0 ? labelsToAdd : undefined,
+                        labelsRemoved: labelsToRemove.length > 0 ? labelsToRemove : undefined,
+                    });
+                }
+                catch (err) {
+                    results.push({
+                        identifier,
+                        id: '',
+                        success: false,
+                        error: err instanceof Error ? err.message : 'Unknown error',
+                    });
+                }
+            }));
+            const successCount = results.filter((r) => r.success).length;
+            const failedCount = results.filter((r) => !r.success).length;
+            print(success({
+                totalRequested: identifiers.length,
+                successCount,
+                failedCount,
+                labelsToAdd: addLabelIds.length > 0 ? addLabelIds : undefined,
+                labelsToRemove: removeLabelIds.length > 0 ? removeLabelIds : undefined,
+                results,
+            }));
+        }
+        catch (err) {
+            handleError(err);
+            this.exit(1);
+        }
+    }
+}

package/dist/commands/issues/bulk-update.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+export default class IssuesBulkUpdate extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        ids: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'state-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        priority: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'assignee-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        estimate: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'label-ids': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/issues/bulk-update.js

@@ -0,0 +1,131 @@
+import { Command, Flags } from '@oclif/core';
+import { getClient } from '../../lib/client.js';
+import { success, print } from '../../lib/output.js';
+import { handleError, CliError, ErrorCodes } from '../../lib/errors.js';
+import { resolveIssueId } from '../../lib/issue-utils.js';
+export default class IssuesBulkUpdate extends Command {
+    static description = 'Update multiple issues at once';
+    static examples = [
+        '<%= config.bin %> issues bulk-update --ids ENG-1,ENG-2,ENG-3 --state-id STATE_ID',
+        '<%= config.bin %> issues bulk-update --ids ENG-1,ENG-2 --priority 2',
+        '<%= config.bin %> issues bulk-update --ids ENG-1,ENG-2,ENG-3 --assignee-id USER_ID',
+        '<%= config.bin %> issues bulk-update --ids ENG-1,ENG-2 --state-id STATE_ID --priority 1',
+    ];
+    static flags = {
+        ids: Flags.string({
+            description: 'Comma-separated issue IDs or identifiers (e.g., ENG-1,ENG-2,ENG-3)',
+            required: true,
+        }),
+        'state-id': Flags.string({
+            description: 'New state ID for all issues',
+        }),
+        priority: Flags.integer({
+            char: 'p',
+            description: 'New priority (0=none, 1=urgent, 2=high, 3=medium, 4=low)',
+        }),
+        'assignee-id': Flags.string({
+            description: 'New assignee user ID (use empty string to unassign)',
+        }),
+        'project-id': Flags.string({
+            description: 'New project ID',
+        }),
+        estimate: Flags.integer({
+            description: 'New estimate points',
+        }),
+        'label-ids': Flags.string({
+            description: 'Comma-separated label IDs (replaces existing labels)',
+        }),
+    };
+    async run() {
+        try {
+            const { flags } = await this.parse(IssuesBulkUpdate);
+            const client = getClient();
+            // Build the update input from flags
+            const input = {};
+            if (flags['state-id'])
+                input.stateId = flags['state-id'];
+            if (flags.priority !== undefined)
+                input.priority = flags.priority;
+            if (flags['assignee-id'] !== undefined) {
+                input.assigneeId = flags['assignee-id'] || null;
+            }
+            if (flags['project-id'])
+                input.projectId = flags['project-id'];
+            if (flags.estimate !== undefined)
+                input.estimate = flags.estimate;
+            if (flags['label-ids'])
+                input.labelIds = flags['label-ids'].split(',').map((id) => id.trim());
+            if (Object.keys(input).length === 0) {
+                throw new CliError(ErrorCodes.INVALID_INPUT, 'No update fields provided. Use at least one of: --state-id, --priority, --assignee-id, --project-id, --estimate, --label-ids');
+            }
+            // Parse issue identifiers
+            const identifiers = flags.ids.split(',').map((id) => id.trim());
+            if (identifiers.length === 0) {
+                throw new CliError(ErrorCodes.INVALID_INPUT, 'No issue IDs provided');
+            }
+            // Process all updates
+            const results = [];
+            // Resolve all issue IDs first
+            const resolvedIds = await Promise.all(identifiers.map(async (identifier) => {
+                try {
+                    const id = await resolveIssueId(client, identifier);
+                    return { identifier, id, error: null };
+                }
+                catch (err) {
+                    return { identifier, id: null, error: err instanceof Error ? err.message : 'Unknown error' };
+                }
+            }));
+            // Update all resolved issues
+            await Promise.all(resolvedIds.map(async ({ identifier, id, error }) => {
+                if (error || !id) {
+                    results.push({
+                        identifier,
+                        id: id ?? '',
+                        success: false,
+                        error: error ?? 'Failed to resolve issue ID',
+                    });
+                    return;
+                }
+                try {
+                    const payload = await client.updateIssue(id, input);
+                    const issue = await payload.issue;
+                    if (!issue) {
+                        results.push({
+                            identifier,
+                            id,
+                            success: false,
+                            error: 'Failed to update issue',
+                        });
+                        return;
+                    }
+                    results.push({
+                        identifier: issue.identifier,
+                        id: issue.id,
+                        success: true,
+                    });
+                }
+                catch (err) {
+                    results.push({
+                        identifier,
+                        id,
+                        success: false,
+                        error: err instanceof Error ? err.message : 'Unknown error',
+                    });
+                }
+            }));
+            const successCount = results.filter((r) => r.success).length;
+            const failedCount = results.filter((r) => !r.success).length;
+            print(success({
+                totalRequested: identifiers.length,
+                successCount,
+                failedCount,
+                results,
+                updatedFields: Object.keys(input),
+            }));
+        }
+        catch (err) {
+            handleError(err);
+            this.exit(1);
+        }
+    }
+}

package/dist/commands/issues/create.js

@@ -2,6 +2,7 @@ import { Command, Flags } from '@oclif/core';
 import { getClient } from '../../lib/client.js';
 import { success, print } from '../../lib/output.js';
 import { handleError, CliError, ErrorCodes } from '../../lib/errors.js';
+import { getDefaultTeamId } from '../../lib/config.js';
 export default class IssuesCreate extends Command {
     static description = 'Create a new issue';
     static examples = [
@@ -65,12 +66,14 @@ export default class IssuesCreate extends Command {
                 if (!flags.title) {
                     throw new CliError(ErrorCodes.MISSING_REQUIRED_FIELD, 'Title is required. Use --title or --input');
                 }
-                if (!flags['team-id']) {
-                    throw new CliError(ErrorCodes.MISSING_REQUIRED_FIELD, 'Team ID is required. Use --team-id or --input');
+                // Use provided team-id or fall back to default
+                const teamId = flags['team-id'] ?? getDefaultTeamId();
+                if (!teamId) {
+                    throw new CliError(ErrorCodes.MISSING_REQUIRED_FIELD, 'Team ID is required. Use --team-id, --input, or configure default with "linear config set default-team-id TEAM_ID"');
                 }
                 input = {
                     title: flags.title,
-                    teamId: flags['team-id'],
+                    teamId,
                 };
                 if (flags.description)
                     input.description = flags.description;

package/dist/commands/projects/create.d.ts

@@ -7,7 +7,7 @@ export default class ProjectsCreate extends Command {
         name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         state: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'team-ids': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'team-ids': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'lead-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'start-date': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'target-date': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/projects/create.js

@@ -2,6 +2,7 @@ import { Command, Flags } from '@oclif/core';
 import { getClient } from '../../lib/client.js';
 import { success, print, printItem } from '../../lib/output.js';
 import { handleError, CliError, ErrorCodes } from '../../lib/errors.js';
+import { getDefaultTeamId } from '../../lib/config.js';
 export default class ProjectsCreate extends Command {
     static description = 'Create a project';
     static examples = [
@@ -31,8 +32,7 @@ export default class ProjectsCreate extends Command {
             options: ['planned', 'started', 'paused', 'completed', 'canceled'],
         }),
         'team-ids': Flags.string({
-            description: 'Team IDs (comma-separated)',
-            required: true,
+            description: 'Team IDs (comma-separated). Uses default team if not provided.',
         }),
         'lead-id': Flags.string({
             description: 'Lead user ID',
@@ -49,7 +49,18 @@ export default class ProjectsCreate extends Command {
             const { flags } = await this.parse(ProjectsCreate);
             const format = flags.format;
             const client = getClient();
-            const teamIds = flags['team-ids'].split(',').map((id) => id.trim());
+            // Use provided team-ids or fall back to default
+            let teamIds;
+            if (flags['team-ids']) {
+                teamIds = flags['team-ids'].split(',').map((id) => id.trim());
+            }
+            else {
+                const defaultTeamId = getDefaultTeamId();
+                if (!defaultTeamId) {
+                    throw new CliError(ErrorCodes.MISSING_REQUIRED_FIELD, 'Team IDs required. Use --team-ids or configure default with "linear config set default-team-id TEAM_ID"');
+                }
+                teamIds = [defaultTeamId];
+            }
             const payload = await client.createProject({
                 name: flags.name,
                 description: flags.description,

package/dist/commands/setup.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@oclif/core';
+export default class Setup extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        remove: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/setup.js

@@ -0,0 +1,91 @@
+import { Command, Flags } from '@oclif/core';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+import { success, print } from '../lib/output.js';
+import { handleError } from '../lib/errors.js';
+const CLAUDE_MD_PATH = join(homedir(), '.claude', 'CLAUDE.md');
+const LINEAR_CLI_SECTION_START = '<!-- LINEAR-CLI-START -->';
+const LINEAR_CLI_SECTION_END = '<!-- LINEAR-CLI-END -->';
+const LINEAR_CLI_DOCS = `${LINEAR_CLI_SECTION_START}
+## Linear CLI
+
+CLI for Linear. Run \`linear info\` for full documentation.
+
+\`\`\`bash
+linear auth login                          # Authenticate (one-time)
+linear info                                # Get all commands and docs
+linear issues create --title "X" --team-id ID
+linear issues bulk-update --ids A,B,C --state-id ID
+\`\`\`
+${LINEAR_CLI_SECTION_END}`;
+export default class Setup extends Command {
+    static description = 'Add Linear CLI instructions to your CLAUDE.md';
+    static examples = [
+        '<%= config.bin %> setup',
+        '<%= config.bin %> setup --remove',
+    ];
+    static flags = {
+        remove: Flags.boolean({
+            description: 'Remove Linear CLI section from CLAUDE.md',
+            default: false,
+        }),
+    };
+    async run() {
+        try {
+            const { flags } = await this.parse(Setup);
+            const dir = dirname(CLAUDE_MD_PATH);
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+            let content = '';
+            if (existsSync(CLAUDE_MD_PATH)) {
+                content = readFileSync(CLAUDE_MD_PATH, 'utf-8');
+            }
+            const hasSection = content.includes(LINEAR_CLI_SECTION_START);
+            if (flags.remove) {
+                if (!hasSection) {
+                    print(success({
+                        action: 'none',
+                        message: 'Linear CLI section not found in CLAUDE.md',
+                        path: CLAUDE_MD_PATH,
+                    }));
+                    return;
+                }
+                const regex = new RegExp(`\\n?${LINEAR_CLI_SECTION_START}[\\s\\S]*?${LINEAR_CLI_SECTION_END}\\n?`, 'g');
+                content = content.replace(regex, '\n').trim() + '\n';
+                writeFileSync(CLAUDE_MD_PATH, content, 'utf-8');
+                print(success({
+                    action: 'removed',
+                    message: 'Linear CLI section removed from CLAUDE.md',
+                    path: CLAUDE_MD_PATH,
+                }));
+                return;
+            }
+            if (hasSection) {
+                const regex = new RegExp(`${LINEAR_CLI_SECTION_START}[\\s\\S]*?${LINEAR_CLI_SECTION_END}`, 'g');
+                content = content.replace(regex, LINEAR_CLI_DOCS);
+                writeFileSync(CLAUDE_MD_PATH, content, 'utf-8');
+                print(success({
+                    action: 'updated',
+                    message: 'Linear CLI section updated in CLAUDE.md',
+                    path: CLAUDE_MD_PATH,
+                }));
+            }
+            else {
+                const separator = content.length > 0 && !content.endsWith('\n\n') ? '\n\n' : '';
+                content = content + separator + LINEAR_CLI_DOCS + '\n';
+                writeFileSync(CLAUDE_MD_PATH, content, 'utf-8');
+                print(success({
+                    action: 'added',
+                    message: 'Linear CLI section added to CLAUDE.md',
+                    path: CLAUDE_MD_PATH,
+                }));
+            }
+        }
+        catch (err) {
+            handleError(err);
+            this.exit(1);
+        }
+    }
+}

package/dist/lib/config.d.ts

@@ -1,4 +1,4 @@
-import type { ConfigFile } from './types.js';
+import type { ConfigFile, ConfigDefaults } from './types.js';
 /**
  * Read the configuration file.
  * @throws {CliError} When config file exists but cannot be parsed.
@@ -31,3 +31,38 @@ export declare const removeApiKey: () => void;
  * Get the config file path (for display purposes).
  */
 export declare const getConfigPath: () => string;
+/**
+ * Get defaults from config, with migration from legacy defaultTeamId.
+ */
+export declare const getDefaults: () => ConfigDefaults;
+/**
+ * Get the default team ID from config.
+ * Returns undefined if not configured.
+ */
+export declare const getDefaultTeamId: () => string | undefined;
+/**
+ * Get the default team key from config.
+ * Returns undefined if not configured.
+ */
+export declare const getDefaultTeamKey: () => string | undefined;
+/**
+ * Set a default configuration value.
+ */
+export declare const setDefault: (key: keyof ConfigDefaults, value: string | undefined) => void;
+/**
+ * Remove a default configuration value.
+ */
+export declare const removeDefault: (key: keyof ConfigDefaults) => void;
+/**
+ * Valid configuration keys that can be set.
+ */
+export declare const CONFIG_KEYS: readonly ["default-team-id", "default-team-key"];
+export type ConfigKey = (typeof CONFIG_KEYS)[number];
+/**
+ * Map config key to internal defaults key.
+ */
+export declare const configKeyToDefaultsKey: (key: ConfigKey) => keyof ConfigDefaults;
+/**
+ * Check if a key is a valid config key.
+ */
+export declare const isValidConfigKey: (key: string) => key is ConfigKey;

package/dist/lib/config.js

@@ -95,3 +95,79 @@ export const removeApiKey = () => {
  * Get the config file path (for display purposes).
  */
 export const getConfigPath = () => CONFIG_FILE;
+/**
+ * Get defaults from config, with migration from legacy defaultTeamId.
+ */
+export const getDefaults = () => {
+    const config = readConfig();
+    // Migrate legacy defaultTeamId to defaults.teamId
+    if (config.defaultTeamId && !config.defaults?.teamId) {
+        return {
+            teamId: config.defaultTeamId,
+            ...config.defaults,
+        };
+    }
+    return config.defaults ?? {};
+};
+/**
+ * Get the default team ID from config.
+ * Returns undefined if not configured.
+ */
+export const getDefaultTeamId = () => {
+    const defaults = getDefaults();
+    return defaults.teamId;
+};
+/**
+ * Get the default team key from config.
+ * Returns undefined if not configured.
+ */
+export const getDefaultTeamKey = () => {
+    const defaults = getDefaults();
+    return defaults.teamKey;
+};
+/**
+ * Set a default configuration value.
+ */
+export const setDefault = (key, value) => {
+    const config = readConfig();
+    if (!config.defaults) {
+        config.defaults = {};
+    }
+    if (value === undefined) {
+        delete config.defaults[key];
+    }
+    else {
+        config.defaults[key] = value;
+    }
+    // Clean up legacy field if we're setting teamId
+    if (key === 'teamId' && config.defaultTeamId) {
+        delete config.defaultTeamId;
+    }
+    writeConfig(config);
+};
+/**
+ * Remove a default configuration value.
+ */
+export const removeDefault = (key) => {
+    setDefault(key, undefined);
+};
+/**
+ * Valid configuration keys that can be set.
+ */
+export const CONFIG_KEYS = ['default-team-id', 'default-team-key'];
+/**
+ * Map config key to internal defaults key.
+ */
+export const configKeyToDefaultsKey = (key) => {
+    const mapping = {
+        'default-team-id': 'teamId',
+        'default-team-key': 'teamKey',
+    };
+    return mapping[key];
+};
+/**
+ * Check if a key is a valid config key.
+ */
+export const isValidConfigKey = (key) => {
+    return CONFIG_KEYS.includes(key);
+};

package/dist/lib/types.d.ts

@@ -34,7 +34,13 @@ export interface ErrorResponse {
 }
 export type CommandResponse<T> = SuccessResponse<T> | ErrorResponse;
 export type CommandListResponse<T> = SuccessListResponse<T> | ErrorResponse;
+export interface ConfigDefaults {
+    teamId?: string;
+    teamKey?: string;
+}
 export interface ConfigFile {
     apiKey?: string;
+    defaults?: ConfigDefaults;
+    /** @deprecated Use defaults.teamId instead */
     defaultTeamId?: string;
 }