GitInflow ユーザーマニュアル

GitInflow は GitHub Issue をカンバン方式で管理する iOS クライアントアプリです。このマニュアルでは全機能を詳しく説明します。

はじめに

リポジトリを選択する

ログイン後、設定タブ（歯車アイコン）を開きます。
リポジトリをタップして選択します。選択済みのリポジトリにはチェックマークが表示されます。
最大 5 つのリポジトリ を同時に選択できます。

デフォルトリポジトリを設定する

設定タブでリポジトリの横にある星アイコンをタップすると、そのリポジトリをデフォルトに設定できます。デフォルトリポジトリは次の場面で使用されます:

+ ボタンから新規 Issue を作成するとき
Share Extension でリポジトリを手動選択しないとき

カンバンタブ

GitInflow では、Issue を 4 つのステータス列（タブ）で管理します:

タブ	説明	GitHub ラベル
Backlog	ステータスラベルがない Issue — 新しい作業の受け口	(なし)
Ready	トリアージ済みで作業開始可能な Issue	`status:ready`
In Progress	現在作業中の Issue	`status:inProgress`
Done	完了した Issue — GitHub 上で自動クローズ	`status:done`

タブをタップして切り替えます。各タブには、選択したリポジトリのうち該当ステータスの Issue のみが表示されます。

ステータス変更

Issue のステータスを変更する方法は 4 つあります。

左スワイプ — ラベル追加 / 進める

Issue カードを左にスワイプするとクイックアクションが表示されます:

ラベル — ラベルピッカーシートを開く
マイルストーン — マイルストーンピッカーシートを開く
進める（Advance） — 次のステータスに移動（例: Backlog → Ready → In Progress → Done）

右スワイプ — 戻す / コメント

Issue カードを右にスワイプすると以下が表示されます:

戻す（Retreat） — 前のステータスに戻す（例: In Progress → Ready）
コメント — コメント入力シートを開く

コンテキストメニュー（長押し）

Issue カードを長押しするとコンテキストメニューが表示され、すべてのステータスオプションを選べます。何度もスワイプせずに任意のステータスへ直接ジャンプできます。

Issue 詳細ボタン

Issue をタップしてIssue 詳細画面を開きます。画面下部に Advance（進める）と Retreat（戻す）ボタンが表示されます。

検索

各カンバンタブの上部に検索バーがあります。タップするとそのタブの Issue をキーワードで絞り込めます。

Issue のタイトルが検索対象です。
検索はローカルで実行され（追加のネットワーク通信なし）、入力と同時にリアルタイムで更新されます。
検索バーを空にすると全件表示に戻ります。

リポジトリフィルター

設定で 2 つ以上のリポジトリを選択している場合、カンバン画面のタブバー下にフィルターチップの行が表示されます。

チップをタップすると、そのリポジトリの Issue のみ表示されます。
一番左の すべて（All） をタップすると、全選択リポジトリの Issue が表示されます。
フィルターは現在のタブにのみ適用されます。タブを切り替えてもフィルター選択は維持されます。

Issue 作成

任意のカンバンタブを開きます（+ ボタンは右上に常に表示されています）。
+ をタップします。
複数のリポジトリを選択している場合、リポジトリピッカーが表示されます — 投入先を選んでください。デフォルトリポジトリが設定されている場合は自動的に選択されます。
タイトル（必須）と任意の本文を入力します。
Submit をタップして GitHub に Issue を作成します。新しい Issue は Backlog タブに表示されます。

Issue 詳細

Issue カードをタップして詳細画面を開きます。詳細画面には以下が表示されます:

タイトル — Issue のタイトルと番号
ステータスバッジ — 現在のカンバンステータス（Backlog / Ready / In Progress / Done）
ラベル — Issue に付与されたすべてのラベル
マイルストーン — 割り当てられたマイルストーン（ある場合）
本文 — Issue の説明（プレーンテキストで表示）
コメント — 時系列順のすべてのコメント
ステータス変更ボタン — 画面下部の Advance と Retreat ボタン

詳細画面からは以下の操作が可能です:

Issue の説明と全コメントを読む
Advance / Retreat ボタンでステータスを変更する
コメントを追加する（コメントを参照）

ラベルとマイルストーン

スワイプでラベルを追加する

Issue カードを左にスワイプします。
ラベル アクションをタップします。
そのリポジトリのすべてのラベルが表示されるピッカーシートが開きます。
ラベルをタップしてオン / オフを切り替えます。
完了をタップして適用します。

スワイプでマイルストーンを追加する

Issue カードを左にスワイプします。
マイルストーン アクションをタップします。
リポジトリのオープンなマイルストーンが表示されるピッカーシートが開きます。
マイルストーンをタップして割り当てるか、なしをタップして現在のマイルストーンを解除します。
完了をタップして適用します。

注意: ラベルとマイルストーンは GitHub から取得されます。GitHub.com または GitHub アプリで事前に作成しておく必要があります。

スワイプでコメントを追加する

Issue カードを右にスワイプします。
コメント アクションをタップします。
コメント入力シートが開きます。コメントを入力します。
投稿をタップして送信します。

Issue 詳細からコメントを追加する

Issue をタップして詳細画面を開きます。
コメント一覧の一番下までスクロールします。
コメントを追加 フィールドをタップします。
コメントを入力して投稿をタップします。

Share Extension を使うと、ブラウザ・メモ・Safari など任意のアプリから GitHub Issue を直接作成・更新できます。

Share Extension を起動する

任意のアプリで共有ボタン（矢印の出た四角）をタップします。
共有シートをスクロールして GitInflow Share をタップします。表示されない場合は その他 をタップして有効にしてください。

新規 Issue モード

