本文へスキップ

Agent プッシュ設定

受信トレイは duckterm-hookd で動作します。アプリからプラットフォーム別の専用スニペットをコピーし、Agent マシンで一度実行すると、インストール、1 回のペアリング、対応 Hook の設定、サービス起動まで完了します。

始める前に

  • スマートフォンまたはタブレットに DuckTerm をインストール済み(Apple デバイスは iOS / iPadOS 17+)
  • Claude Code / Codex / Gemini CLI / その他の Agent が動く macOS または Linux マシン
  • macOS は Homebrew、Linux は curl と systemd
  1. 1

    専用のセットアップスニペットをコピー

    「設定 → Agent 通知」を開き、macOS または Linux を選んでコードブロックを長押しします。コピーされる内容には、このアプリ用のペアトークンとアカウント ID が含まれます。

    DuckTerm から実行可能なコマンドを取得

    この Web サイトは非公開のペアトークンを生成・表示しません。DuckTerm をインストールまたは開き、「設定 → Agent 通知」から入力済みコマンドをコピーしてください。

  2. 2

    Agent が動くマシンで一度だけ実行

    コピーしたスニペットをそのマシンで実行します。hookd のインストール、1 回のペアリング、対応 Agent の Hook 登録、バックグラウンドサービスの起動まで進むため、Agent ごとの設定は不要です。

    以下はプレースホルダー入りの例です。ペアトークンとアカウント ID が入力済みの専用版をアプリからコピーしてください。

    macOS

    Homebrew · Apple シリコン / Intel
    brew install ducksee/tap/duckterm-hookd && \
    "$(brew --prefix duckterm-hookd)/bin/duckterm-hookd" setup --token <pair-token> --user <account-id>

    Linux

    Ubuntu・Debian など主要な systemd ディストリビューション · arm64 / x86_64
    curl -fsSL https://raw.githubusercontent.com/ducksee/duckterm-hookd-releases/main/install.sh \
      | DUCKTERM_PAIR_TOKEN=<pair-token> DUCKTERM_PAIR_USER=<account-id> sh
  3. 3

    確認

    `duckterm-hookd status` を実行し、「設定 → Agent 通知」からローカルプッシュとプラットフォームプッシュをテストします。以後のアップグレードやサービス再起動でも、このペアリングは保持されます。

    duckterm-hookd status

    続いて「設定 → Agent 通知 → 確認」から、ローカルテストとプラットフォームプッシュのテストを送信します。両方がスマートフォンに届けば設定完了です。

hookd をインストール済みの場合:QR でペアリング

hookd がすでにインストール済みでカメラを使いたい場合は、トークンのペアリングコマンドの代わりに下のコマンドを実行し、ターミナルの QR コードをアプリで読み取ります。ペアリング方法はどちらか一方だけを選び、両方は実行しないでください。アップグレードやサービス再起動後も、保存済みのペアリングは保持されます。

duckterm-hookd pair --qr

Hook の対象

hookd は Claude Code、Codex、Grok Build、Antigravity、Cursor、OpenCode、Pi、Devin、Droid、Qoder、Amp、Gemini CLI の 12 種のワークフローを検証しています。Contract v1 は 7 つの決定スキーマを定義し、現在スマートフォンからの決定を伝達できるインストール済みアダプターは 6 つです。OpenCode は現時点でライフサイクル状態のみを報告し、権限応答アダプターは対応待ちです。Grok Build は独自の Hook システムと、対応するグローバル Hook ソースを使います。

Claude Code Codex Grok Build Antigravity Cursor OpenCode Pi Devin Droid Qoder Amp Gemini

マシンの外へ送られる情報

hookd は Agent の Hook イベントとトランスクリプトから通知プレビューを生成します。プロンプトや出力内の文章・コード断片がプレビューに含まれる場合があります。承認、返信、Live Preview または画像のフォールバックも中継を通る場合がありますが、ターミナル通信は直接のままです。SSH 認証情報が当社のサーバーへ送信されることはありません。保存と保持期間の詳細はプライバシーポリシーをご覧ください。

プライバシーポリシー

問題が起きたら

サポートページのよくある問題を確認するか、メールでお問い合わせください。迅速に対応します。