@itsalexr/mcli 1.0.0

package/README.md

@@ -0,0 +1,151 @@
+# mcli — monday.com CLI
+
+A CLI for monday.com's GraphQL API. Works standalone or as a skill inside Claude Code and other coding agents.
+
+## Install
+
+```bash
+npm install -g @itsalexr/mcli
+```
+
+Or run without installing:
+
+```bash
+npx @itsalexr/mcli boards list
+```
+
+## Authentication
+
+Get your API token: **monday.com → Avatar → Administration → Connections → Personal API Token**
+
+```bash
+mcli auth login    # interactive setup, saves token to ~/.env
+mcli auth status   # verify token and show current user
+mcli auth logout   # remove stored token
+```
+
+Or set the environment variable directly:
+
+```bash
+export MONDAY_TOKEN=your_token_here
+```
+
+## Commands
+
+### User & workspaces
+
+```bash
+mcli me
+mcli workspaces
+mcli workspaces --limit 10 --page 2
+```
+
+### Boards
+
+```bash
+mcli boards list
+mcli boards list --workspace-id 12345
+mcli boards get <boardId>
+```
+
+### Items
+
+```bash
+mcli items list <boardId>
+mcli items list <boardId> --columns          # include column values
+mcli items list <boardId> --limit 50 --cursor <cursor>
+
+mcli items create <boardId> --name "My Task"
+mcli items create <boardId> --name "My Task" --group-id grp1 --column-values '{"status": "Done"}'
+
+mcli items update-columns <boardId> <itemId> '{"status": "In Progress"}'
+```
+
+### Updates (comments)
+
+```bash
+mcli updates create <itemId> "This is a comment"
+```
+
+### Raw GraphQL
+
+```bash
+mcli graphql '{ me { id name email } }'
+mcli graphql 'query { boards(limit: 5) { id name } }'
+mcli graphql 'query GetBoard($id: ID!) { boards(ids: [$id]) { id name } }' --variables '{"id": "12345"}'
+```
+
+## Output
+
+All commands output JSON by default. Add `--table` for human-readable output:
+
+```bash
+mcli boards list --table
+mcli items list <boardId> --table
+```
+
+---
+
+## Use with coding agents
+
+### Claude Code (plugin — recommended)
+
+Paste into Claude Code:
+
+```
+/plugin marketplace add itsalexr/mcli
+/plugin install monday@monday-cli
+/reload-plugins
+```
+
+The plugin puts `mcli` in PATH automatically. The Claude Code plugin lives in `claude-plugin/` inside this repo.
+
+### Any agent (instructions snippet)
+
+Add this to your agent's context file and it will use `mcli` for monday.com tasks:
+
+| Agent | File |
+|---|---|
+| Claude Code | `CLAUDE.md` |
+| Codex / OpenCode | `AGENTS.md` |
+| Gemini CLI | `GEMINI.md` |
+| Cursor | `.cursor/rules` |
+| Copilot | `.github/copilot-instructions.md` |
+
+```markdown
+## monday.com
+Use `npx @itsalexr/mcli` to interact with monday.com. No install needed.
+Set MONDAY_TOKEN env var for auth, or run `npx @itsalexr/mcli auth login` once.
+
+Key commands:
+- `npx @itsalexr/mcli boards list [--workspace-id <id>]`
+- `npx @itsalexr/mcli items list <boardId> [--columns] [--table]`
+- `npx @itsalexr/mcli items create <boardId> --name "Task"`
+- `npx @itsalexr/mcli updates create <itemId> "comment text"`
+- `npx @itsalexr/mcli graphql '<query>'`
+```
+
+---
+
+## Development
+
+```bash
+npm run build          # compile TypeScript
+npm test               # run all tests
+npx jest --testPathPattern=boards   # run a specific module's tests
+npm run dev            # run via ts-node (no build step)
+```
+
+## Publishing
+
+```bash
+npm run build
+npm publish --access public
+```
+
+## Configuration
+
+| Variable | Description |
+|---|---|
+| `MONDAY_TOKEN` | API token (required) |
+| `API_VERSION` | monday.com API version (default: `2026-07`) |

