linear-cli-agents 0.5.1 → 0.7.0

package/dist/commands/documents/get.js

@@ -0,0 +1,79 @@
+import { Args, 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';
+export default class DocumentsGet extends Command {
+    static description = 'Get document details';
+    static examples = [
+        '<%= config.bin %> documents get DOCUMENT_ID',
+        '<%= config.bin %> documents get DOCUMENT_ID --format table',
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Document ID',
+            required: true,
+        }),
+    };
+    static flags = {
+        format: Flags.string({
+            char: 'F',
+            description: 'Output format',
+            options: ['json', 'table', 'plain'],
+            default: 'json',
+        }),
+    };
+    async run() {
+        try {
+            const { args, flags } = await this.parse(DocumentsGet);
+            const format = flags.format;
+            const client = getClient();
+            const document = await client.document(args.id);
+            if (!document) {
+                throw new CliError(ErrorCodes.NOT_FOUND, `Document ${args.id} not found`);
+            }
+            const [project, creator] = await Promise.all([document.project, document.creator]);
+            const data = {
+                id: document.id,
+                title: document.title,
+                content: document.content,
+                icon: document.icon ?? null,
+                color: document.color ?? null,
+                project: project
+                    ? {
+                        id: project.id,
+                        name: project.name,
+                    }
+                    : null,
+                creator: creator
+                    ? {
+                        id: creator.id,
+                        name: creator.name,
+                    }
+                    : null,
+                createdAt: document.createdAt,
+                updatedAt: document.updatedAt,
+            };
+            if (format === 'json') {
+                print(success(data));
+            }
+            else if (format === 'table') {
+                printItem({
+                    id: data.id,
+                    title: data.title,
+                    project: data.project?.name ?? 'None',
+                    creator: data.creator?.name ?? 'Unknown',
+                    content: data.content ? `${data.content.slice(0, 100)}...` : 'Empty',
+                    createdAt: data.createdAt,
+                    updatedAt: data.updatedAt,
+                }, format);
+            }
+            else {
+                console.log(data.id);
+            }
+        }
+        catch (err) {
+            handleError(err);
+            this.exit(1);
+        }
+    }
+}

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

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class DocumentsList extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        first: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        after: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/documents/list.js

@@ -0,0 +1,105 @@
+import { Command, Flags } from '@oclif/core';
+import { getClient } from '../../lib/client.js';
+import { successList, print, printList } from '../../lib/output.js';
+import { handleError } from '../../lib/errors.js';
+import { colors, truncate } from '../../lib/formatter.js';
+const COLUMNS = [
+    {
+        key: 'title',
+        header: 'TITLE',
+        format: (value) => colors.bold(truncate(String(value), 40)),
+    },
+    {
+        key: 'projectName',
+        header: 'PROJECT',
+        format: (value) => (value ? colors.cyan(truncate(String(value), 20)) : colors.gray('None')),
+    },
+    {
+        key: 'creatorName',
+        header: 'CREATOR',
+        format: (value) => (value ? colors.dim(String(value)) : colors.gray('Unknown')),
+    },
+    {
+        key: 'updatedAt',
+        header: 'UPDATED',
+        format: (value) => colors.dim(new Date(value).toISOString().split('T')[0]),
+    },
+];
+export default class DocumentsList extends Command {
+    static description = 'List documents';
+    static examples = [
+        '<%= config.bin %> documents list',
+        '<%= config.bin %> documents list --project-id PROJECT_ID',
+        '<%= config.bin %> documents list --format table',
+    ];
+    static flags = {
+        format: Flags.string({
+            char: 'F',
+            description: 'Output format',
+            options: ['json', 'table', 'plain'],
+            default: 'json',
+        }),
+        'project-id': Flags.string({
+            description: 'Filter by project ID',
+        }),
+        first: Flags.integer({
+            description: 'Number of documents to fetch (default: 50)',
+            default: 50,
+        }),
+        after: Flags.string({
+            description: 'Cursor for pagination',
+        }),
+    };
+    async run() {
+        try {
+            const { flags } = await this.parse(DocumentsList);
+            const format = flags.format;
+            const client = getClient();
+            const filter = {};
+            if (flags['project-id']) {
+                filter.project = { id: { eq: flags['project-id'] } };
+            }
+            const documents = await client.documents({
+                first: flags.first,
+                after: flags.after,
+                filter: Object.keys(filter).length > 0 ? filter : undefined,
+            });
+            const data = await Promise.all(documents.nodes.map(async (doc) => {
+                const [project, creator] = await Promise.all([doc.project, doc.creator]);
+                return {
+                    id: doc.id,
+                    title: doc.title,
+                    icon: doc.icon ?? null,
+                    color: doc.color ?? null,
+                    projectId: project?.id ?? null,
+                    projectName: project?.name ?? null,
+                    creatorId: creator?.id ?? null,
+                    creatorName: creator?.name ?? null,
+                    createdAt: doc.createdAt,
+                    updatedAt: doc.updatedAt,
+                };
+            }));
+            const pageInfo = {
+                hasNextPage: documents.pageInfo.hasNextPage,
+                hasPreviousPage: documents.pageInfo.hasPreviousPage,
+                startCursor: documents.pageInfo.startCursor,
+                endCursor: documents.pageInfo.endCursor,
+            };
+            if (format === 'json') {
+                print(successList(data, pageInfo));
+            }
+            else {
+                printList(data, format, {
+                    columns: COLUMNS,
+                    primaryKey: 'title',
+                    secondaryKey: 'id',
+                    pageInfo,
+                });
+            }
+        }
+        catch (err) {
+            handleError(err);
+            this.exit(1);
+        }
+    }
+}

