From 2c05ae429694c8b1adc3de560bf3cf519c0a4c49 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Feb 2026 15:40:19 +0000 Subject: [PATCH 1/2] docs: create project README with cool CLI-style presentation Link to docs site for detailed reference instead of duplicating content. Highlight key features, show terminal demo, and keep it lean. https://claude.ai/code/session_01Gkt9Xe7MM39NbdPUwzvJCP --- README.md | 117 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 117 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..508b09f --- /dev/null +++ b/README.md @@ -0,0 +1,117 @@ +
+ +# backlog-cli + +[![CI](https://github.com/simochee/backlog-cli/actions/workflows/ci.yaml/badge.svg)](https://github.com/simochee/backlog-cli/actions/workflows/ci.yaml) +[![License: MIT](https://img.shields.io/github/license/simochee/backlog-cli)](./LICENSE) + +**Backlog on the command line.** + +ターミナルから離れずに [Backlog](https://backlog.com/) を操作する CLI ツール。 +
+課題、プルリクエスト、Wiki、通知 ── すべてをコマンドラインで。 + +[ドキュメント](https://simochee.github.io/backlog-cli) · [npm](https://www.npmjs.com/package/@simochee/backlog-cli) · [Issues](https://github.com/simochee/backlog-cli/issues) + +
+ +--- + +```bash +$ backlog issue list --project MYAPP --assignee @me +ID 種別 優先度 件名 +MYAPP-142 タスク 高 API レスポンスのキャッシュ戦略を検討する +MYAPP-138 バグ 中 ログイン画面でエラーメッセージが表示されない +MYAPP-135 タスク 低 依存パッケージのアップデート + +$ backlog issue view MYAPP-142 +MYAPP-142: API レスポンスのキャッシュ戦略を検討する +状態: 処理中 優先度: 高 担当者: @simochee + +$ backlog browse MYAPP-142 +# => ブラウザで課題を開く +``` + +## ハイライト + +- **99 コマンド** -- 課題、PR、Wiki、通知、Webhook まで Backlog API をフルカバー +- **柔軟な出力** -- テーブル / `--json` / `--jq` / `--template` でパイプラインに組み込める +- **対話 & 非対話** -- 引数を省略すればプロンプト、CI ではフラグ指定でそのまま動く +- **複数スペース** -- `backlog auth switch` でスペースを瞬時に切り替え +- **シェル補完** -- Bash / Zsh / Fish 対応 + +## インストール + +```bash +npm install -g @simochee/backlog-cli +``` + +> yarn / pnpm / bun でのインストールは[ドキュメント](https://simochee.github.io/backlog-cli/getting-started/installation/)を参照。 + +## セットアップ + +```bash +backlog auth login +``` + +ホスト名と認証方式を対話形式で設定。すぐに使い始められる。 + +```bash +backlog status +``` + +ダッシュボードが表示されれば準備完了。 + +> 認証方式やトークン管理の詳細は[認証ガイド](https://simochee.github.io/backlog-cli/guides/authentication/)へ。 + +## 使い方 + +```bash +# 課題を作成 +backlog issue create --project MYAPP --title "検索機能の実装" --type タスク --priority 高 + +# プルリクエストを確認してマージ +backlog pr view MYAPP/main-repo/1 +backlog pr merge MYAPP/main-repo/1 + +# 通知をチェック +backlog notification list + +# JSON で取得してパイプ +backlog issue list --project MYAPP --json key,summary | jq '.[].summary' + +# API を直接叩く +backlog api /api/v2/space +``` + +各コマンドの詳細は `backlog --help` または[コマンドリファレンス](https://simochee.github.io/backlog-cli/commands/issue/)で。 + +## ドキュメント + +**https://simochee.github.io/backlog-cli** + +- [クイックスタート](https://simochee.github.io/backlog-cli/getting-started/quickstart/) +- [出力形式](https://simochee.github.io/backlog-cli/guides/output-formatting/) +- [シェル補完](https://simochee.github.io/backlog-cli/guides/shell-completion/) +- [設定](https://simochee.github.io/backlog-cli/guides/configuration/) + +## コントリビュート + +```bash +git clone https://github.com/simochee/backlog-cli.git +cd backlog-cli +bun install +bun run dev +``` + +| コマンド | 内容 | +|---|---| +| `bun run dev` | 開発モードで実行 | +| `bun run build` | ビルド | +| `bun run test` | テスト実行 | +| `bun run lint` | Biome によるリント | +| `bun run type-check` | 型チェック | + +## ライセンス + +[MIT](./LICENSE) From daa4b4ac18b0a314cf4558a62f40de78e34571ed Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Feb 2026 15:46:14 +0000 Subject: [PATCH 2/2] docs: add npm version and downloads badges to README https://claude.ai/code/session_01Gkt9Xe7MM39NbdPUwzvJCP --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 508b09f..0952110 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,8 @@ # backlog-cli [![CI](https://github.com/simochee/backlog-cli/actions/workflows/ci.yaml/badge.svg)](https://github.com/simochee/backlog-cli/actions/workflows/ci.yaml) +[![npm version](https://img.shields.io/npm/v/@simochee/backlog-cli)](https://www.npmjs.com/package/@simochee/backlog-cli) +[![npm downloads](https://img.shields.io/npm/dm/@simochee/backlog-cli)](https://www.npmjs.com/package/@simochee/backlog-cli) [![License: MIT](https://img.shields.io/github/license/simochee/backlog-cli)](./LICENSE) **Backlog on the command line.**