@bretwardjames/ghp-cli 0.1.0

package/dist/index.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { workCommand } from './commands/work.js';
+import { planCommand } from './commands/plan.js';
+import { startCommand } from './commands/start.js';
+import { doneCommand } from './commands/done.js';
+import { moveCommand } from './commands/move.js';
+import { switchCommand } from './commands/switch.js';
+import { linkBranchCommand } from './commands/link-branch.js';
+import { unlinkBranchCommand } from './commands/unlink-branch.js';
+import { prCommand } from './commands/pr.js';
+import { assignCommand } from './commands/assign.js';
+import { authCommand } from './commands/auth.js';
+import { configCommand } from './commands/config.js';
+import { addIssueCommand } from './commands/add-issue.js';
+import { setFieldCommand } from './commands/set-field.js';
+import { sliceCommand } from './commands/slice.js';
+import { openCommand } from './commands/open.js';
+import { commentCommand } from './commands/comment.js';
+const program = new Command();
+program
+    .name('ghp')
+    .description('GitHub Projects CLI - manage project boards from your terminal')
+    .version('0.1.0');
+// Authentication
+program
+    .command('auth')
+    .description('Authenticate with GitHub')
+    .option('--status', 'Check authentication status')
+    .action(authCommand);
+// Configuration
+program
+    .command('config')
+    .description('View or set configuration')
+    .argument('[key]', 'Config key to get/set')
+    .argument('[value]', 'Value to set')
+    .option('-l, --list', 'List all config values')
+    .option('-e, --edit', 'Open config file in editor (creates template if missing)')
+    .action(configCommand);
+// Main views
+program
+    .command('work')
+    .alias('w')
+    .description('Show items assigned to you (sidebar view)')
+    .option('-a, --all', 'Show all items, not just assigned to me')
+    .option('-s, --status <status>', 'Filter by status')
+    .option('--hide-done', 'Hide completed items')
+    .option('-l, --list', 'Output as simple list (one item per line, for pickers)')
+    .action(workCommand);
+program
+    .command('plan [shortcut]')
+    .alias('p')
+    .description('Show project board or filtered list view (use shortcut name from config)')
+    .option('-p, --project <project>', 'Filter by project name')
+    .option('-s, --status <status>', 'Show only items in this status (list view)')
+    .option('-m, --mine', 'Show only items assigned to me')
+    .option('-u, --unassigned', 'Show only unassigned items')
+    .option('-l, --list', 'Output as simple list (one item per line, for pickers)')
+    .option('--sort <fields>', 'Sort by fields (comma-separated, prefix with - for ascending, e.g., "status,-title")')
+    .option('--slice <field=value>', 'Filter by field (repeatable: --slice label=bug --slice Priority=High)', (val, acc) => { acc.push(val); return acc; }, [])
+    .action(planCommand);
+// Workflow commands
+program
+    .command('start <issue>')
+    .alias('s')
+    .description('Start working on an issue - creates branch and updates status')
+    .option('--no-branch', 'Skip branch creation')
+    .option('--no-status', 'Skip status update')
+    .action(startCommand);
+program
+    .command('done <issue>')
+    .alias('d')
+    .description('Mark an issue as done')
+    .action(doneCommand);
+program
+    .command('move <issue> <status>')
+    .alias('m')
+    .description('Move an issue to a different status')
+    .action(moveCommand);
+// Branch commands
+program
+    .command('switch <issue>')
+    .alias('sw')
+    .description('Switch to the branch linked to an issue')
+    .action(switchCommand);
+program
+    .command('link-branch <issue> [branch]')
+    .alias('lb')
+    .description('Link a branch to an issue (defaults to current branch)')
+    .action(linkBranchCommand);
+program
+    .command('unlink-branch <issue>')
+    .alias('ub')
+    .description('Unlink the branch from an issue')
+    .action(unlinkBranchCommand);
+// PR workflow
+program
+    .command('pr [issue]')
+    .description('Create or view PR for an issue')
+    .option('--create', 'Create a new PR')
+    .option('--open', 'Open PR in browser')
+    .action(prCommand);
+// Assignment
+program
+    .command('assign <issue> [users...]')
+    .description('Assign users to an issue (empty to assign self)')
+    .option('--remove', 'Remove assignment instead of adding')
+    .action(assignCommand);
+// Issue creation
+program
+    .command('add-issue [title]')
+    .alias('add')
+    .description('Create a new issue and add to project')
+    .option('-b, --body <body>', 'Issue body/description')
+    .option('-p, --project <project>', 'Project to add to (defaults to first)')
+    .option('-s, --status <status>', 'Initial status')
+    .option('-e, --edit', 'Open $EDITOR to write issue body')
+    .option('-t, --template <name>', 'Use an issue template from .github/ISSUE_TEMPLATE/')
+    .option('--list-templates', 'List available issue templates')
+    .action(addIssueCommand);
+// Field management
+program
+    .command('set-field <issue> <field> <value>')
+    .alias('sf')
+    .description('Set a field value on an issue')
+    .action(setFieldCommand);
+// Filtering/slicing
+program
+    .command('slice')
+    .description('Filter items by field values (interactive)')
+    .option('-f, --field <field>', 'Field to filter by')
+    .option('-v, --value <value>', 'Value to filter for')
+    .option('--list-fields', 'List available fields')
+    .action(sliceCommand);
+// Quick access
+program
+    .command('open <issue>')
+    .alias('o')
+    .description('View issue details')
+    .option('-b, --browser', 'Open in browser instead of terminal')
+    .action(openCommand);
+program
+    .command('comment <issue>')
+    .alias('c')
+    .description('Add a comment to an issue')
+    .option('-m, --message <text>', 'Comment text (opens editor if not provided)')
+    .action(commentCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,37 @@
+export interface RepoInfo {
+    owner: string;
+    name: string;
+    fullName: string;
+}
+export interface ProjectItem {
+    id: string;
+    title: string;
+    number: number | null;
+    type: 'issue' | 'pull_request' | 'draft';
+    issueType: string | null;
+    status: string | null;
+    assignees: string[];
+    labels: Array<{
+        name: string;
+        color: string;
+    }>;
+    repository: string | null;
+    url: string | null;
+    projectId: string;
+    projectTitle: string;
+    fields: Record<string, string>;
+}
+export interface Project {
+    id: string;
+    title: string;
+    number: number;
+    url: string;
+}
+export interface StatusField {
+    fieldId: string;
+    options: Array<{
+        id: string;
+        name: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,OAAO,CAAC;IACzC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACN"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@bretwardjames/ghp-cli",
+  "version": "0.1.0",
+  "description": "GitHub Projects CLI - manage project boards from your terminal",
+  "main": "./dist/index.js",
+  "bin": {
+    "ghp": "./dist/index.js"
+  },
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "lint": "eslint src --ext ts",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "github",
+    "projects",
+    "cli",
+    "task",
+    "kanban",
+    "issue",
+    "project-management"
+  ],
+  "author": "bretwardjames",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bretwardjames/ghp-cli"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@octokit/graphql": "^7.0.2",
+    "commander": "^12.0.0",
+    "chalk": "^5.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.2"
+  }
+}