package/dist/commands/documents/update.d.ts

@@ -0,0 +1,16 @@
+import { Command } from '@oclif/core';
+export default class DocumentsUpdate extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        title: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        content: 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>;
+        icon: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        color: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/documents/update.js

@@ -0,0 +1,75 @@
+import { Args, 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';
+export default class DocumentsUpdate extends Command {
+    static description = 'Update a document';
+    static examples = [
+        '<%= config.bin %> documents update DOCUMENT_ID --title "New Title"',
+        '<%= config.bin %> documents update DOCUMENT_ID --content "Updated content"',
+        '<%= config.bin %> documents update DOCUMENT_ID --project-id PROJECT_ID',
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Document ID',
+            required: true,
+        }),
+    };
+    static flags = {
+        title: Flags.string({
+            char: 't',
+            description: 'New document title',
+        }),
+        content: Flags.string({
+            char: 'c',
+            description: 'New document content (markdown)',
+        }),
+        'project-id': Flags.string({
+            description: 'New project ID (empty string to remove)',
+        }),
+        icon: Flags.string({
+            description: 'New document icon (emoji)',
+        }),
+        color: Flags.string({
+            description: 'New document color (hex)',
+        }),
+    };
+    async run() {
+        try {
+            const { args, flags } = await this.parse(DocumentsUpdate);
+            const client = getClient();
+            const input = {};
+            if (flags.title)
+                input.title = flags.title;
+            if (flags.content)
+                input.content = flags.content;
+            if (flags['project-id'] !== undefined) {
+                input.projectId = flags['project-id'] || null;
+            }
+            if (flags.icon)
+                input.icon = flags.icon;
+            if (flags.color)
+                input.color = flags.color;
+            if (Object.keys(input).length === 0) {
+                throw new CliError(ErrorCodes.INVALID_INPUT, 'No update fields provided');
+            }
+            const payload = await client.updateDocument(args.id, input);
+            if (!payload.success) {
+                throw new CliError(ErrorCodes.API_ERROR, 'Failed to update document');
+            }
+            const document = await payload.document;
+            if (!document) {
+                throw new CliError(ErrorCodes.API_ERROR, 'Document not returned');
+            }
+            print(success({
+                id: document.id,
+                title: document.title,
+                updatedAt: document.updatedAt,
+            }));
+        }
+        catch (err) {
+            handleError(err);
+            this.exit(1);
+        }
+    }
+}

package/dist/commands/info.js