package/dist/client.d.ts

@@ -0,0 +1,4 @@
+import { GraphQLClient } from 'graphql-request';
+import type { Config } from './config';
+export declare function createClient(config: Config): GraphQLClient;
+export declare function gqlRequest<T>(client: GraphQLClient, query: string, variables?: Record<string, unknown>): Promise<T>;

package/dist/client.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClient = createClient;
+exports.gqlRequest = gqlRequest;
+const graphql_request_1 = require("graphql-request");
+function createClient(config) {
+    return new graphql_request_1.GraphQLClient(config.endpoint, {
+        headers: {
+            Authorization: config.token,
+            'API-Version': config.apiVersion,
+        },
+    });
+}
+async function gqlRequest(client, query, variables) {
+    try {
+        return await client.request(query, variables);
+    }
+    catch (error) {
+        if (error instanceof graphql_request_1.ClientError && error.response?.errors?.length) {
+            throw new Error(error.response.errors.map((e) => e.message).join('; '));
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;AAGA,oCAOC;AAED,gCAaC;AAzBD,qDAA6D;AAG7D,SAAgB,YAAY,CAAC,MAAc;IACzC,OAAO,IAAI,+BAAa,CAAC,MAAM,CAAC,QAAQ,EAAE;QACxC,OAAO,EAAE;YACP,aAAa,EAAE,MAAM,CAAC,KAAK;YAC3B,aAAa,EAAE,MAAM,CAAC,UAAU;SACjC;KACF,CAAC,CAAC;AACL,CAAC;AAEM,KAAK,UAAU,UAAU,CAC9B,MAAqB,EACrB,KAAa,EACb,SAAmC;IAEnC,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,OAAO,CAAI,KAAK,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,6BAAW,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YACnE,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/commands/auth.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+import { GraphQLClient } from 'graphql-request';
+import { OutputFormat } from '../output';
+export declare function saveToken(token: string, envPath?: string): void;
+export declare function clearToken(envPath?: string): void;
+export declare function runAuthStatus(client: GraphQLClient, format: OutputFormat): Promise<void>;
+export declare function registerAuth(program: Command, clientFactory: () => GraphQLClient): void;

package/dist/commands/auth.js

@@ -0,0 +1,144 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveToken = saveToken;
+exports.clearToken = clearToken;
+exports.runAuthStatus = runAuthStatus;
+exports.registerAuth = registerAuth;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const graphql_request_1 = require("graphql-request");
+const zod_1 = require("zod");
+const chalk_1 = __importDefault(require("chalk"));
+const client_1 = require("../client");
+const output_1 = require("../output");
+const ME_QUERY = (0, graphql_request_1.gql) `
+  query me {
+    me {
+      id
+      name
+      email
+      title
+      account {
+        id
+        name
+      }
+    }
+  }
+`;
+const defaultEnvPath = path.join(process.cwd(), '.env');
+function saveToken(token, envPath = defaultEnvPath) {
+    let content = '';
+    if (fs.existsSync(envPath)) {
+        content = fs.readFileSync(envPath, 'utf8');
+    }
+    const lines = content.split('\n');
+    const tokenLine = `MONDAY_TOKEN=${token}`;
+    const idx = lines.findIndex((l) => l.startsWith('MONDAY_TOKEN='));
+    if (idx >= 0) {
+        lines[idx] = tokenLine;
+        fs.writeFileSync(envPath, lines.join('\n'));
+    }
+    else {
+        const trimmed = content.trimEnd();
+        fs.writeFileSync(envPath, trimmed ? `${trimmed}\n${tokenLine}\n` : `${tokenLine}\n`);
+    }
+}
+function clearToken(envPath = defaultEnvPath) {
+    if (!fs.existsSync(envPath))
+        return;
+    const content = fs.readFileSync(envPath, 'utf8');
+    const filtered = content
+        .split('\n')
+        .filter((l) => !l.startsWith('MONDAY_TOKEN='))
+        .join('\n');
+    fs.writeFileSync(envPath, filtered);
+}
+async function runAuthStatus(client, format) {
+    const data = await (0, client_1.gqlRequest)(client, ME_QUERY);
+    (0, output_1.printOutput)(data.me, format, (me) => ({
+        headers: ['ID', 'Name', 'Email', 'Title', 'Account ID', 'Account Name'],
+        rows: [[me.id, me.name, me.email ?? '', me.title ?? '', me.account.id, me.account.name]],
+    }));
+}
+const LoginSchema = zod_1.z.object({
+    token: zod_1.z.string().min(1, 'Token cannot be empty'),
+});
+function registerAuth(program, clientFactory) {
+    const auth = program.command('auth').description('Manage authentication');
+    auth
+        .command('login')
+        .description('Save your monday.com API token to .env')
+        .requiredOption('--token <token>', 'Monday.com API token')
+        .action((opts) => {
+        try {
+            const { token } = LoginSchema.parse({ token: opts.token });
+            saveToken(token);
+            console.log(chalk_1.default.green('Token saved to .env'));
+        }
+        catch (err) {
+            if (err instanceof zod_1.z.ZodError) {
+                console.error(chalk_1.default.red('Validation error: ' + err.issues.map((i) => i.message).join(', ')));
+                process.exit(1);
+            }
+            throw err;
+        }
+    });
+    auth
+        .command('logout')
+        .description('Remove MONDAY_TOKEN from .env')
+        .action(() => {
+        clearToken();
+        console.log(chalk_1.default.green('Token removed from .env'));
+    });
+    auth
+        .command('status')
+        .description('Verify token and show current user')
+        .action(async () => {
+        const format = program.opts().table ? 'table' : 'json';
+        try {
+            const client = clientFactory();
+            await runAuthStatus(client, format);
+        }
+        catch (err) {
+            console.error(chalk_1.default.red(err.message));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"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"}

package/dist/commands/boards.d.ts

@@ -0,0 +1,44 @@
+import { Command } from 'commander';
+import { GraphQLClient } from 'graphql-request';
+export interface BoardsListResult {
+    boards: Array<{
+        id: string;
+        name: string;
+        description: string | null;
+        state: string;
+        board_kind: string;
+        workspace: {
+            id: string;
+            name: string;
+        } | null;
+    }>;
+}
+export interface BoardInfoResult {
+    boards: Array<{
+        id: string;
+        name: string;
+        description: string | null;
+        state: string;
+        board_kind: string;
+        columns: Array<{
+            id: string;
+            title: string;
+            type: string;
+        }>;
+        groups: Array<{
+            id: string;
+            title: string;
+        }>;
+        workspace: {
+            id: string;
+            name: string;
+        } | null;
+    }>;
+}
+export declare function fetchBoards(client: GraphQLClient, opts: {
+    limit: number;
+    page: number;
+    workspaceId?: string;
+}): Promise<BoardsListResult>;
+export declare function fetchBoardInfo(client: GraphQLClient, boardId: string): Promise<BoardInfoResult>;
+export declare function registerBoards(program: Command, clientFactory: () => GraphQLClient): void;

package/dist/commands/boards.js

@@ -0,0 +1,88 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchBoards = fetchBoards;
+exports.fetchBoardInfo = fetchBoardInfo;
+exports.registerBoards = registerBoards;
+const zod_1 = require("zod");
+const chalk_1 = __importDefault(require("chalk"));
+const client_1 = require("../client");
+const output_1 = require("../output");
+const boards_1 = require("../queries/boards");
+async function fetchBoards(client, opts) {
+    return (0, client_1.gqlRequest)(client, boards_1.LIST_BOARDS_QUERY, {
+        limit: opts.limit,
+        page: opts.page,
+        workspaceIds: opts.workspaceId ? [opts.workspaceId] : undefined,
+    });
+}
+async function fetchBoardInfo(client, boardId) {
+    return (0, client_1.gqlRequest)(client, boards_1.GET_BOARD_INFO_QUERY, { boardId });
+}
+function printBoardInfo(board, format) {
+    if (format === 'json') {
+        (0, output_1.printJson)(board);
+        return;
+    }
+    (0, output_1.printTable)(['ID', 'Name', 'State', 'Kind', 'Workspace'], [[board.id, board.name, board.state, board.board_kind, board.workspace?.name ?? '']]);
+    (0, output_1.printTable)(['Column ID', 'Title', 'Type'], board.columns.map((c) => [c.id, c.title, c.type]));
+    (0, output_1.printTable)(['Group ID', 'Title'], board.groups.map((g) => [g.id, g.title]));
+}
+const BoardsListOptionsSchema = zod_1.z.object({
+    workspaceId: zod_1.z.string().optional(),
+    limit: zod_1.z.coerce.number().int().positive().default(50),
+    page: zod_1.z.coerce.number().int().positive().default(1),
+});
+function registerBoards(program, clientFactory) {
+    const boards = program.command('boards').description('Manage monday.com boards');
+    boards
+        .command('list', { isDefault: true })
+        .description('List boards')
+        .option('--workspace-id <id>', 'Filter by workspace ID')
+        .option('--limit <n>', 'Number of boards to return', '50')
+        .option('--page <n>', 'Page number', '1')
+        .action(async (opts) => {
+        const format = program.opts().table ? 'table' : 'json';
+        try {
+            const { workspaceId, limit, page } = BoardsListOptionsSchema.parse(opts);
+            const client = clientFactory();
+            const data = await fetchBoards(client, { limit, page, workspaceId });
+            if (format === 'table') {
+                (0, output_1.printTable)(['ID', 'Name', 'State', 'Kind', 'Workspace'], data.boards.map((b) => [b.id, b.name, b.state, b.board_kind, b.workspace?.name ?? '']));
+            }
+            else {
+                (0, output_1.printJson)(data.boards);
+            }
+        }
+        catch (err) {
+            if (err instanceof zod_1.z.ZodError) {
+                console.error(chalk_1.default.red('Validation error: ' + err.issues.map((i) => i.message).join(', ')));
+                process.exit(1);
+            }
+            console.error(chalk_1.default.red(err.message));
+            process.exit(1);
+        }
+    });
+    boards
+        .command('get <boardId>')
+        .description('Get detailed board info')
+        .action(async (boardId) => {
+        const format = program.opts().table ? 'table' : 'json';
+        try {
+            const client = clientFactory();
+            const data = await fetchBoardInfo(client, boardId);
+            if (data.boards.length === 0) {
+                console.error(chalk_1.default.red(`Board ${boardId} not found`));
+                process.exit(1);
+            }
+            printBoardInfo(data.boards[0], format);
+        }
+        catch (err) {
+            console.error(chalk_1.default.red(err.message));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=boards.js.map

package/dist/commands/boards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boards.js","sourceRoot":"","sources":["../../src/commands/boards.ts"],"names":[],"mappings":"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"}

package/dist/commands/graphql.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+import { GraphQLClient } from 'graphql-request';
+export declare function runRawGraphql(client: GraphQLClient, query: string, variablesJson?: string): Promise<unknown>;
+export declare function registerGraphql(program: Command, clientFactory: () => GraphQLClient): void;

package/dist/commands/graphql.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runRawGraphql = runRawGraphql;
+exports.registerGraphql = registerGraphql;
+const zod_1 = require("zod");
+const chalk_1 = __importDefault(require("chalk"));
+const client_1 = require("../client");
+const output_1 = require("../output");
+const isValidJson = (v) => {
+    if (!v)
+        return true;
+    try {
+        JSON.parse(v);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const GraphqlCmdSchema = zod_1.z.object({
+    query: zod_1.z.string().min(1, 'Query cannot be empty'),
+    variables: zod_1.z
+        .string()
+        .optional()
+        .refine(isValidJson, { message: '--variables must be valid JSON' }),
+});
+async function runRawGraphql(client, query, variablesJson) {
+    if (variablesJson !== undefined) {
+        // Validate JSON before sending
+        GraphqlCmdSchema.parse({ query, variables: variablesJson });
+    }
+    const variables = variablesJson ? JSON.parse(variablesJson) : undefined;
+    return (0, client_1.gqlRequest)(client, query, variables);
+}
+function registerGraphql(program, clientFactory) {
+    program
+        .command('graphql <query>')
+        .description('Execute a raw GraphQL query or mutation')
+        .option('--variables <json>', 'Variables as JSON string')
+        .action(async (query, opts) => {
+        try {
+            GraphqlCmdSchema.parse({ query, variables: opts.variables });
+            const client = clientFactory();
+            const result = await runRawGraphql(client, query, opts.variables);
+            (0, output_1.printJson)(result);
+        }
+        catch (err) {
+            if (err instanceof zod_1.z.ZodError) {
+                console.error(chalk_1.default.red('Validation error: ' + err.issues.map((i) => i.message).join(', ')));
+                process.exit(1);
+            }
+            console.error(chalk_1.default.red(err.message));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=graphql.js.map

package/dist/commands/graphql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.js","sourceRoot":"","sources":["../../src/commands/graphql.ts"],"names":[],"mappings":";;;;;AAyBA,sCAWC;AAED,0CAoBC;AAxDD,6BAAwB;AACxB,kDAA0B;AAC1B,sCAAuC;AACvC,sCAAsC;AAEtC,MAAM,WAAW,GAAG,CAAC,CAAqB,EAAE,EAAE;IAC5C,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC;IACjD,SAAS,EAAE,OAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,MAAM,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;CACtE,CAAC,CAAC;AAEI,KAAK,UAAU,aAAa,CACjC,MAAqB,EACrB,KAAa,EACb,aAAsB;IAEtB,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,+BAA+B;QAC/B,gBAAgB,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxE,OAAO,IAAA,mBAAU,EAAU,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AACvD,CAAC;AAED,SAAgB,eAAe,CAAC,OAAgB,EAAE,aAAkC;IAClF,OAAO;SACJ,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,yCAAyC,CAAC;SACtD,MAAM,CAAC,oBAAoB,EAAE,0BAA0B,CAAC;SACxD,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,IAA4B,EAAE,EAAE;QAC5D,IAAI,CAAC;YACH,gBAAgB,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YAC7D,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAClE,IAAA,kBAAS,EAAC,MAAM,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,OAAC,CAAC,QAAQ,EAAE,CAAC;gBAC9B,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,oBAAoB,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC7F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/items.d.ts

@@ -0,0 +1,48 @@
+import { Command } from 'commander';
+import { GraphQLClient } from 'graphql-request';
+export interface ItemsPageResult {
+    boards: Array<{
+        items_page: {
+            items: Array<{
+                id: string;
+                name: string;
+                url: string;
+                created_at: string;
+                updated_at: string;
+                column_values: Array<{
+                    id: string;
+                    type: string;
+                    text: string;
+                    value: string;
+                }>;
+            }>;
+            cursor: string | null;
+        };
+    }>;
+}
+export interface CreateItemResult {
+    create_item: {
+        id: string;
+        name: string;
+        url: string;
+    };
+}
+export interface UpdateColumnsResult {
+    change_multiple_column_values: {
+        id: string;
+        name: string;
+        url: string;
+    };
+}
+export declare function fetchItems(client: GraphQLClient, boardId: string, opts: {
+    limit: number;
+    includeColumns: boolean;
+    cursor?: string;
+}): Promise<ItemsPageResult>;
+export declare function createItem(client: GraphQLClient, boardId: string, opts: {
+    name: string;
+    groupId?: string;
+    columnValues?: string;
+}): Promise<CreateItemResult>;
+export declare function updateItemColumns(client: GraphQLClient, boardId: string, itemId: string, columnValuesJson: string): Promise<UpdateColumnsResult>;
+export declare function registerItems(program: Command, clientFactory: () => GraphQLClient): void;