Share Extension でモードピッカーから 新規 Issue を選択します。
リポジトリを選択します（デフォルトリポジトリが事前選択されます）。
共有したコンテンツ（URL・選択テキスト・画像）が本文に自動入力されます。
タイトルと本文を必要に応じて編集します。
作成をタップして Issue を投稿します。

既存 Issue に追記モード

モードピッカーから 既存に追記 を選択します。
リポジトリを選択します。
そのリポジトリのオープンな Issue 一覧が表示されます — 追記したい Issue をタップします。
共有コンテンツがコメントとして自動入力されます。
投稿をタップしてコメントを追加します。

すべてのリポジトリを表示トグル

Share Extension はデフォルトでデフォルトリポジトリのみ表示します。「すべてのリポジトリを表示」 トグルを有効にすると、選択中のすべてのリポジトリから選べるようになります。

Share Extension のデフォルトリポジトリ

設定で指定したデフォルトリポジトリが Share Extension でも事前選択されるため、ワンタップで Issue 作成が可能です。

Pull Requests タブ

下部ナビゲーションバーの PRs タブをタップすると、選択中のリポジトリのオープンな Pull Request が一覧表示されます。

各行に PR のタイトル、リポジトリ、作成者が表示されます。
PR をタップすると Safari で GitHub のページが開きます。
複数リポジトリを選択中の場合、リポジトリフィルターチップ（カンバン画面と同じ）でリポジトリを絞り込めます。

Pull Request の操作（レビュー・マージ等）は GitInflow では行えません。GitHub.com または GitHub アプリをご利用ください。

GitInflow はホーム画面ウィジェットを提供しており、Issue の件数を一目で確認できます。

ウィジェットのサイズ

サイズ	表示内容
Small	In Progress の Issue 件数
Medium	全 4 ステータスの件数: Backlog / Ready / In Progress / Done

ウィジェットを追加する

ホーム画面の空いている場所を長押しします。
左上の + をタップしてウィジェットギャラリーを開きます。
GitInflow を検索します。
Small または Medium を選択します。
ウィジェットを追加 をタップして配置します。

ウィジェットの動作

ウィジェットは iOS が管理するスケジュールに従ってバックグラウンドで定期的に更新されます。
ウィジェットをタップすると GitInflow のカンバン画面が開きます。

通知

GitInflow は選択中のリポジトリに新しい Issue が追加されたとき、ローカル通知を送信できます。

通知は GitInflow が Issue データを更新したとき（フォアグラウンド・バックグラウンド問わず）に生成されます。
前回の更新時に存在しなかった新しい Issue が通知をトリガーします。
通知をタップすると、該当の Issue が表示された状態で GitInflow が開きます。

通知を有効にする

初回起動時に iOS が通知許可を求めます。拒否した場合は iOS 設定 → GitInflow → 通知 で有効にしてください。

設定

設定タブ（歯車アイコン）で以下を管理できます。

リポジトリ選択

リポジトリをタップして選択 / 解除します。
チェックマークが選択中を示します。
最大 5 つのリポジトリ を選択できます。

デフォルトリポジトリ

リポジトリ横の星アイコンをタップしてデフォルトに設定します。
設定済みの星は塗りつぶし / 黄色になります。
デフォルトは 1 つだけ設定できます。

プライバシーポリシー

設定画面にプライバシーポリシーへのリンクがあります。

ログアウト

設定画面下部の ログアウト をタップすると GitHub アカウントからサインアウトします。ログアウト時にローカルキャッシュはすべて削除されます。

エラー対応

リポジトリ読み込みエラーバナー

ネットワークエラーやアクセス権の失効などにより Issue を読み込めない場合、カンバン画面の上部に赤いエラーバナーが表示され、どのリポジトリで問題が発生しているかを示します。

再試行ボタン

エラーバナーの再試行ボタンをタップすると、問題のあったリポジトリから Issue を即座に再取得します。問題が続く場合はインターネット接続を確認するか、GitHub トークンが対象リポジトリへのアクセス権を持っているか確認してください（必要に応じて再ログイン）。

よくある質問（FAQ）

リポジトリは何個まで選択できますか？

設定で最大 5 つのリポジトリを同時に選択できます。

「Done」ステータスにすると GitHub ではどうなりますか？

Done に移動すると、GitInflow は status:done ラベルを付与して GitHub 上の Issue をクローズします。他のステータスに戻すと Issue は再オープンされます。

プライベートリポジトリでも使えますか？

はい。GitInflow はログイン時に認可した GitHub OAuth トークンを使用するため、プライベートリポジトリも公開リポジトリと同様に設定画面に表示されます。

Share Extension が表示されません。どうすればいいですか？

共有シートで その他（または編集）をタップし、リストの中から「GitInflow Share」を見つけて有効にしてください。

ラベルやマイルストーンが表示されないのはなぜですか？

ラベルとマイルストーンは GitHub から取得されます。リポジトリに対象のラベル・マイルストーンが存在するか、またネットワーク接続があるかを確認してください。

ウィジェットが更新されないのはなぜですか？

iOS のウィジェットは OS が管理するスケジュールで更新されます。GitInflow を一度起動してデータを更新すると、ウィジェットもまもなく反映されます。

ウィジェットに表示されるリポジトリを変えるには？

ウィジェットは設定で選択したリポジトリを反映します。設定でリポジトリを追加・削除すると、次の更新タイミングでウィジェットに反映されます。

誤って Done に移動してしまいました。元に戻せますか？

Done タブで Issue カードを右にスワイプして 戻す（Retreat） をタップするか、カードを長押ししてコンテキストメニューからステータスを選択してください。status:done ラベルが削除され、GitHub 上の Issue が再オープンされます。

GitInflow