@@ -43,8 +43,9 @@ const COMMANDS = {
         args: { id: { description: 'Issue ID or identifier (e.g., ENG-123)', required: true } },
         flags: {
             format: { type: 'string', options: ['json', 'table', 'plain'], default: 'json' },
+            'with-attachments': { type: 'boolean', description: 'Include attachments (linked PRs, commits, etc.)' },
         },
-        examples: ['linear issues get ENG-123', 'linear issues get abc123-uuid'],
+        examples: ['linear issues get ENG-123', 'linear issues get ENG-123 --with-attachments'],
     },
     'issues create': {
         description: 'Create a new issue',
@@ -405,6 +406,122 @@ const COMMANDS = {
         },
         examples: ['linear templates update TEMPLATE_ID --name "New Name"'],
     },
+    // Documents
+    'documents list': {
+        description: 'List documents',
+        flags: {
+            format: { type: 'string', options: ['json', 'table', 'plain'], default: 'json' },
+            first: { type: 'number', description: 'Number of results' },
+        },
+        examples: ['linear documents list'],
+    },
+    'documents get': {
+        description: 'Get document details',
+        args: { id: { description: 'Document ID', required: true } },
+        flags: { format: { type: 'string', options: ['json', 'table', 'plain'], default: 'json' } },
+        examples: ['linear documents get DOCUMENT_ID'],
+    },
+    'documents create': {
+        description: 'Create a new document',
+        flags: {
+            title: { type: 'string', char: 't', description: 'Document title', required: true },
+            content: { type: 'string', char: 'c', description: 'Document content (markdown)' },
+            'project-id': { type: 'string', description: 'Project ID to associate with' },
+            icon: { type: 'string', description: 'Document icon (emoji)' },
+            color: { type: 'string', description: 'Document color (hex)' },
+        },
+        examples: [
+            'linear documents create --title "My Document"',
+            'linear documents create --title "Notes" --content "# Heading\\n\\nContent"',
+        ],
+    },
+    'documents update': {
+        description: 'Update a document',
+        args: { id: { description: 'Document ID', required: true } },
+        flags: {
+            title: { type: 'string', char: 't', description: 'New title' },
+            content: { type: 'string', char: 'c', description: 'New content (markdown)' },
+            'project-id': { type: 'string', description: 'New project ID (empty to remove)' },
+            icon: { type: 'string', description: 'New icon (emoji)' },
+            color: { type: 'string', description: 'New color (hex)' },
+        },
+        examples: ['linear documents update DOCUMENT_ID --title "New Title"'],
+    },
+    'documents delete': {
+        description: 'Delete a document (moves to trash)',
+        args: { id: { description: 'Document ID', required: true } },
+        flags: {},
+        examples: ['linear documents delete DOCUMENT_ID'],
+    },
+    // Initiatives
+    'initiatives list': {
+        description: 'List initiatives',
+        flags: {
+            format: { type: 'string', options: ['json', 'table', 'plain'], default: 'json' },
+            status: { type: 'string', options: ['Planned', 'Active', 'Completed'], description: 'Filter by status' },
+            first: { type: 'number', description: 'Number of results' },
+        },
+        examples: [
+            'linear initiatives list',
+            'linear initiatives list --status Active',
+        ],
+    },
+    'initiatives get': {
+        description: 'Get initiative details',
+        args: { id: { description: 'Initiative ID', required: true } },
+        flags: { format: { type: 'string', options: ['json', 'table', 'plain'], default: 'json' } },
+        examples: ['linear initiatives get INITIATIVE_ID'],
+    },
+    'initiatives create': {
+        description: 'Create a new initiative',
+        flags: {
+            name: { type: 'string', char: 'n', description: 'Initiative name', required: true },
+            description: { type: 'string', char: 'd', description: 'Initiative description' },
+            status: { type: 'string', options: ['Planned', 'Active', 'Completed'], description: 'Initial status' },
+            'target-date': { type: 'string', description: 'Target completion date (YYYY-MM-DD)' },
+            'owner-id': { type: 'string', description: 'Owner user ID' },
+            icon: { type: 'string', description: 'Initiative icon (emoji)' },
+            color: { type: 'string', description: 'Initiative color (hex)' },
+        },
+        examples: [
+            'linear initiatives create --name "Q1 Goals"',
+            'linear initiatives create --name "Launch" --status Active --target-date 2024-12-31',
+        ],
+    },
+    'initiatives update': {
+        description: 'Update an initiative',
+        args: { id: { description: 'Initiative ID', required: true } },
+        flags: {
+            name: { type: 'string', char: 'n', description: 'New name' },
+            description: { type: 'string', char: 'd', description: 'New description' },
+            status: { type: 'string', options: ['Planned', 'Active', 'Completed'], description: 'New status' },
+            'target-date': { type: 'string', description: 'New target date (YYYY-MM-DD)' },
+            'owner-id': { type: 'string', description: 'New owner user ID' },
+            icon: { type: 'string', description: 'New icon (emoji)' },
+            color: { type: 'string', description: 'New color (hex)' },
+        },
+        examples: [
+            'linear initiatives update INITIATIVE_ID --status Completed',
+            'linear initiatives update INITIATIVE_ID --name "New Name"',
+        ],
+    },
+    'initiatives delete': {
+        description: 'Delete an initiative (moves to trash)',
+        args: { id: { description: 'Initiative ID', required: true } },
+        flags: {},
+        examples: ['linear initiatives delete INITIATIVE_ID'],
+    },
+    'initiatives archive': {
+        description: 'Archive or unarchive an initiative',
+        args: { id: { description: 'Initiative ID', required: true } },
+        flags: {
+            unarchive: { type: 'boolean', char: 'u', description: 'Unarchive instead of archive' },
+        },
+        examples: [
+            'linear initiatives archive INITIATIVE_ID',
+            'linear initiatives archive INITIATIVE_ID --unarchive',
+        ],
+    },
     // Config
     'config set': {
         description: 'Set a configuration value',
@@ -435,6 +552,40 @@ const COMMANDS = {
         flags: { format: { type: 'string', options: ['json', 'table', 'plain'], default: 'json' } },
         examples: ['linear me'],
     },
+    // Cycles
+    'cycles list': {
+        description: 'List cycles (sprints)',
+        flags: {
+            format: { type: 'string', options: ['json', 'table', 'plain'], default: 'json' },
+            'team-id': { type: 'string', description: 'Filter by team ID' },
+            team: { type: 'string', description: 'Filter by team key (e.g., ENG)' },
+            active: { type: 'boolean', description: 'Show only active cycles' },
+            upcoming: { type: 'boolean', description: 'Show only upcoming cycles' },
+            completed: { type: 'boolean', description: 'Show only completed cycles' },
+            first: { type: 'number', description: 'Number of results' },
+        },
+        examples: [
+            'linear cycles list',
+            'linear cycles list --team ENG',
+            'linear cycles list --active',
+        ],
+    },
+    'cycles get': {
+        description: 'Get cycle (sprint) details',
+        args: { id: { description: 'Cycle ID', required: true } },
+        flags: { format: { type: 'string', options: ['json', 'table', 'plain'], default: 'json' } },
+        examples: ['linear cycles get CYCLE_ID'],
+    },
+    'cycles current': {
+        description: 'Get the current active cycle for a team',
+        flags: {
+            format: { type: 'string', options: ['json', 'table', 'plain'], default: 'json' },
+            'team-id': { type: 'string', description: 'Team ID' },
+            team: { type: 'string', description: 'Team key (e.g., ENG)' },
+        },
+        examples: ['linear cycles current --team ENG'],
+    },
+    // Other
     search: {
         description: 'Search for issues',
         args: { query: { description: 'Search query', required: true } },
@@ -467,6 +618,19 @@ const COMMANDS = {
         },
         examples: ['linear schema', 'linear schema issues', 'linear schema --full'],
     },
+    upload: {
+        description: 'Upload a file to Linear and get the asset URL',
+        args: { file: { description: 'Path to the file to upload', required: true } },
+        flags: {
+            'content-type': { type: 'string', description: 'Override the content type (MIME type)' },
+            markdown: { type: 'boolean', char: 'm', description: 'Output as markdown link/image' },
+        },
+        examples: [
+            'linear upload ./screenshot.png',
+            'linear upload ./document.pdf --content-type application/pdf',
+            'linear upload ./image.png --markdown',
+        ],
+    },
     info: {
         description: 'Show comprehensive CLI documentation (this command)',
         flags: {
@@ -516,6 +680,20 @@ const ENTITY_SCHEMAS = {
             teams: 'Associated teams',
         },
     },
+    cycles: {
+        entity: 'cycles',
+        operations: ['list', 'get', 'current'],
+        description: 'Time-boxed iterations (sprints)',
+        fields: {
+            id: 'Unique identifier',
+            number: 'Cycle number',
+            name: 'Cycle name (optional)',
+            startsAt: 'Start date',
+            endsAt: 'End date',
+            progress: 'Completion progress (0-1)',
+            team: 'Associated team',
+        },
+    },
     teams: {
         entity: 'teams',
         operations: ['list'],
@@ -568,6 +746,34 @@ const ENTITY_SCHEMAS = {
             createdAt: 'Creation timestamp',
         },
     },
+    documents: {
+        entity: 'documents',
+        operations: ['list', 'get', 'create', 'update', 'delete'],
+        description: 'Rich text documents in Linear',
+        fields: {
+            id: 'Unique identifier',
+            title: 'Document title',
+            content: 'Markdown content',
+            icon: 'Document icon (emoji)',
+            color: 'Document color (hex)',
+            project: 'Associated project',
+            creator: 'User who created it',
+        },
+    },
+    initiatives: {
+        entity: 'initiatives',
+        operations: ['list', 'get', 'create', 'update', 'delete', 'archive'],
+        description: 'Strategic initiatives grouping projects',
+        fields: {
+            id: 'Unique identifier',
+            name: 'Initiative name',
+            description: 'Initiative description',
+            status: 'Planned/Active/Completed',
+            targetDate: 'Target completion date',
+            owner: 'Initiative owner',
+            projects: 'Associated projects',
+        },
+    },
 };
 const WORKFLOWS = {
     createIssue: {
@@ -644,7 +850,7 @@ export default class Info extends Command {
                 return acc;
             }, {});
             print(success({
-                version: '0.5.1',
+                version: '0.7.0',
                 commands: compactCommands,
                 configKeys: CONFIG_KEYS,
                 note: 'Use "linear info" for full documentation with examples and workflows',
@@ -653,7 +859,7 @@ export default class Info extends Command {
         }
         // Full documentation
         print(success({
-            version: '0.5.1',
+            version: '0.7.0',
             overview: {
                 description: 'CLI for interacting with Linear, designed for LLMs and agents',
                 authentication: 'Run "linear auth login" or set LINEAR_API_KEY environment variable',

package/dist/commands/initiatives/archive.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class InitiativesArchive extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        unarchive: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/initiatives/archive.js

@@ -0,0 +1,44 @@
+import { Args, 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';
+export default class InitiativesArchive extends Command {
+    static description = 'Archive or unarchive an initiative';
+    static examples = [
+        '<%= config.bin %> initiatives archive INITIATIVE_ID',
+        '<%= config.bin %> initiatives archive INITIATIVE_ID --unarchive',
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Initiative ID',
+            required: true,
+        }),
+    };
+    static flags = {
+        unarchive: Flags.boolean({
+            char: 'u',
+            description: 'Unarchive instead of archive',
+            default: false,
+        }),
+    };
+    async run() {
+        try {
+            const { args, flags } = await this.parse(InitiativesArchive);
+            const client = getClient();
+            const payload = flags.unarchive
+                ? await client.unarchiveInitiative(args.id)
+                : await client.archiveInitiative(args.id);
+            if (!payload.success) {
+                throw new CliError(ErrorCodes.API_ERROR, `Failed to ${flags.unarchive ? 'unarchive' : 'archive'} initiative`);
+            }
+            print(success({
+                id: args.id,
+                archived: !flags.unarchive,
+            }));
+        }
+        catch (err) {
+            handleError(err);
+            this.exit(1);
+        }
+    }
+}

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

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+export default class InitiativesCreate extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        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>;
+        status: 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>;
+        'owner-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        icon: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        color: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}