GitHub Actionsをスマホから手動実行する方法を比較|公式アプリ・ショートカット・専用アプリ
この記事は、iPhoneアプリ「Pocket Actions」の開発者が書いています。自社アプリも比較に入れていますが、ほかの方法が向いているケースもそのまま書きました。他社アプリの情報は、App Storeの掲載内容と公式ドキュメント(リンク先)にもとづいています。掲載に書かれていない機能は「記載なし」としています。
「できる」のに、スマホから動かすのが面倒
GitHub Actionsを、CI/CDだけでなく「スクリプトを動かすボタン」として使う人が増えています。再デプロイ、データの更新、レポートの作成、AIに書いてもらった自動化。workflow_dispatch を付けておけば、好きなときに手動で実行できます。
困るのは、実行したいのがPCの前にいないときだという点です。
- 外出先でバグ報告を受けて、とりあえず再デプロイしたい
- 寝る前に、時間のかかるバッチを回しておきたい
- AIのジョブを、次の定期実行を待たずに今すぐ動かしたい
公式のGitHubアプリでも手動実行はできます。それでも、何度も繰り返していると「リポジトリ → Actions → ワークフロー → Run workflow」という道のりの長さが気になってきます。
ここで大事なのは、できないから不便なのではないという点です。公式アプリはプルリクエストや通知、実行状況の確認に強い一方、「特定のワークフローを短い手順で何度も実行する」使い方では、道のりの長さが負担になりやすいのです。負担が大きいと「あとでPCでやろう」と後回しになり、手動実行を避けるために定期実行(cron)を増やしすぎる、ということも起きがちです。
この記事では、スマホから手動実行する7つの方法を、同じ基準で比べます。
選び方の基準は3つ
1. 実行までの手順(タップ数)
月に1回なら長い手順でも構いません。週に何度も同じワークフローを実行するなら、機能の多さより手順の短さが効いてきます。公式アプリの場合、目安は「アプリ → リポジトリ → Actions → Workflows → 対象のワークフロー → Run workflow →(入力)→ 確定」です。
2. 準備と、渡す認証情報
- GitHubにログインする(公式アプリ、ブラウザ)
- Personal Access Token(PAT)をアプリに貼る(サードパーティ製アプリ)
- 自分で作るものにトークンを埋め込む(iOSショートカット)
どれを選んでも、権限は最小限にし、有効期限を付け、失効させる手順を知っておくことが前提です。
3. 実行したあとに何が見えるか
実行を見る(状況・ログ・通知・再実行)のが得意な道具と、実行を始めるのが得意な道具があります。結果をスマホで確かめたいなら、始めるだけの道具では足りません。
7つの方法の比較表
表は横にスクロールできます
| 方法 | workflow_dispatchを実行できるか | 入力(inputs) | ログ・状況 | 準備 | 価格(App Store) |
|---|---|---|---|---|---|
| GitHub公式アプリ | できる(2024年7月から) | 対応 | 見られる・プッシュ通知あり | GitHubにログイン | 無料 |
| ブラウザでGitHub.com | できる | 対応 | 見られる | ログイン | 無料 |
| iOSショートカット+REST API | できる | 自作すれば対応 | 自作しない限りなし | ワークフローごとに作る。トークンはショートカットの中 | 無料 |
| Acts – Actions Client | 対応の記載なし※ | — | 見られる(進行状況・ログ・再実行・キャンセル) | アプリごと | 無料(米国ストア) |
| GitFlow for GitHub Actions | できる(掲載情報) | 対応(ブランチも選べる) | 見られる(ダッシュボード・ログ・再実行・デプロイ承認) | アプリごと | 無料(米国ストア) |
| GitHub Actions Widget | できない(状況表示のみ。タップでGitHubが開く) | — | 最新の状況をホーム画面・ロック画面に表示 | アプリごと | $2.99(米国ストア) |
| Pocket Actions | 1〜3タップでできる。GASも実行できる | 入力フォームを自動で作る | 見られない(受け付けの確認のみ) | PATを貼る(repo) | 無料(1日5回・週17回まで)、プレミアム 月額¥380/買い切り¥5,980 |
※ ActsはApp Storeの説明に実行の記載がなく、公開ソースコードにも実行APIの呼び出しがありません(App Store版が異なる可能性はあります)。GitFlowは説明に実行対応が明記されています。 出典:GitHub公式アプリ、GitHub Changelog、Acts、GitFlow、GitHub Actions Widget
それぞれの長所と短所
1. GitHub公式アプリ
2024年7月から、Workflowの画面(リポジトリ → Actions → Workflows)で workflow_dispatch を手動実行できるようになりました(GitHub Changelog)。実行状況やログの確認、完了時のプッシュ通知(失敗時だけにもできます)、再実行やキャンセルにも対応しています(GitHub Blog)。
- 長所:公式で無料。トークン不要。「実行 → 見守る → 通知 → 再実行」まで1つで完結します。
- 短所:実行ボタンまでの階層が深く、リポジトリごとに同じ手順を踏みます。リポジトリが多いと移動が増えます。
- 向いている人:たまに実行し、結果もスマホで確かめたい人。1つだけ選ぶなら、まずはこれです。
2. ブラウザでGitHub.comを開く
- 長所:インストール不要で、すべての機能が使えます。
- 短所:PC向けの画面なのでボタンが小さく、ログインや二段階認証が急いでいるときの壁になります。
- 向いている人:まれな操作や、アプリが対応していない操作をしたいとき。
3. iOSショートカット+REST API
ショートカットの「URLの内容を取得」で POST /repos/{owner}/{repo}/actions/workflows/{workflow}/dispatches を呼び出し、本文に {"ref":"main","inputs":{...}} を渡します(island94.org の解説)。
- 長所:無料。ホーム画面やSiri、オートメーションから起動でき、入力を尋ねることもできます。
- 短所:ショートカットはiOSのキーチェーンを読めないため、トークンをショートカットに直接書くのが一般的です(解説)。ワークフローごとに作って保守する必要があり、実行状況も自分で作らないと見られません。
- 向いている人:ワークフローが1〜2本で、自分で組むのが苦にならない人。
4. Acts – Actions Client
「実行の進行状況とログを見やすく表示し、再実行とキャンセルができるGitHub Actionsクライアント」と説明されています(App Store)。
- 長所:Actionsに特化していて、ログが読みやすく、無料です。
- 短所:App Storeの説明に実行の記載はなく、公開されているソースコード(maiyama18/Acts、最終更新2022年6月)にも実行APIの呼び出しはありません。見る専用と考えるのが安全です。
5. GitFlow for GitHub Actions
リポジトリをまたいだダッシュボード(成功率、失敗中・実行中のワークフロー)、ログ、再実行、デプロイの承認ができると説明されています(App Store)。
- 長所:複数のリポジトリを見張るのに強く、デプロイの承認をスマホでできます。無料です。
- 補足:App Storeの説明に「手動実行のワークフロー(workflow_dispatch)をスマホから開始し、ブランチと入力を選べる」とあり、実行にも対応しています。
- 短所:新しいアプリで、評価はまだ少数です。
6. GitHub Actions Widget
最大4つのワークフローの最新状況を、ホーム画面やロック画面に表示します。タップするとGitHubでその実行が開きます(App Store)。
- 長所:アプリを開かずに状況がわかります。
- 短所:表示するだけで、実行はできません。有料です。
7. Pocket Actions
何をするアプリか:実行を「始める」ことに絞ったアプリです。すべてのリポジトリの
workflow_dispatchワークフローを1つの画面に並べ、よく使うリポジトリはピン留めできます。入力の扱い:入力が不要なら1タップ、必要なら入力フォームを自動で作ります。GitHubのAPIが入力の定義を返さないときは、ワークフローのYAMLを読んで補います。前回の入力値も覚えています。
GASにも対応:Google Apps Script(GAS)のウェブアプリも同じ画面から実行できます。
ログイン・サーバーなし:
repoの権限を持つPATを貼るだけです。トークンは端末内の安全な領域(SecureStore)にだけ保存され、開発者のサーバーには送られません。アプリ内のガイドから、必要な権限を選んだ状態でGitHubのトークン発行画面を開けます。長所:手順が短く、リポジトリをまたいで「よく実行するもの」を1画面に集められます。ワークフローごとに何かを作る必要がありません。GASも一緒に扱えます。
短所:
- 実行結果やログは見られません。わかるのは「受け付けられたか」だけで、結果はGitHubや公式アプリで確認します。
- 無料は1日5回・週17回までです。
- 会社のOrganizationがサードパーティのトークンを制限している場合は、管理者の承認が必要です。
- 現在はiPhone向けで、Android版はGoogle Playのクローズドテスト中です。
認証情報の扱いを比べる
表は横にスクロールできます
| 方法 | 渡すもの | 保存される場所 |
|---|---|---|
| 公式アプリ・ブラウザ | GitHubのログイン | GitHubのアプリやブラウザ |
| iOSショートカット | ショートカットに書いたPAT | ショートカットの中 |
| サードパーティ製アプリ | アプリによって異なる | 各アプリの説明とプライバシーポリシーを確認 |
| Pocket Actions | repo 権限のPAT | 端末内のSecureStoreのみ。ログアウトかアプリ削除で消えます |
どの方法でも共通の注意点:
- できればFine-grained PATで、対象のリポジトリと有効期限を絞りましょう。
- スマホをなくしたら、まずGitHubの Settings → Developer settings でトークンを失効させます。
- 会社のリポジトリでは、組織のルール(サードパーティ製アプリの制限やSSO)に従ってください。
読者タイプ別のおすすめ
- プルリクエストのレビューが中心で、手動実行はたまに → GitHub公式アプリで十分です。
- 実行の様子を見守りたい、失敗にすぐ気づきたい → 公式アプリの通知、Acts、GitFlow。ロック画面で見たいならWidgetも。
- ワークフローが1〜2本で、自分で組むのが好き → iOSショートカット(権限を絞ったトークンで)。
- 複数のリポジトリのワークフローやGASを、思い立ったときにすぐ実行したい → Pocket Actions。
- 会社のルールでサードパーティのトークンが使えない → 公式アプリかブラウザ。
おすすめの組み合わせ:「実行は専用、確認は公式」
始めることと見守ることは、別の仕事です。
- 始める:Pocket Actions(またはショートカット)
- 失敗を知る:公式アプリのプッシュ通知(失敗時のみ)
- ひと目で確認:重要なワークフローだけWidget
GitHubを置き換えるのではなく、「実行ボタンをホーム画面の近くに置く」という考え方です。
自己診断チェックリスト
次に当てはまるほど、実行専用の道具を試す価値があります。
-
workflow_dispatchを週に3回以上実行している - 入力のあるワークフローを、スマホで毎回入力するのが面倒
- リポジトリが複数あり、毎回階層を掘るのがつらい
- 「思い立ったとき」に実行しないと意味が薄いジョブがある
実際の使われ方の一例
App Storeには、AIによる株式のファンダメンタル分析やメール削除を行うActionsのきっかけとして使っている、というレビューが寄せられています(ユーザーの声)。
気になった時にさっと1タップで回せる … AIはずっと自動で回すとお金がかかりすぎるんですが、ここまで簡単にトリガーできるならと、自動発火の頻度を下げて節約することが出来ました。
開発者の私自身は、気になった銘柄をAIに評価させる自動化を、必要なときにだけ実行しています。
定期実行をやめる必要はありません。決まった時刻に必要なものは定期実行に、「今すぐ・必要なときだけ」のものはスマホから。こう分けるだけで、無駄な実行と待ち時間の両方が減ります。
最初の1本を、スマホから実行できる形にする
1. リポジトリに workflow_dispatch を用意する
name: Redeploy
on:
workflow_dispatch:
inputs:
environment:
description: "デプロイ先"
type: choice
options: [staging, production]
default: staging
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: echo "Deploy to ${{ inputs.environment }}"
デフォルトブランチに置くと、公式アプリやブラウザから実行できるようになります。Pocket Actionsは main ブランチに対して実行するため、デフォルトブランチが master などのリポジトリでは使えません(現時点の仕様)。
2.(Pocket Actionsの場合)トークンを貼って実行する
- アプリ内のガイドから、GitHubのトークン発行画面を開きます(必要な権限は選ばれた状態で開きます)。
- 発行したトークンをアプリに貼ります。
- よく使うリポジトリをピン留めし、ワークフローの再生ボタンを押します。入力があればフォームが出ます。
まずは無料で試す
Pocket Actionsは、App Storeから無料でダウンロードできます。1日5回・週17回までは無料で実行できます。
- App Storeで見る(無料)
- Pocket Actions 公式サイト
- 更新履歴(Changelog)
- Android版は、Google Playのクローズドテストに参加すると使えます(公式サイトから)
よくある質問
Q. GitHub公式アプリでは手動実行できないの?
A. できます。2024年7月から、Workflowの画面で workflow_dispatch を実行できます。多くの場合、課題は「できるかどうか」ではなく、手順の長さと繰り返しの負担です。
Q. 「Run workflow」ボタンが出てこないのはなぜ?
A. ワークフローに workflow_dispatch が書かれていること、そのファイルがデフォルトブランチにあること、リポジトリへの書き込み権限があることが必要です。
Q. Pocket ActionsはGitHubの公式アプリ? A. いいえ。個人開発のサードパーティ製アプリです。
Q. トークンを渡しても大丈夫? A. 必要な権限は repo だけです(workflow は不要です)。トークンは端末内の安全な領域にだけ保存され、開発者のサーバーには送られません。ログアウトすると削除されます。スマホをなくしたときは、GitHubでトークンを失効させてください。
Q. 実行結果はわかる? A. Pocket Actionsでわかるのは、実行が受け付けられたかどうかだけです。結果はGitHubか公式アプリで確認してください(公式アプリでは失敗時の通知も設定できます)。
Q. 料金は? A. 1日5回・週17回まで無料です。無制限にしたい場合はプレミアム(月額¥380または買い切り¥5,980)があります。
関連記事
最終確認日:2026-11-01(各アプリのApp Store掲載内容、GitHubのドキュメント、Pocket Actionsの料金)
