@izumisy-tailor/issue-tool

A handy CLI utility for managing GitHub issues and project boards.

• Analyze GitHub Discussions with AI and generate structured issue drafts
• Batch-create issues from reviewed drafts and add them to a project board
• List ReadyForDev tickets assigned to you

Prerequisites

• Node.js v18+
• GitHub CLI (gh auth login) or GITHUB_TOKEN environment variable

Setup

Create issue-tool.config.ts in your project root:

import { defineConfig } from "@izumisy-tailor/issue-tool";

export default defineConfig({
  // Where to fetch discussions from
  source: {
    repo: "your-org/discussion",
    label: "bug",
  },
  // Where to create issues
  target: {
    repo: "your-org/issue-management",
  },
  // Project board to manage issues on
  project: {
    owner: "your-org",
    number: 15,
    fields: {
      component: { field: "Component", value: "frontend" },
      status: { field: "Status", readyValue: "ReadyForDev" },
    },
  },
  // optional (defaults shown)
  // ai: { model: "gpt-4.1" },
  // concurrency: 3,
});

Commands

fetch — Generate drafts from discussions

npx @izumisy-tailor/issue-tool fetch

Fetches labeled discussions from the source repo, analyzes them with the Copilot SDK, and generates draft issue files in .draft/.

apply — Create issues from drafts

npx @izumisy-tailor/issue-tool apply

Creates issues from draft files in .draft/, adds them to the project board, and posts a comment back on the original discussion.

ready — List ReadyForDev tickets

npx @izumisy-tailor/issue-tool ready
npx @izumisy-tailor/issue-tool ready --all

Lists ReadyForDev tickets on the project board. Shows only items assigned to you by default.

| Flag | Description | | ------- | --------------- | | --all | Show all items |