linear-cli-agents 0.6.0 → 0.7.1

package/README.md

@@ -14,7 +14,7 @@ A CLI for interacting with [Linear](https://linear.app), designed for LLMs and a
 - **Configurable defaults**: Set default team to skip `--team-id` on every command
 - **Bulk operations**: Update multiple issues at once with `bulk-update` and `bulk-label`
 - **Schema introspection**: Discover available operations programmatically
-- **Full CRUD**: Issues, projects, labels, comments, templates, milestones
+- **Full CRUD**: Issues, projects, labels, comments, templates, milestones, documents, initiatives
 - **Issue relations**: Manage blocks, duplicates, and related issues
 - **Project management**: Projects, milestones, and status updates
 - **Team management**: List and browse teams, states, users
@@ -106,9 +106,12 @@ linear issues list --format plain
 # Get a specific issue
 linear issues get ENG-123
 linear issues get ENG-123 --format table
+linear issues get ENG-123 --with-attachments  # Include linked PRs, commits
 
 # Create an issue
 linear issues create --title "Bug fix" --team-id <team-id>
+linear issues create --title "Task" --team-id <team-id> --due-date 2024-12-31
+linear issues create --title "Sprint work" --team-id <team-id> --cycle-id <cycle-id>
 linear issues create --input '{"title":"Feature","teamId":"xxx","priority":2}'
 
 # Update an issue
@@ -288,6 +291,70 @@ linear cycles current --team ENG
 linear cycles get CYCLE_ID
 ```
 
+### Documents
+
+```bash
+# List documents
+linear documents list
+
+# Get document details
+linear documents get DOCUMENT_ID
+
+# Create a document
+linear documents create --title "Meeting Notes"
+linear documents create --title "Specs" --content "# Overview\n\nDetails here..."
+linear documents create --title "Project Doc" --project-id PROJECT_ID
+
+# Update a document
+linear documents update DOCUMENT_ID --title "New Title"
+linear documents update DOCUMENT_ID --content "Updated content"
+
+# Delete a document
+linear documents delete DOCUMENT_ID
+```
+
+### Initiatives
+
+```bash
+# List initiatives
+linear initiatives list
+linear initiatives list --status Active
+linear initiatives list --status Completed
+
+# Get initiative details
+linear initiatives get INITIATIVE_ID
+
+# Create an initiative
+linear initiatives create --name "Q1 Goals"
+linear initiatives create --name "Product Launch" --status Active --target-date 2024-12-31
+
+# Update an initiative
+linear initiatives update INITIATIVE_ID --name "New Name"
+linear initiatives update INITIATIVE_ID --status Completed
+
+# Archive/unarchive an initiative
+linear initiatives archive INITIATIVE_ID
+linear initiatives archive INITIATIVE_ID --unarchive
+
+# Delete an initiative
+linear initiatives delete INITIATIVE_ID
+```
+
+### Upload Files
+
+```bash
+# Upload a file and get the asset URL
+linear upload ./screenshot.png
+linear upload ./document.pdf
+
+# Output as markdown (for embedding in descriptions)
+linear upload ./image.png --markdown
+# Returns: ![image.png](https://linear-uploads.s3.amazonaws.com/...)
+
+# Specify content type
+linear upload ./file.dat --content-type application/octet-stream
+```
+
 ### Users
 
 ```bash

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

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class DocumentsCreate extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        title: import("@oclif/core/interfaces").OptionFlag<string, 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/create.js

@@ -0,0 +1,68 @@
+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';
+export default class DocumentsCreate extends Command {
+    static description = 'Create a new document';
+    static examples = [
+        '<%= config.bin %> documents create --title "My Document"',
+        '<%= config.bin %> documents create --title "Project Doc" --project-id PROJECT_ID',
+        '<%= config.bin %> documents create --title "Notes" --content "# Heading\\n\\nContent here"',
+    ];
+    static flags = {
+        title: Flags.string({
+            char: 't',
+            description: 'Document title',
+            required: true,
+        }),
+        content: Flags.string({
+            char: 'c',
+            description: 'Document content (markdown)',
+        }),
+        'project-id': Flags.string({
+            description: 'Project ID to associate with',
+        }),
+        icon: Flags.string({
+            description: 'Document icon (emoji)',
+        }),
+        color: Flags.string({
+            description: 'Document color (hex)',
+        }),
+    };
+    async run() {
+        try {
+            const { flags } = await this.parse(DocumentsCreate);
+            const client = getClient();
+            const input = {
+                title: flags.title,
+            };
+            if (flags.content)
+                input.content = flags.content;
+            if (flags['project-id'])
+                input.projectId = flags['project-id'];
+            if (flags.icon)
+                input.icon = flags.icon;
+            if (flags.color)
+                input.color = flags.color;
+            const payload = await client.createDocument(input);
+            if (!payload.success) {
+                throw new CliError(ErrorCodes.API_ERROR, 'Failed to create document');
+            }
+            const document = await payload.document;
+            if (!document) {
+                throw new CliError(ErrorCodes.API_ERROR, 'Document not returned');
+            }
+            const project = await document.project;
+            print(success({
+                id: document.id,
+                title: document.title,
+                project: project ? { id: project.id, name: project.name } : null,
+                createdAt: document.createdAt,
+            }));
+        }
+        catch (err) {
+            handleError(err);
+            this.exit(1);
+        }
+    }
+}

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

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

package/dist/commands/documents/delete.js

@@ -0,0 +1,32 @@
+import { Args, Command } 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 DocumentsDelete extends Command {
+    static description = 'Delete a document (moves to trash)';
+    static examples = ['<%= config.bin %> documents delete DOCUMENT_ID'];
+    static args = {
+        id: Args.string({
+            description: 'Document ID',
+            required: true,
+        }),
+    };
+    async run() {
+        try {
+            const { args } = await this.parse(DocumentsDelete);
+            const client = getClient();
+            const payload = await client.deleteDocument(args.id);
+            if (!payload.success) {
+                throw new CliError(ErrorCodes.API_ERROR, 'Failed to delete document');
+            }
+            print(success({
+                id: args.id,
+                deleted: true,
+            }));
+        }
+        catch (err) {
+            handleError(err);
+            this.exit(1);
+        }
+    }
+}

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

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

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);
+        }
+    }
+}