tapback 0.1.3

Tapback - Mobile approval tool for LLM workflows

Tapback

スマホからYes/Noやテキストを返せるHuman-in-the-Loopツール。

Claude CodeなどのLLMツールと連携し、スマホから承認・入力ができます。

インストール

uvx tapback-server  # サーバー起動

Claude Code連携

プロジェクトの .mcp.json に以下を追加:

{
  "mcpServers": {
    "tapback": {
      "command": "uvx",
      "args": ["tapback"]
    }
  }
}

使い方

1. サーバー起動

uvx tapback-server

表示されるPINをメモし、Network URLにスマホでアクセス。

2. Claude Codeで使用

Claude Codeが ask_yesno / ask_text ツールを呼び出すと、スマホに質問が表示されます。

CLIとして使用

uvx tapback "削除しますか？" --type yesno
uvx tapback "修正内容を入力" --type text

Pythonから使用

from tapback import ask

if ask("実行しますか？", type="yesno") == "yes":
    execute()

ネットワーク要件

スマホとMacが同じWi-Fiネットワークに接続されている必要があります。

外出先など別ネットワークから使う場合は、ngrokでトンネリングしてください:

ngrok http 8080

表示されるURL（例: https://xxxx.ngrok.io）をスマホで開きます。

オプション

uvx tapback-server --port 9000      # ポート変更
uvx tapback-server --no-auth        # PIN認証を無効化

License

MIT