@niiiiiiile/iw-backlog-cli 0.1.0

package/.env.example

@@ -0,0 +1,8 @@
+# Backlog スペース URL（プロファイル未使用時のフォールバック）
+BACKLOG_BASE_URL=https://yourspace.backlog.com
+
+# デフォルトプロジェクトキー
+BACKLOG_PROJECT_KEY=MYPROJECT
+
+# Backlog API キー（スペース設定 > API から発行）
+BACKLOG_API_KEY=your_api_key_here

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Teruaki Iwane
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,203 @@
+# backlog-cli
+
+`backlog-cli` は [Nulab Backlog](https://backlog.com/) の課題・プロジェクトをターミナルから操作する CLI ツールです。`setup` / `profile` による接続情報管理と、`issue` / `project` / `whoami` による日常操作を一貫したフローで提供します。
+
+![Node.js](https://img.shields.io/badge/Node.js-20%2B-339933?logo=node.js&logoColor=white)
+![CLI](https://img.shields.io/badge/interface-CLI-4D4D4D)
+![License](https://img.shields.io/badge/license-MIT-blue)
+
+## Table of contents
+
+* [Overview](#overview)
+* [Features](#features)
+* [Installation](#installation)
+  + [Install globally](#install-globally)
+  + [Run with npx](#run-with-npx)
+  + [Run from source](#run-from-source)
+* [Quick start](#quick-start)
+* [Profiles](#profiles)
+* [Environment variables](#environment-variables)
+* [Authentication check](#authentication-check)
+* [Credential precedence](#credential-precedence)
+* [Usage](#usage)
+  + [Issue commands](#issue-commands)
+  + [Project commands](#project-commands)
+  + [Profile commands](#profile-commands)
+* [Development](#development)
+* [License](#license)
+
+## Overview
+
+`backlog-cli` は Backlog の API をシンプルに扱うための CLI です。初回は `backlog setup` で接続情報を保存し、その後は `backlog issue ...` や `backlog project ...` をそのまま実行できます。複数スペースを扱う場合も `profile` で切り替えできます。
+
+## Features
+
+- 課題の一覧取得・詳細確認・作成・更新・削除・コメント操作
+- プロジェクト一覧取得・詳細確認
+- `setup` / `profile` による複数スペース管理
+- `whoami` による接続確認
+- フラグ / プロファイル / 環境変数の優先順位による資格情報解決
+
+## Installation
+
+### Install globally
+
+```bash
+npm install -g @niiiiiiile/iw-backlog-cli
+```
+
+### Run with npx
+
+```bash
+npx @niiiiiiile/iw-backlog-cli --help
+npx @niiiiiiile/iw-backlog-cli issue list
+```
+
+### Run from source
+
+```bash
+git clone https://github.com/Niiiiile/backlog-cli.git
+cd backlog-cli
+npm install
+npm run dev -- --help
+```
+
+## Quick start
+
+```bash
+backlog setup \
+  --url https://yourspace.backlog.com \
+  --api-key YOUR_API_KEY \
+  --project-key MYPROJECT
+```
+
+初回登録時は `default` プロファイルに保存され、自動でデフォルトになります。
+
+## Profiles
+
+複数スペースを使い分ける場合は `profile` を使います。
+
+```bash
+# work プロファイルを追加
+backlog profile add work \
+  --url https://yourspace.backlog.com \
+  --api-key YOUR_API_KEY \
+  --project-key MYPROJECT
+
+# プロファイル一覧
+backlog profile list
+
+# デフォルト切り替え
+backlog profile use work
+
+# 実行時だけ別プロファイルを使う
+backlog issue list --profile work
+```
+
+## Environment variables
+
+`.env.example` を参考に環境変数を設定することもできます。
+
+```bash
+export BACKLOG_BASE_URL=https://yourspace.backlog.com
+export BACKLOG_API_KEY=your_api_key_here
+export BACKLOG_PROJECT_KEY=MYPROJECT
+```
+
+## Authentication check
+
+```bash
+backlog whoami
+```
+
+## Credential precedence
+
+1. コマンドフラグ（`--url`, `--api-key`, `--project-key`）
+2. 設定ファイルのプロファイル（`--profile` または default）
+3. 環境変数（`BACKLOG_BASE_URL`, `BACKLOG_API_KEY`, `BACKLOG_PROJECT_KEY`）
+
+## Usage
+
+```bash
+backlog --help
+```
+
+### Issue commands
+
+| サブコマンド | 説明 |
+|---|---|
+| `list` | 課題の一覧を取得（キーワード・ステータス・担当者でフィルタ可） |
+| `get <issueIdOrKey>` | 課題の詳細を取得 |
+| `add` | 課題を作成 |
+| `update <issueIdOrKey>` | 課題を更新（ステータス変更・コメント追加など） |
+| `delete <issueIdOrKey>` | 課題を削除 |
+| `comments <issueIdOrKey>` | コメント一覧を取得 |
+| `comment-add <issueIdOrKey> <content>` | コメントを追加 |
+
+```bash
+# 最新20件を取得
+backlog issue list
+
+# キーワード検索
+backlog issue list --keyword バグ
+
+# 未対応・処理中のみ
+backlog issue list --status-id 1,2
+
+# 課題の詳細
+backlog issue get PROJ-123
+
+# 課題を作成
+backlog issue add --summary "画面表示のバグ" --issue-type-id 2 --priority-id 2
+
+# ステータスを完了に変更しコメントを追加
+backlog issue update PROJ-123 --status-id 4 --comment "対応完了"
+
+# コメント一覧
+backlog issue comments PROJ-123
+```
+
+### Project commands
+
+| サブコマンド | 説明 |
+|---|---|
+| `list` | 参加しているプロジェクトの一覧を取得 |
+| `get <projectIdOrKey>` | プロジェクトの詳細を取得 |
+
+```bash
+backlog project list
+backlog project get MYPROJECT
+```
+
+### Profile commands
+
+| サブコマンド | 説明 |
+|---|---|
+| `list` | 登録済みプロファイルの一覧を表示 |
+| `add <name>` | プロファイルを追加・更新 |
+| `remove <name>` | プロファイルを削除 |
+| `use <name>` | デフォルトプロファイルを変更 |
+
+```bash
+backlog profile add personal --url https://myspace.backlog.jp --api-key KEY2 --project-key MYPROJ
+
+# プロファイル一覧
+backlog profile list
+```
+
+## Development
+
+```bash
+# 依存関係のインストール
+npm install
+
+# TypeScript のビルド
+npm run build
+
+# ビルドなしで直接実行
+npm run dev -- --help
+```
+
+## ライセンス
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,7 @@
+export interface BacklogClient {
+    get: <T>(path: string, params?: Record<string, unknown>) => Promise<T>;
+    post: <T>(path: string, body?: Record<string, unknown>) => Promise<T>;
+    patch: <T>(path: string, body?: Record<string, unknown>) => Promise<T>;
+    delete: <T>(path: string) => Promise<T>;
+}
+export declare function createClient(baseUrl: string, apiKey: string): BacklogClient;

package/dist/client.js

@@ -0,0 +1,45 @@
+function toFormPairs(obj) {
+    const pairs = [];
+    for (const [key, value] of Object.entries(obj)) {
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                pairs.push([`${key}[]`, String(item)]);
+            }
+        }
+        else {
+            pairs.push([key, String(value)]);
+        }
+    }
+    return pairs;
+}
+export function createClient(baseUrl, apiKey) {
+    const base = baseUrl.replace(/\/$/, '');
+    async function request(method, path, params, body) {
+        const url = new URL(`${base}/api/v2${path}`);
+        url.searchParams.set('apiKey', apiKey);
+        if (params) {
+            for (const [k, v] of toFormPairs(params)) {
+                url.searchParams.append(k, v);
+            }
+        }
+        const init = { method };
+        if (body) {
+            init.headers = { 'Content-Type': 'application/x-www-form-urlencoded' };
+            init.body = new URLSearchParams(toFormPairs(body));
+        }
+        const res = await fetch(url.toString(), init);
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            throw new Error(`Backlog API エラー [${res.status}]: ${text}`);
+        }
+        return res.json();
+    }
+    return {
+        get: (path, params) => request('GET', path, params),
+        post: (path, body) => request('POST', path, undefined, body),
+        patch: (path, body) => request('PATCH', path, undefined, body),
+        delete: (path) => request('DELETE', path),
+    };
+}

package/dist/commands/issue.d.ts

@@ -0,0 +1,2 @@
+import { Cli } from 'incur';
+export declare const issueCli: Cli.Cli<{}, undefined, undefined>;

package/dist/commands/issue.js

@@ -0,0 +1,311 @@
+import { Cli, z } from 'incur';
+import { createClient } from '../client.js';
+import { resolveCredentials } from '../config.js';
+import { authOptions } from '../shared.js';
+async function resolveProjectId(client, projectKey) {
+    const project = await client.get(`/projects/${projectKey}`);
+    return project.id;
+}
+function parseIds(value) {
+    if (!value)
+        return undefined;
+    return value
+        .split(',')
+        .map((s) => Number(s.trim()))
+        .filter((n) => !Number.isNaN(n));
+}
+function formatIssue(issue) {
+    return {
+        key: issue.issueKey,
+        summary: issue.summary,
+        status: issue.status.name,
+        priority: issue.priority.name,
+        issueType: issue.issueType.name,
+        assignee: issue.assignee?.name ?? null,
+        dueDate: issue.dueDate ?? null,
+        created: issue.created,
+        updated: issue.updated,
+    };
+}
+export const issueCli = Cli.create('issue', {
+    description: '課題操作',
+});
+issueCli.command('list', {
+    description: '課題の一覧を取得',
+    options: z.object({
+        keyword: z.string().optional().describe('キーワード検索'),
+        statusId: z
+            .string()
+            .optional()
+            .describe('ステータス ID（カンマ区切り）例: 1,2 (1=未対応,2=処理中,3=処理済み,4=完了)'),
+        assigneeId: z.string().optional().describe('担当者ユーザー ID（カンマ区切り）'),
+        count: z.coerce.number().default(20).describe('取得件数（1〜100）'),
+        offset: z.coerce.number().default(0).describe('オフセット'),
+        sort: z
+            .enum(['created', 'updated', 'status', 'priority', 'dueDate', 'summary'])
+            .optional()
+            .describe('ソートフィールド'),
+        order: z.enum(['asc', 'desc']).default('desc').describe('ソート順'),
+        ...authOptions.shape,
+    }),
+    examples: [
+        { description: 'デフォルトプロジェクトの課題一覧（最新20件）' },
+        { options: { keyword: 'バグ' }, description: 'キーワード "バグ" で検索' },
+        { options: { statusId: '1,2' }, description: '未対応・処理中の課題のみ' },
+        { options: { count: 50, sort: 'dueDate', order: 'asc' }, description: '期限日順で50件取得' },
+        { options: { profile: 'work' }, description: '別プロファイルで取得' },
+    ],
+    async run(c) {
+        const creds = resolveCredentials(c.options);
+        const client = createClient(creds.baseUrl, creds.apiKey);
+        const projectId = await resolveProjectId(client, creds.projectKey);
+        const params = {
+            projectId: [projectId],
+            count: c.options.count,
+            offset: c.options.offset,
+            order: c.options.order,
+        };
+        if (c.options.keyword)
+            params.keyword = c.options.keyword;
+        if (c.options.statusId)
+            params.statusId = parseIds(c.options.statusId);
+        if (c.options.assigneeId)
+            params.assigneeId = parseIds(c.options.assigneeId);
+        if (c.options.sort)
+            params.sort = c.options.sort;
+        const issues = await client.get('/issues', params);
+        return {
+            count: issues.length,
+            issues: issues.map(formatIssue),
+        };
+    },
+});
+issueCli.command('get', {
+    description: '課題の詳細を取得',
+    args: z.object({
+        issueIdOrKey: z.string().describe('課題 ID または課題キー（例: PROJ-123）'),
+    }),
+    options: authOptions,
+    examples: [
+        { args: { issueIdOrKey: 'PROJ-123' }, description: '課題キーで詳細取得' },
+        { args: { issueIdOrKey: '123456' }, description: '課題 ID で詳細取得' },
+    ],
+    async run(c) {
+        const creds = resolveCredentials(c.options);
+        const client = createClient(creds.baseUrl, creds.apiKey);
+        const issue = await client.get(`/issues/${c.args.issueIdOrKey}`);
+        return {
+            key: issue.issueKey,
+            summary: issue.summary,
+            description: issue.description ?? '',
+            status: issue.status.name,
+            priority: issue.priority.name,
+            issueType: issue.issueType.name,
+            assignee: issue.assignee?.name ?? null,
+            startDate: issue.startDate ?? null,
+            dueDate: issue.dueDate ?? null,
+            estimatedHours: issue.estimatedHours ?? null,
+            actualHours: issue.actualHours ?? null,
+            created: issue.created,
+            updated: issue.updated,
+        };
+    },
+});
+issueCli.command('add', {
+    description: '課題を作成',
+    options: z.object({
+        summary: z.string().describe('課題の件名'),
+        issueTypeId: z.coerce.number().describe('課題種別 ID'),
+        priorityId: z.coerce.number().describe('優先度 ID（2=高,3=中,4=低）'),
+        description: z.string().optional().describe('課題の詳細'),
+        assigneeId: z.coerce.number().optional().describe('担当者のユーザー ID'),
+        startDate: z.string().optional().describe('開始日（yyyy-MM-dd）'),
+        dueDate: z.string().optional().describe('期限日（yyyy-MM-dd）'),
+        estimatedHours: z.coerce.number().optional().describe('予定時間'),
+        parentIssueId: z.coerce.number().optional().describe('親課題 ID'),
+        ...authOptions.shape,
+    }),
+    examples: [
+        {
+            options: { summary: '画面表示のバグ', issueTypeId: 2, priorityId: 2 },
+            description: '最小構成で課題を作成（件名・種別・優先度）',
+        },
+        {
+            options: {
+                summary: '新機能の実装',
+                issueTypeId: 1,
+                priorityId: 3,
+                description: '詳細な説明',
+                dueDate: '2026-04-30',
+                estimatedHours: 8,
+            },
+            description: '詳細情報を含めて課題を作成',
+        },
+    ],
+    async run(c) {
+        const creds = resolveCredentials(c.options);
+        const client = createClient(creds.baseUrl, creds.apiKey);
+        const projectId = await resolveProjectId(client, creds.projectKey);
+        const body = {
+            projectId,
+            summary: c.options.summary,
+            issueTypeId: c.options.issueTypeId,
+            priorityId: c.options.priorityId,
+        };
+        if (c.options.description)
+            body.description = c.options.description;
+        if (c.options.assigneeId)
+            body.assigneeId = c.options.assigneeId;
+        if (c.options.startDate)
+            body.startDate = c.options.startDate;
+        if (c.options.dueDate)
+            body.dueDate = c.options.dueDate;
+        if (c.options.estimatedHours)
+            body.estimatedHours = c.options.estimatedHours;
+        if (c.options.parentIssueId)
+            body.parentIssueId = c.options.parentIssueId;
+        const issue = await client.post('/issues', body);
+        return c.ok({
+            key: issue.issueKey,
+            summary: issue.summary,
+            status: issue.status.name,
+            priority: issue.priority.name,
+        }, { cta: { commands: [`backlog issue get ${issue.issueKey}`] } });
+    },
+});
+issueCli.command('update', {
+    description: '課題を更新',
+    args: z.object({
+        issueIdOrKey: z.string().describe('課題 ID または課題キー（例: PROJ-123）'),
+    }),
+    options: z.object({
+        summary: z.string().optional().describe('課題の件名'),
+        description: z.string().optional().describe('課題の詳細'),
+        statusId: z.coerce
+            .number()
+            .optional()
+            .describe('ステータス ID（1=未対応,2=処理中,3=処理済み,4=完了）'),
+        priorityId: z.coerce.number().optional().describe('優先度 ID（2=高,3=中,4=低）'),
+        assigneeId: z.coerce.number().optional().describe('担当者のユーザー ID'),
+        startDate: z.string().optional().describe('開始日（yyyy-MM-dd）'),
+        dueDate: z.string().optional().describe('期限日（yyyy-MM-dd）'),
+        estimatedHours: z.coerce.number().optional().describe('予定時間'),
+        actualHours: z.coerce.number().optional().describe('実績時間'),
+        comment: z.string().optional().describe('更新時のコメント'),
+        ...authOptions.shape,
+    }),
+    examples: [
+        { args: { issueIdOrKey: 'PROJ-123' }, options: { statusId: 2 }, description: 'ステータスを処理中に変更' },
+        { args: { issueIdOrKey: 'PROJ-123' }, options: { statusId: 4, comment: '対応完了' }, description: 'ステータスを完了にしてコメント追加' },
+        { args: { issueIdOrKey: 'PROJ-123' }, options: { summary: '新しいタイトル', dueDate: '2026-05-01' }, description: '件名と期限日を更新' },
+    ],
+    async run(c) {
+        const creds = resolveCredentials(c.options);
+        const client = createClient(creds.baseUrl, creds.apiKey);
+        const body = {};
+        if (c.options.summary)
+            body.summary = c.options.summary;
+        if (c.options.description)
+            body.description = c.options.description;
+        if (c.options.statusId)
+            body.statusId = c.options.statusId;
+        if (c.options.priorityId)
+            body.priorityId = c.options.priorityId;
+        if (c.options.assigneeId)
+            body.assigneeId = c.options.assigneeId;
+        if (c.options.startDate)
+            body.startDate = c.options.startDate;
+        if (c.options.dueDate)
+            body.dueDate = c.options.dueDate;
+        if (c.options.estimatedHours !== undefined)
+            body.estimatedHours = c.options.estimatedHours;
+        if (c.options.actualHours !== undefined)
+            body.actualHours = c.options.actualHours;
+        if (c.options.comment)
+            body.comment = c.options.comment;
+        const issue = await client.patch(`/issues/${c.args.issueIdOrKey}`, body);
+        return {
+            key: issue.issueKey,
+            summary: issue.summary,
+            status: issue.status.name,
+            updated: issue.updated,
+        };
+    },
+});
+issueCli.command('delete', {
+    description: '課題を削除',
+    args: z.object({
+        issueIdOrKey: z.string().describe('課題 ID または課題キー（例: PROJ-123）'),
+    }),
+    options: authOptions,
+    examples: [
+        { args: { issueIdOrKey: 'PROJ-123' }, description: '課題を完全削除（取り消し不可）' },
+    ],
+    async run(c) {
+        const creds = resolveCredentials(c.options);
+        const client = createClient(creds.baseUrl, creds.apiKey);
+        const issue = await client.delete(`/issues/${c.args.issueIdOrKey}`);
+        return { deleted: issue.issueKey };
+    },
+});
+issueCli.command('comments', {
+    description: '課題のコメント一覧を取得',
+    args: z.object({
+        issueIdOrKey: z.string().describe('課題 ID または課題キー（例: PROJ-123）'),
+    }),
+    options: z.object({
+        count: z.coerce.number().default(20).describe('取得件数（1〜200）'),
+        minId: z.coerce.number().optional().describe('最小コメント ID（この ID より大きいコメントを取得）'),
+        maxId: z.coerce.number().optional().describe('最大コメント ID（この ID より小さいコメントを取得）'),
+        order: z.enum(['asc', 'desc']).default('asc').describe('ソート順'),
+        ...authOptions.shape,
+    }),
+    examples: [
+        { args: { issueIdOrKey: 'PROJ-123' }, description: '課題のコメントを時系列順で取得' },
+        { args: { issueIdOrKey: 'PROJ-123' }, options: { order: 'desc' }, description: '最新コメントから取得' },
+    ],
+    async run(c) {
+        const creds = resolveCredentials(c.options);
+        const client = createClient(creds.baseUrl, creds.apiKey);
+        const params = {
+            count: c.options.count,
+            order: c.options.order,
+        };
+        if (c.options.minId !== undefined)
+            params.minId = c.options.minId;
+        if (c.options.maxId !== undefined)
+            params.maxId = c.options.maxId;
+        const comments = await client.get(`/issues/${c.args.issueIdOrKey}/comments`, params);
+        return {
+            count: comments.length,
+            comments: comments.map((cm) => ({
+                id: cm.id,
+                content: cm.content,
+                createdUser: cm.createdUser.name,
+                created: cm.created,
+                updated: cm.updated,
+            })),
+        };
+    },
+});
+issueCli.command('comment-add', {
+    description: '課題にコメントを追加',
+    args: z.object({
+        issueIdOrKey: z.string().describe('課題 ID または課題キー（例: PROJ-123）'),
+        content: z.string().describe('コメント本文'),
+    }),
+    options: authOptions,
+    examples: [
+        { args: { issueIdOrKey: 'PROJ-123', content: '対応完了しました。確認をお願いします。' }, description: '課題にコメントを追加' },
+    ],
+    async run(c) {
+        const creds = resolveCredentials(c.options);
+        const client = createClient(creds.baseUrl, creds.apiKey);
+        const comment = await client.post(`/issues/${c.args.issueIdOrKey}/comments`, { content: c.args.content });
+        return {
+            id: comment.id,
+            content: comment.content,
+            created: comment.created,
+        };
+    },
+});

package/dist/commands/profile.d.ts

@@ -0,0 +1,2 @@
+import { Cli } from 'incur';
+export declare const profileCli: Cli.Cli<{}, undefined, undefined>;

package/dist/commands/profile.js

@@ -0,0 +1,108 @@
+import { Cli, z } from 'incur';
+import { readConfig, writeConfig } from '../config.js';
+export const profileCli = Cli.create('profile', {
+    description: 'プロファイル管理（Backlog スペース接続情報）',
+});
+profileCli.command('list', {
+    description: '設定済みプロファイルの一覧を表示',
+    examples: [
+        { description: '登録済みプロファイルとデフォルトを確認' },
+    ],
+    run() {
+        const config = readConfig();
+        const profiles = Object.entries(config.profiles).map(([name, p]) => ({
+            name,
+            baseUrl: p.baseUrl,
+            projectKey: p.projectKey,
+            isDefault: name === config.default,
+        }));
+        return {
+            default: config.default ?? null,
+            profiles,
+        };
+    },
+});
+profileCli.command('add', {
+    description: 'プロファイルを追加・更新',
+    args: z.object({
+        name: z.string().describe('プロファイル名（例: work, personal）'),
+    }),
+    options: z.object({
+        url: z.string().describe('Backlog スペース URL（例: https://yourspace.backlog.com）'),
+        apiKey: z.string().describe('Backlog API キー'),
+        projectKey: z.string().describe('デフォルトプロジェクトキー（例: MYPROJECT）'),
+        default: z.boolean().optional().describe('このプロファイルをデフォルトに設定'),
+    }),
+    examples: [
+        {
+            args: { name: 'work' },
+            options: { url: 'https://yourspace.backlog.com', apiKey: 'YOUR_API_KEY', projectKey: 'MYPROJECT' },
+            description: 'work プロファイルを追加（初回登録時は自動でデフォルトになる）',
+        },
+        {
+            args: { name: 'personal' },
+            options: { url: 'https://myspace.backlog.jp', apiKey: 'ANOTHER_KEY', projectKey: 'MYPROJ', default: true },
+            description: 'personal プロファイルをデフォルトに設定しながら追加',
+        },
+    ],
+    run(c) {
+        const config = readConfig();
+        config.profiles[c.args.name] = {
+            baseUrl: c.options.url.replace(/\/$/, ''),
+            apiKey: c.options.apiKey,
+            projectKey: c.options.projectKey,
+        };
+        const isFirst = Object.keys(config.profiles).length === 1;
+        if (c.options.default || isFirst) {
+            config.default = c.args.name;
+        }
+        writeConfig(config);
+        return {
+            added: c.args.name,
+            isDefault: config.default === c.args.name,
+        };
+    },
+});
+profileCli.command('remove', {
+    description: 'プロファイルを削除',
+    args: z.object({
+        name: z.string().describe('削除するプロファイル名'),
+    }),
+    run(c) {
+        const config = readConfig();
+        if (!config.profiles[c.args.name]) {
+            return c.error({
+                code: 'PROFILE_NOT_FOUND',
+                message: `プロファイル "${c.args.name}" が見つかりません`,
+                retryable: false,
+                cta: { commands: ['backlog profile list'] },
+            });
+        }
+        delete config.profiles[c.args.name];
+        if (config.default === c.args.name) {
+            config.default = Object.keys(config.profiles)[0];
+        }
+        writeConfig(config);
+        return { removed: c.args.name, newDefault: config.default ?? null };
+    },
+});
+profileCli.command('use', {
+    description: 'デフォルトプロファイルを変更',
+    args: z.object({
+        name: z.string().describe('デフォルトに設定するプロファイル名'),
+    }),
+    run(c) {
+        const config = readConfig();
+        if (!config.profiles[c.args.name]) {
+            return c.error({
+                code: 'PROFILE_NOT_FOUND',
+                message: `プロファイル "${c.args.name}" が見つかりません`,
+                retryable: false,
+                cta: { commands: ['backlog profile list'] },
+            });
+        }
+        config.default = c.args.name;
+        writeConfig(config);
+        return { default: c.args.name };
+    },
+});

package/dist/commands/project.d.ts

@@ -0,0 +1,2 @@
+import { Cli } from 'incur';
+export declare const projectCli: Cli.Cli<{}, undefined, undefined>;

package/dist/commands/project.js

@@ -0,0 +1,62 @@
+import { Cli, z } from 'incur';
+import { createClient } from '../client.js';
+import { resolveCredentials } from '../config.js';
+import { authOptions } from '../shared.js';
+export const projectCli = Cli.create('project', {
+    description: 'プロジェクト操作',
+});
+projectCli.command('list', {
+    description: '参加しているプロジェクトの一覧を取得',
+    options: z.object({
+        archived: z.boolean().optional().describe('アーカイブ済みプロジェクトのみ取得'),
+        all: z.boolean().optional().describe('全プロジェクトを取得（管理者のみ）'),
+        ...authOptions.shape,
+    }),
+    examples: [
+        { description: 'アクティブなプロジェクト一覧' },
+        { options: { archived: true }, description: 'アーカイブ済みプロジェクト一覧' },
+    ],
+    async run(c) {
+        const creds = resolveCredentials(c.options);
+        const client = createClient(creds.baseUrl, creds.apiKey);
+        const params = {};
+        if (c.options.archived !== undefined)
+            params.archived = c.options.archived;
+        if (c.options.all !== undefined)
+            params.all = c.options.all;
+        const projects = await client.get('/projects', params);
+        return {
+            count: projects.length,
+            projects: projects.map((p) => ({
+                id: p.id,
+                key: p.projectKey,
+                name: p.name,
+                archived: p.archived,
+            })),
+        };
+    },
+});
+projectCli.command('get', {
+    description: 'プロジェクトの詳細を取得',
+    args: z.object({
+        projectIdOrKey: z.string().describe('プロジェクト ID またはプロジェクトキー'),
+    }),
+    options: authOptions,
+    examples: [
+        { args: { projectIdOrKey: 'MYPROJECT' }, description: 'プロジェクトキーで詳細取得' },
+    ],
+    async run(c) {
+        const creds = resolveCredentials(c.options);
+        const client = createClient(creds.baseUrl, creds.apiKey);
+        const project = await client.get(`/projects/${c.args.projectIdOrKey}`);
+        return {
+            id: project.id,
+            key: project.projectKey,
+            name: project.name,
+            archived: project.archived,
+            useWiki: project.useWiki,
+            useGit: project.useGit,
+            textFormattingRule: project.textFormattingRule,
+        };
+    },
+});

package/dist/commands/setup.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'incur';
+export declare const setupOptions: z.ZodObject<{
+    profile: z.ZodOptional<z.ZodString>;
+    url: z.ZodString;
+    apiKey: z.ZodString;
+    projectKey: z.ZodString;
+    default: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function runSetup(options: z.infer<typeof setupOptions>): {
+    saved: string;
+    isDefault: boolean;
+    hint: string;
+};

package/dist/commands/setup.js

@@ -0,0 +1,32 @@
+import { z } from 'incur';
+import { readConfig, writeConfig } from '../config.js';
+const DEFAULT_PROFILE_NAME = 'default';
+export const setupOptions = z.object({
+    profile: z
+        .string()
+        .optional()
+        .describe(`保存先プロファイル名（省略時: ${DEFAULT_PROFILE_NAME}）`),
+    url: z.string().describe('Backlog スペース URL（例: https://yourspace.backlog.com）'),
+    apiKey: z.string().describe('Backlog API キー'),
+    projectKey: z.string().describe('デフォルトプロジェクトキー（例: MYPROJECT）'),
+    default: z.boolean().optional().describe('このプロファイルをデフォルトに設定'),
+});
+export function runSetup(options) {
+    const config = readConfig();
+    const name = options.profile ?? DEFAULT_PROFILE_NAME;
+    config.profiles[name] = {
+        baseUrl: options.url.replace(/\/$/, ''),
+        apiKey: options.apiKey,
+        projectKey: options.projectKey,
+    };
+    const isFirst = Object.keys(config.profiles).length === 1;
+    if (options.default || isFirst || !config.default) {
+        config.default = name;
+    }
+    writeConfig(config);
+    return {
+        saved: name,
+        isDefault: config.default === name,
+        hint: '接続確認は `backlog whoami` を実行してください',
+    };
+}

package/dist/commands/whoami.d.ts

@@ -0,0 +1,13 @@
+export declare function loadWhoami(opts: {
+    profile?: string;
+    url?: string;
+    apiKey?: string;
+    projectKey?: string;
+}): Promise<{
+    id: number;
+    userId: string;
+    name: string;
+    mailAddress: string | null;
+    lang: string | null;
+    projectKey: string | null;
+}>;

package/dist/commands/whoami.js

@@ -0,0 +1,25 @@
+import { createClient } from '../client.js';
+import { readConfig } from '../config.js';
+export async function loadWhoami(opts) {
+    const config = readConfig();
+    const profileName = opts.profile ?? config.default;
+    const profileData = profileName ? config.profiles[profileName] : undefined;
+    const baseUrl = opts.url ?? profileData?.baseUrl ?? process.env.BACKLOG_BASE_URL;
+    const apiKey = opts.apiKey ?? profileData?.apiKey ?? process.env.BACKLOG_API_KEY;
+    if (!baseUrl) {
+        throw new Error('Backlog URL が未設定です。--url フラグ、プロファイル、または BACKLOG_BASE_URL 環境変数を設定してください。');
+    }
+    if (!apiKey) {
+        throw new Error('API キーが未設定です。--api-key フラグ、プロファイル、または BACKLOG_API_KEY 環境変数を設定してください。');
+    }
+    const client = createClient(baseUrl.replace(/\/$/, ''), apiKey);
+    const me = await client.get('/users/myself');
+    return {
+        id: me.id,
+        userId: me.userId,
+        name: me.name,
+        mailAddress: me.mailAddress ?? null,
+        lang: me.lang ?? null,
+        projectKey: opts.projectKey ?? profileData?.projectKey ?? process.env.BACKLOG_PROJECT_KEY ?? null,
+    };
+}

package/dist/config.d.ts

@@ -0,0 +1,29 @@
+export interface Profile {
+    baseUrl: string;
+    projectKey: string;
+    apiKey: string;
+}
+export interface Config {
+    default?: string;
+    profiles: Record<string, Profile>;
+}
+export interface Credentials {
+    baseUrl: string;
+    projectKey: string;
+    apiKey: string;
+}
+export interface ResolveOptions {
+    profile?: string;
+    url?: string;
+    apiKey?: string;
+    projectKey?: string;
+}
+export declare function readConfig(): Config;
+export declare function writeConfig(config: Config): void;
+/**
+ * 認証情報を以下の優先順位で解決する:
+ * 1. コマンドフラグ (--url / --api-key / --project-key)
+ * 2. 設定ファイルのプロファイル (--profile または default)
+ * 3. 環境変数 (BACKLOG_BASE_URL / BACKLOG_API_KEY / BACKLOG_PROJECT_KEY)
+ */
+export declare function resolveCredentials(opts: ResolveOptions): Credentials;

package/dist/config.js

@@ -0,0 +1,39 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+const CONFIG_PATH = join(homedir(), '.config', 'backlog-cli', 'config.json');
+export function readConfig() {
+    if (!existsSync(CONFIG_PATH))
+        return { profiles: {} };
+    try {
+        return JSON.parse(readFileSync(CONFIG_PATH, 'utf-8'));
+    }
+    catch {
+        return { profiles: {} };
+    }
+}
+export function writeConfig(config) {
+    mkdirSync(dirname(CONFIG_PATH), { recursive: true });
+    writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n');
+}
+/**
+ * 認証情報を以下の優先順位で解決する:
+ * 1. コマンドフラグ (--url / --api-key / --project-key)
+ * 2. 設定ファイルのプロファイル (--profile または default)
+ * 3. 環境変数 (BACKLOG_BASE_URL / BACKLOG_API_KEY / BACKLOG_PROJECT_KEY)
+ */
+export function resolveCredentials(opts) {
+    const config = readConfig();
+    const profileName = opts.profile ?? config.default;
+    const profileData = profileName ? config.profiles[profileName] : undefined;
+    const baseUrl = opts.url ?? profileData?.baseUrl ?? process.env.BACKLOG_BASE_URL;
+    const apiKey = opts.apiKey ?? profileData?.apiKey ?? process.env.BACKLOG_API_KEY;
+    const projectKey = opts.projectKey ?? profileData?.projectKey ?? process.env.BACKLOG_PROJECT_KEY;
+    if (!baseUrl)
+        throw new Error('Backlog URL が未設定です。--url フラグ、プロファイル、または BACKLOG_BASE_URL 環境変数を設定してください。');
+    if (!apiKey)
+        throw new Error('API キーが未設定です。--api-key フラグ、プロファイル、または BACKLOG_API_KEY 環境変数を設定してください。');
+    if (!projectKey)
+        throw new Error('プロジェクトキーが未設定です。--project-key フラグ、プロファイル、または BACKLOG_PROJECT_KEY 環境変数を設定してください。');
+    return { baseUrl: baseUrl.replace(/\/$/, ''), apiKey, projectKey };
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { Cli } from 'incur';
+declare const cli: Cli.Cli<{}, undefined, undefined>;
+export default cli;

package/dist/index.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import { Cli } from 'incur';
+import { issueCli } from './commands/issue.js';
+import { profileCli } from './commands/profile.js';
+import { projectCli } from './commands/project.js';
+import { runSetup, setupOptions } from './commands/setup.js';
+import { loadWhoami } from './commands/whoami.js';
+import { authOptions } from './shared.js';
+const cli = Cli.create('backlog', {
+    version: '0.1.0',
+    description: 'Backlog API CLI — setup/profile、課題・プロジェクト管理',
+});
+cli
+    .command('setup', {
+    description: '初回セットアップ向けにプロファイルを保存',
+    options: setupOptions,
+    run(c) {
+        return runSetup(c.options);
+    },
+})
+    .command('whoami', {
+    description: '認証ユーザー情報を取得',
+    options: authOptions,
+    async run(c) {
+        return loadWhoami(c.options);
+    },
+})
+    .command(issueCli)
+    .command(projectCli)
+    .command(profileCli)
+    .serve();
+export default cli;

package/dist/shared.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'incur';
+/** 全コマンド共通の認証オプション */
+export declare const authOptions: z.ZodObject<{
+    profile: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    projectKey: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/shared.js

@@ -0,0 +1,8 @@
+import { z } from 'incur';
+/** 全コマンド共通の認証オプション */
+export const authOptions = z.object({
+    profile: z.string().optional().describe('使用するプロファイル名'),
+    url: z.string().optional().describe('Backlog スペース URL（上書き）'),
+    apiKey: z.string().optional().describe('API キー（上書き）'),
+    projectKey: z.string().optional().describe('プロジェクトキー（上書き）'),
+});

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@niiiiiiile/iw-backlog-cli",
+  "version": "0.1.0",
+  "description": "CLI for Nulab Backlog issue and project management",
+  "type": "module",
+  "bin": {
+    "backlog": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    ".env.example"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "backlog",
+    "nulab",
+    "cli",
+    "issue",
+    "project-management"
+  ],
+  "author": "Teruaki Iwane",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Niiiiile/backlog-cli.git"
+  },
+  "homepage": "https://github.com/Niiiiile/backlog-cli#readme",
+  "bugs": {
+    "url": "https://github.com/Niiiiile/backlog-cli/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "incur": "^0.3.25"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0"
+  }
+}