{"id":49941298,"url":"https://github.com/ozzy-labs/gh-tasks","last_synced_at":"2026-05-17T11:11:32.238Z","repository":{"id":355775054,"uuid":"1225051568","full_name":"ozzy-labs/gh-tasks","owner":"ozzy-labs","description":"GitHub CLI extension and skill bundle to manage tasks across GitHub Projects v2, Issues, and Milestones — for personal todos, single-project work, and cross-project coordination. Distributed for Claude Code, Codex CLI, GitHub Copilot, and Gemini CLI.","archived":false,"fork":false,"pushed_at":"2026-05-17T06:47:43.000Z","size":2008,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-17T08:34:49.949Z","etag":null,"topics":["ai-agents","claude-code","gh-extension","github-cli-extension","github-copilot","github-projects","ozzylabs","tasks"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ozzy-labs.png","metadata":{"files":{"readme":"README.ja.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-29T22:38:18.000Z","updated_at":"2026-05-17T06:47:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ozzy-labs/gh-tasks","commit_stats":null,"previous_names":["ozzy-labs/gh-tasks"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ozzy-labs/gh-tasks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozzy-labs%2Fgh-tasks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozzy-labs%2Fgh-tasks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozzy-labs%2Fgh-tasks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozzy-labs%2Fgh-tasks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ozzy-labs","download_url":"https://codeload.github.com/ozzy-labs/gh-tasks/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozzy-labs%2Fgh-tasks/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33136163,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T09:28:26.183Z","status":"ssl_error","status_checked_at":"2026-05-17T09:27:52.702Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","claude-code","gh-extension","github-cli-extension","github-copilot","github-projects","ozzylabs","tasks"],"created_at":"2026-05-17T11:11:08.752Z","updated_at":"2026-05-17T11:11:32.219Z","avatar_url":"https://github.com/ozzy-labs.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[English](README.md) | 日本語\n\n# gh-tasks\n\nGitHub Projects v2 / Issues / Milestone を横断するタスク管理のための GitHub CLI extension + skill bundle。個人 todo、単体プロジェクト、プロジェクト横断調整の 3 用途を 1 つの抽象でカバーする。\n\n`gh tasks` は 3 スコープ(`repo` / `org` / `user`)を統一的に扱うため、同じコマンドが個人タスク、単体リポのバックログ、共有 Project v2 によるプロジェクト横断調整いずれにも使える。\n\n本 CLI は Projects v2 アクセスを単一バイナリ + skill bundle に集約し、agent adapter 機構経由で Claude Code / Codex CLI / GitHub Copilot / Gemini CLI 向けに skill を配布する。\n\n## ステータス\n\nv0.1.0 — feature-complete。下記 CLI コマンドおよび skill は 3 スコープ(`repo` / `org` / `user`)すべてで実装・テスト済み。リリースは release-please で管理する。repo 内の判断は [docs/adr/](docs/adr/)、ユーザーマニュアルは [docs/manual/ja/](docs/manual/ja/) を参照。\n\n## インストール\n\n```bash\ngh extension install ozzy-labs/gh-tasks\n```\n\n短縮 alias(任意):\n\n```bash\ngh alias set task tasks\n```\n\n認証は `gh auth login` で取得済のトークンを extension が継承する(追加の認証導線なし)。\n\n## CLI コマンド\n\n| コマンド | 用途 |\n| --- | --- |\n| `gh tasks add \u003ctitle\u003e` | Issue / Project draft item の追加(`--scope repo\\|org\\|user`、`--repo \u003cname\u003e`、`--project \u003cid\u003e`) |\n| `gh tasks list` | 一覧表示(`--scope` でスコープ切替、`--limit \u003cN\u003e` 既定 30) |\n| `gh tasks today` | 今日の予定 / 期日のタスクを表示 |\n| `gh tasks plan [--period daily\\|weekly\\|sprint] [--write]` | 週次 / イテレーション計画(repo は Milestone、org/user は Iteration)。デフォルトは preview、`--write` で適用 |\n| `gh tasks triage [--limit \u003cN\u003e]` | 未トリアージ Issue / draft の整理(既定 20) |\n| `gh tasks done \u003cid\u003e` | 完了化(repo: Issue close、org/user: Status → Done) |\n| `gh tasks review [--period daily\\|weekly\\|sprint]` | 振り返り |\n| `gh tasks standup [--mine] [--since \u003ciso8601\u003e]` | 個人 / チーム活動サマリ(既定 直近 24h) |\n| `gh tasks link \u003cpr\u003e \u003ctask\u003e` | PR と Issue / Project 項目の紐付け |\n| `gh tasks projects init [yaml-path]` | yaml テンプレートから Project v2 を bootstrap(`--template`、`--owner`、`--title`、`--dry-run`) |\n| `gh tasks projects init-templates` | 同梱の `user` / `org` テンプレート yaml を出力 |\n\n`--scope` の解決順は「明示の `--scope` フラグ → 作業ディレクトリの git remote(`origin` があれば `repo`)→ `~/.config/ozzylabs/gh-tasks.toml` の `default_scope` → `user`」。フラグの詳細は [docs/manual/ja/reference/cli.md](docs/manual/ja/reference/cli.md) を参照。\n\n## 構造化出力\n\n全コマンド(read 系と mutation 系: `add` / `done` / `link` / `plan --write` / `projects init` / `init-templates`)が `--json [fields]` / `--jq \u003cquery\u003e` を受け付け、シェルスクリプト・エージェント・`jq` / `yq` への接続が容易。`--json` は tab 補完対応、`--paginate` で read 系コマンドの全件取得も可能。\n\n```bash\n# 利用可能フィールドを一覧表示(空値)\ngh tasks list --json=\n\n# 指定フィールドの JSON 配列(state OPEN / CLOSED / MERGED もカタログに含まれる)\ngh tasks list --json id,number,state,title\n\n# 内蔵 jq フィルタ(Pure Go の gojq、外部依存なし)\ngh tasks list --json id --jq '.[].id'\n\n# 作成した Issue の id を後続コマンドで使う\nissue_id=$(gh tasks add \"Bug: /api/foo が 404\" --json id --jq '.[0].id')\n\n# 既定の取得上限を超えて全件取得\ngh tasks list --paginate --json id\n\n# close 済 Issue の state を script で確認\ngh tasks done 42 --json state --jq '.[0].state'\n# \"CLOSED\"\n```\n\n`stdout` は JSON 専用。警告と localized エラーは `stderr` に出る。出力はロケール非依存(フィールド名は英語、値は GitHub 実体値)なので、`--lang en` でも `--lang ja` でも script の挙動が変わらない。詳細は [docs/manual/ja/reference/json-output.md](docs/manual/ja/reference/json-output.md) を参照。\n\n## Skills\n\n| Skill | 用途 |\n| --- | --- |\n| `task-add` | 会話文脈からタスク化 |\n| `task-plan` | 日次 / 週次 / スプリント計画 |\n| `task-triage` | inbox triage |\n| `task-review` | daily / weekly retrospective |\n| `task-standup` | 活動サマリ |\n| `task-link-pr` | PR と項目の紐付け |\n\nskill は Claude Code / Codex CLI / GitHub Copilot / Gemini CLI 向けに配布される。配置経路は 2 通り:\n\n### ワンショット install(推奨)\n\n```bash\ncd /path/to/your-repo\ngh tasks install-skills\n```\n\nリポ内に存在するエージェント痕跡(`.claude/` / `AGENTS.md` / `.gemini/` / `.github/copilot-instructions.md`)を auto-detect して該当ファイルを配置する。冪等で、再実行時は adapter ごとの manifest を見て差分のみ更新する。\n\n主なフラグ:\n\n- `--agent claude-code,codex-cli` — auto-detect ではなく指定 agent のみ\n- `--namespace gh-tasks` — 衝突回避用の rename install(`task-add` → `gh-tasks-add`)\n- `--force` — 非管理の既存ファイルを `\u003cpath\u003e.bak` に退避して上書き\n- `--dry-run` — 実行予定のアクションのみ表示\n- `--check` — on-disk が SSOT と乖離していれば非ゼロ終了(CI dogfooding 用)\n- `--uninstall` — manifest 記載のファイルを削除。共有集約ファイル(`AGENTS.md` / `.gemini/settings.json` / `.github/copilot-instructions.md`)は adapter 間で reference count される\n\n### Renovate auto-sync(自動更新派向け)\n\nskill の更新を Renovate 経路で取り込みたい場合は、adapter sub-preset を extend する:\n\n```jsonc\n{\n  \"$schema\": \"https://docs.renovatebot.com/renovate-schema.json\",\n  \"extends\": [\n    \"github\u003eozzy-labs/gh-tasks//configs/skills-sync/claude-code\",\n    \"github\u003eozzy-labs/gh-tasks//configs/skills-sync/codex-cli\"\n  ]\n}\n```\n\n詳細(全 adapter preset 一覧、`gh_tasks_commit:` を `@ozzylabs/skills` と並走で tracking する仕組み)は [`configs/skills-sync/README.md`](configs/skills-sync/README.md)。\n\n両経路は配置先と marker tag を共有するため相互運用可能で、片方から他方へ切り替えても spurious な差分は出ない。\n\n## スコープ対応\n\n| Scope | 用途 | データ源 |\n| --- | --- | --- |\n| `repo` | 単体プロジェクトの実装作業 | Issues + Milestones |\n| `org` | プロジェクト横断調整 | Organization Project v2 |\n| `user` | 個人 todo / 日次計画 | 個人 Project v2 |\n\n## 規約\n\n- **コミット**: [Conventional Commits](https://www.conventionalcommits.org/)\n- **ブランチ**: GitHub Flow + squash merge のみ\n- **ブランチ命名**: `\u003ctype\u003e/\u003cshort-description\u003e`\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fozzy-labs%2Fgh-tasks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fozzy-labs%2Fgh-tasks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fozzy-labs%2Fgh-tasks/lists"}