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つの方法の比較表

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 Actions1〜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 Actionsrepo 権限のPAT端末内のSecureStoreのみ。ログアウトかアプリ削除で消えます

どの方法でも共通の注意点:

  • できればFine-grained PATで、対象のリポジトリと有効期限を絞りましょう。
  • スマホをなくしたら、まずGitHubの Settings → Developer settings でトークンを失効させます。
  • 会社のリポジトリでは、組織のルール(サードパーティ製アプリの制限やSSO)に従ってください。

読者タイプ別のおすすめ

  • プルリクエストのレビューが中心で、手動実行はたまに → GitHub公式アプリで十分です。
  • 実行の様子を見守りたい、失敗にすぐ気づきたい → 公式アプリの通知、Acts、GitFlow。ロック画面で見たいならWidgetも。
  • ワークフローが1〜2本で、自分で組むのが好き → iOSショートカット(権限を絞ったトークンで)。
  • 複数のリポジトリのワークフローやGASを、思い立ったときにすぐ実行したい → Pocket Actions。
  • 会社のルールでサードパーティのトークンが使えない → 公式アプリかブラウザ。

おすすめの組み合わせ:「実行は専用、確認は公式」

始めることと見守ることは、別の仕事です。

  1. 始める:Pocket Actions(またはショートカット)
  2. 失敗を知る:公式アプリのプッシュ通知(失敗時のみ)
  3. ひと目で確認:重要なワークフローだけ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の場合)トークンを貼って実行する

  1. アプリ内のガイドから、GitHubのトークン発行画面を開きます(必要な権限は選ばれた状態で開きます)。
  2. 発行したトークンをアプリに貼ります。
  3. よく使うリポジトリをピン留めし、ワークフローの再生ボタンを押します。入力があればフォームが出ます。

まずは無料で試す

Pocket Actionsは、App Storeから無料でダウンロードできます。1日5回・週17回までは無料で実行できます。

よくある質問

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の料金)