VPS で AI エージェントを動かし、スマホから操作する

月4ドルのVPSを、テキストで操作できるエージェントに。Terminullは Linux上でヘッドレスに動作し、シークレットを暗号化して保持し、Webhookを受け取り、スケジュールを実行します — そのすべてを、スマホから承認したり方向転換したりできます。

1. 小さなVPSを借りる

   1 vCPU / 1 GBで十分です。ワンラインのインストールの後、インストーラーがターミナルに表示するQRコードでペアリングしましょう — GUIもケーブルも不要です。

2. シークレットを暗号化したまま保つ

   環境変数のキーは~/.config/terminull/.envに置かれ、実行中のプロセス内でのみ使用されます。すべてのセッションはスマホとマシンの間でエンドツーエンドに暗号化されるため、機密情報がリレーを通ったり平文のログに残ったりすることはありません。

3. Webhookを受け取り、制御する

   エージェントにcreate_webhookを依頼すると、シークレットURLが手に入ります。GitHub、CI、監視ツールをそこに向ければ、届いたPOSTがスマホへのアラートとなったり、マシン上でエージェントの実行を開始したりします。いつでも取り消せます。

4. マシン上でスケジュールを実行

   cronのようなスクリプトやエージェントのスケジュール: 夜間バックアップ、証明書更新、ログローテーション、ヘルスチェック。注目すべき実行のみを指定すれば、本当に対応が必要になるまで静かなままです。

5. ポケットから自動化する

   エージェントがVPS上でコマンドを実行し、出力をカードとしてストリーミングします。実行中でも承認・方向転換・中断ができ、完了時や判断が必要な時にプッシュ通知が届きます。

# GitHub webhook → your Terminull hook URL:
POST https://relay.terminull.dev/hook/<beacon>/<secret>
     { "title": "main pushed", "text": "deploy prod" }

# the agent, on the box:
git pull && docker compose up -d --build && curl -fsS localhost/health
# → push: "Deploy OK · health 200"  (or the error, if not)