入力に追いつく検索
課題のタイトル・本文・コメントとwikiページを、まとめて全文検索できます。検索はキャッシュの中だけで行うので、単語を打ち終える前に結果が返り、通信を待つ時間もありません。
gadak
Jiraの課題をSQLで集計する。
gadakは、指定した範囲のJiraとConfluenceをキャッシュするツールです。課題・コメント・変更履歴・wikiページをまとめて検索でき、SQLで集計できます。デスクトップアプリ、ブラウザー、CLIから使えて、画面は日本語表示に対応しています。接続できるのはJira CloudとServer / Data Centerです。
ライブデモ ブラウザーの中で534件の課題をそのまま開けます。インストールもアカウントも要りません。 インストール macOSはHomebrew、WindowsはMicrosoft Storeから入れます。LinuxはCLIを入れて、gadak serveでブラウザーから使います。
エピックごとの未完了件数を数える
JQLにGROUP BYはありません。
ページサイズを超えると、APIが返すのは行だけで、集計は自分で書くことになります。キャッシュがあれば、同じ答えをSQL 1本で出せます:
gadak sql "select epic_key, count(*) from issues_full where resolved_at is null
and epic_key <> '' group by epic_key order by 2 desc" デモデータでこのSQLを試す（Datasette Lite、インストール不要）→
2026-08-26に課題3,296件のサイトで計測したところ、REST APIの結果を8ページ取得して集計する処理は4,761 ms、同期済みのキャッシュに対するgadakのSQLは22 msでした。数値は中央値で、gadak側はCLIの起動時間を含みます。
計測条件と制約
REST APIとキャッシュの応答時間
| Jira REST API | gadak | ||
|---|---|---|---|
| 全文検索 | 543 ms | 41 ms | 13× |
| エピックごとの未完了件数（GROUP BY） | 4,761 ms | 22 ms | 214× |
上と同じ、2026-08-26の計測です。エピックごとの未完了件数は、REST API側が8ページを取得して集計した値、gadak側はクエリ1本の値です。gadakが負ける行もあります。このサイトの初回フル同期には3.7分かかり（2026-09-09計測）、キャッシュは同期間隔1回ぶん遅れます。計測方法と再計測の履歴は次にまとめています: docs/BENCHMARKS.md.
課題とwikiをまとめて検索する
導入前に確認したいこと
何を写し、どこに置き、何が外に出るのか
- 接続先。Atlassian CloudはAPIトークンで、Jira Server / Data Centerは
gadak init --serverと個人アクセストークンで接続します。Cloudはトークン1つで同じサイトのJiraとConfluenceの両方を写します。Confluence Serverはクライアントがないため、Serverのワークスペースが写すのは課題だけです。 - 写す範囲。
--projectsで挙げたプロジェクトを、自分のアカウントで見えるぶんだけ写します。--spacesでスペースを指定するまでwikiには触れません。 - 置き場所と新しさ。使っているマシンの中のSQLiteファイル1つです。初回はフル同期が要り、その後の読み取りは直近の同期時点の内容になります。消しても失うものはなく、もう一度同期すれば元に戻ります。
- 外に出るもの。テレメトリも、解析も、gadakのアカウントもありません。接続するのは自分で設定した先だけで、読み取りはそのファイルから行います。接続先に訊くのは4つだけです。添付ファイルの表示、
gadak issue --editmeta、gadak fields、gadak api。 - トークンの置き場所。
~/.gadak/config.jsonにパーミッション0600で置き、送る先は自分のサイトだけです。キャッシュにもログにもスナップショットにも書き込まれません。 - 書き込みの流れ。先にJiraへ届き、Jiraが受け付けてからキャッシュが更新されます。届かなかった書き込みはその場で失敗として返り、キャッシュに溜まることはありません。
- エージェントを使うとき。キャッシュを読んだエージェントは、読んだ内容を自分のモデルへ送ります。gadak自体はどこにも送りません。エージェントに見せてよい範囲だけを写してください。
インストールと初回同期
インストール
デスクトップアプリ（CLI同梱）:
brew install --cask midagedev/tap/gadakCLIのみ:
brew install midagedev/tap/gadak-cliWindowsのデスクトップアプリはMicrosoft Storeからインストールできます。
チームのJira Cloudサイトに接続します。サイト、メールアドレス、APIトークン、写すプロジェクトを順に聞かれます。wikiも同期するなら--spacesを付けます:
gadak init && gadak serve コーディングエージェントから使う
エージェントから課題を操作する
スキルを1つ入れると、Claude CodeがgadakのCLIで課題を検索し、作成し、ステータスを変更します。その結果は同じボードで確認できます。スキルには、日本語のアカウントで引っかかりやすい落とし穴も書いてあります。ステータスと優先度の表示名は、Jiraがアカウントの言語ごとに翻訳するので、英語の名前で問い合わせるとエラーも出ないまま0行が返り、エージェントはそれを「該当する課題はない」と読みます。エージェントが書いたコメントと作成した課題には、そのエージェントの名前が付きます。
Claude Codeにスキルを入れます:
gadak skill installClaude DesktopにはMCPサーバーを登録します:
gadak mcp install claude-desktop ホストごとの設定→ docs/AGENT_SETUP.md
ほかの録画:ダッシュボード、チームのテーマ、ランチャー、MCPのライブセッション→ docs/SHOWCASE.md
モバイルアプリ
同じキャッシュを、電話でも ベータ
iOSアプリは、すでに動かしているgadak serveとペアリングします。自分のネットワークの中で完結し、あいだにアカウントも他社のサーバーも入りません。キャッシュにあるものは電話にも出ます—フィールド、添付、リンクされた課題、ウィキ、進行中のスプリントとその前後。一行で済む変更は電話で終わります。コメント、ラベル、期限、写真、エピック配下の新規課題。書き込みはデスクトップと同じく接続先を先に通ります。ページやカスタムフィールドの編集、ビューの作成、ダッシュボードの配置、カードの移動はデスクトップの仕事で、アプリはそのコントロールがある場所でそう伝えます。
ベータで、状態はそれがすべてです。ビルドは内部テスター向けのTestFlightにのみ配られ、一般向けのダウンロードはありません。App Storeへの掲載は、審査者がこちらのネットワークに入らずにアプリを確認できる経路が先です。
開発状況
対応範囲と開発状況
- 状態: 0.24、まだ0.xです。同期、読み取りAPI、書き込み、デスクトップアプリ、ウェブ、CLI、MCPは、実際のサイトで検証しています。
- メンテナーは現在1人で、ライセンスはApache-2.0です。キャッシュはただのSQLiteファイルなので、gadakがなくなっても、どのSQLiteクライアントからでも開けます。
- スプリント計画、管理作業、アプリの画面でのページ編集、1分の遅れが問題になる作業は、Jira側で続けてください。
- Atlassian Cloud、Jira Server / Data Center、Linear、内蔵トラッカーを共通のコマンドで操作できます。接続先ごとの対応状況は、セルごとに実際に実行して1枚の表にまとめています。
接続先ごとの対応状況 · よくある質問 · 保守の方針 · GitHub
フィードバック
試した結果を教えてください
何に使って、その後も使っているかを教えてください。うまくいかなかった話や、導入を見送った理由も歓迎します。
実際の課題データ、APIトークン、サイトURLは載せないでください。