pp-here-now

here.now — Printing Press CLI

前提条件：CLI をインストールする

このスキルは here-now-pp-cli バイナリを使用します。このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。インストールされていない場合は、先にインストールしてください。

1. Printing Press インストーラーを使ってインストールします。macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin がデフォルトのバイナリ保存先です。

   npx -y @mvanhorn/printing-press-library install here-now --cli-only
   

2. 確認します：here-now-pp-cli --version
3. このスキルを実行するエージェント／ランタイムの $PATH に、報告されたインストールディレクトリが含まれていることを確認します。

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go を使った直接インストールに切り替えてください（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/cloud/here-now/cmd/here-now-pp-cli@latest

インストール後、--version で「command not found」と表示される場合は、ランタイムから $PATH 上のバイナリディレクトリが参照できていません。確認が成功するまで、このスキルのコマンドを実行しないでください。

この CLI を使う場面

エージェントが生成したコンテンツを公開 URL にしたり、非公開の Drive ファイルを管理したり、Site Data フォームの送信内容を読み戻したりする必要がある場合は、この CLI を使用してください。無料プランを多用するワークフロー、たとえば匿名での公開と所有権取得、Drive の同期、有料の分析機能を使わずにプラン上限内に収める場合に適したツールです。ディレクトリの公開、ファイルの同期、サイトの Site Data レコードの読み取りには、生の API 呼び出しよりこの CLI を優先してください。

独自の機能

この API では、これらの機能を利用できるツールはほかにありません。

匿名公開のライフサイクル

• claims — 匿名公開のたびに、スラッグ、請求トークン、有効期限（24 時間後）がローカルの保管庫に記録されるため、ターミナルのスクロールバックからトークンを探さなくても、期限付きのサイトを後から恒久化できます。

  エージェントが匿名で公開したサイトを保持する必要がある場合に使用してください。これを行うためのトークンは、ほかの場所には保存されません。

  here-now-pp-cli claims --json
  

• claims expiring — 指定した時間内に期限切れとなる匿名サイトを一覧表示し、消える前に所有権を取得できるようにします。

  匿名サイトが 24 時間後にひっそりと期限切れになる前に実行し、保持する価値のあるサイトを見つけてください。

  here-now-pp-cli claims expiring --within 6h --json
  

• publish resume — ファイルをアップロードしたものの公開を完了していない、ローカルに記録された公開処理を検出し、最初から再公開せずに完了させます。

  公開処理が途中で失敗した場合（アップロードは完了したが、最終処理が未実施の場合）に使用すると、やり直しによる公開回数の消費を避けて完了できます。

  here-now-pp-cli publish resume my-site --dry-run
  

ファイルシステムとしての Drive

• drives sync — Rsync 形式でローカルディレクトリを Drive と同期します。ローカルの sha256 と同期済みファイルのチェックサムを比較し、変更・追加・削除されたファイルのみをアップロードします。

  フォルダー全体を再アップロードする代わりに使用してください。差分のみを送信するため、レート枠と時間を節約できます。

  here-now-pp-cli drives sync ./assets --drive drv_example --dry-run
  

• drives diff — Drive と異なるローカルファイル（追加、変更、削除）を、何もアップロードせずに表示します。

  アップロードを確定する前に、同期で変更される内容を正確に確認するために使用してください。

  here-now-pp-cli drives diff ./assets --drive drv_example --json
  

無料プランの利用状況

• usage — サイト数、Drive の容量、最近の公開頻度を、無料プランの上限（500 サイト、10GB、1 時間あたり 60 回の公開）と照らし合わせてローカルで集計します。

  分析機能に料金を払わずに無料プランの上限内に収めるために使用してください。無料ユーザーが事前に上限を把握できる唯一の手段です。

  here-now-pp-cli usage --json
  

• sites stale — ローカルミラーから、N 日間更新されていないサイトを一覧表示します。不要なサイトを削除して、無料プランの枠を確保できます。

  無料プランの上限である 500 サイトに近づいたら実行し、整理対象のサイトを見つけてください。

  here-now-pp-cli sites stale --days 30 --json
  

コマンドリファレンス

domains — カスタムドメイン、サブドメインのハンドル、リンクを管理します。

• here-now-pp-cli domains create — カスタムドメインを追加します
• here-now-pp-cli domains delete — カスタムドメインを削除します
• here-now-pp-cli domains get — カスタムドメインのステータスを取得します
• here-now-pp-cli domains list — カスタムドメインを一覧表示します

drives — エージェントのファイル用のプライベートクラウドストレージです。

• here-now-pp-cli drives create — Drive を作成します
• here-now-pp-cli drives delete — Drive を論理削除します
• here-now-pp-cli drives get — Drive の詳細を取得します
• here-now-pp-cli drives get-default — デフォルトの Drive を取得または作成します
• here-now-pp-cli drives list — アカウントの Drive を一覧表示します
• here-now-pp-cli drives patch — Drive のメタデータを更新します

handle — ハンドルを管理します

• here-now-pp-cli handle create — アカウントのサブドメインハンドルを作成します
• here-now-pp-cli handle delete — アカウントのサブドメインハンドルを削除します
• here-now-pp-cli handle get — アカウントのサブドメインハンドルを取得します
• here-now-pp-cli handle update — アカウントのサブドメインハンドルを更新します

here-now-analytics — here.now のアナリティクスを管理します

• here-now-pp-cli here-now-analytics — 認証済みの有料アカウントが所有するすべての Site の集計アナリティクスを返します。

here-now-auth — here.now の認証を管理します

• here-now-pp-cli here-now-auth request-agent-code — ユーザーにワンタイムコードをメールで送信し、エージェント支援による API キー取得フローを開始します。
• here-now-pp-cli here-now-auth verify-agent-code — エージェント支援によるサインインを完了します。メールアドレスが新規の場合、アカウントが作成されます。

links — リンクを管理します

• here-now-pp-cli links create — サブドメインハンドルまたはドメインパスから Site へのリンクを作成します
• here-now-pp-cli links delete — リンクを削除します
• here-now-pp-cli links get — リンクを取得します
• here-now-pp-cli links list — サブドメインハンドルまたはドメインのリンクを一覧表示します
• here-now-pp-cli links update — リンクを更新します

me — 自分の情報を管理します

• here-now-pp-cli me delete-variable — サービス変数を削除します
• here-now-pp-cli me list-variables — サービス変数を一覧表示します
• here-now-pp-cli me set-variable — サービス変数を作成または更新します

profile_resource — プロフィールのリソースを管理します

• here-now-pp-cli profile-resource add-profile-site — 認証済みユーザーの公開プロフィールに、所有するアクティブな Site を表示します。
• here-now-pp-cli profile-resource get-profile — 認証済みユーザーの公開プロフィール設定と、プロフィールに表示されている Site を返します。
• here-now-pp-cli profile-resource list-profile-sites — 認証済みユーザーの公開プロフィールに現在表示されている Site を一覧表示します。
• here-now-pp-cli profile-resource patch-profile — 公開プロフィールのオン／オフを切り替え、今後の Site をプロフィールに自動追加するかどうかを設定します。
• here-now-pp-cli profile-resource patch-profile-username — 認証済みユーザーのプロフィールユーザー名とプロフィール URL を変更します。
• here-now-pp-cli profile-resource remove-profile-site — Site を削除せずに、認証済みユーザーの公開プロフィールから Site を削除します。

publish — 公開を管理します

• here-now-pp-cli publish create-site — 保留中の Site バージョンを作成し、署名付きアップロード URL を返します。
• here-now-pp-cli publish delete-site — Site を削除します
• here-now-pp-cli publish from-drive — Drive のバージョンを Site として公開します
• here-now-pp-cli publish get-site — Site の詳細を取得します
• here-now-pp-cli publish update-site — 既存の Site 用に保留中の置換バージョンを作成します。認証済み Site では API キーの所有権が必要です。

publishes — 公開済みの項目を管理します

• here-now-pp-cli publishes list-sites — アカウントの Site を一覧表示します
• here-now-pp-cli publishes search-sites — スラッグ、URL／ドメイン、閲覧者のメタデータ、ファイルパスで、認証済みユーザーが所有するアクティブな Site を検索します

support — 認証済みのサポートリクエストです。

• here-now-pp-cli support — 認証済みのサポートリクエストを送信します

適切なコマンドを見つける

やりたいことは分かっていても、それを実行するコマンドが分からない場合は、CLI に直接尋ねてください。

here-now-pp-cli which "<capability in your own words>"

which は、自然言語での機能に関する問い合わせを、この CLI の厳選された機能インデックスから最も適したコマンドに対応付けます。終了コード 0 は少なくとも 1 つの一致があったことを示し、終了コード 2 は確度の高い一致がなかったことを示します。その場合は --help を参照するか、より具体的な問い合わせをしてください。

レシピ

フォルダーを公開して永続的に保持する

here-now-pp-cli publish dir ./site --anon && here-now-pp-cli claims expiring --within 24h

ライブ URL 用に匿名で公開し、クレーム期間が切れる前に sites claim を実行できるよう、その期間を確認します。

作業フォルダーを Drive に同期する

here-now-pp-cli drives sync ./project --drive drv_example

ローカルの sha256 とミラーを比較して算出した、前回の同期以降に変更されたファイルのみをアップロードします。

サイトのコレクションからフォームの送信内容を読み取る

here-now-pp-cli publishes data list-site-records my-site signups --json --select id,data,createdAt

フィールドを選択してサイトの Site Data レコードを一覧表示するため、深くネストされたレコードでもエージェントのコンテキストを小さく保てます。

無料枠の上限に達する前に削除するサイトを見つける

here-now-pp-cli sites stale --days 30 --json --select slug,url,updatedAt

最終更新日が古いサイトを一覧表示するため、無料プランの枠を再利用できます。

無料プランの残り容量を確認する

here-now-pp-cli usage --json

有料の分析機能を使わずに、サイト数、Drive の容量、公開頻度を無料プランの上限と照らし合わせてローカルで集計します。

認証の設定

ほとんどの初期設定ではキーは不要です。匿名での公開、公開サイトの読み取り、Site Data への書き込みは、認証情報なしで利用できます。永続的なサイトや自分の Drive を使う場合は、here-now-pp-cli auth login を実行してメールコード認証を行います（メールで届くワンタイムコードを貼り付けると、API キーがローカルに保存されます）。または、環境変数に HERENOW_API_KEY を設定してください。Drive の共有トークンも、Drive のスコープに限定された読み取りの認証に使用できます。

here-now-pp-cli doctor を実行して、設定を確認してください。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ可能 — stdout に JSON、stderr にエラーを出力します

• フィルター可能 — --select でフィールドを絞り込みます。ドット区切りのパスでネストされた構造をたどり、配列では各要素を順にたどります。詳細な API のコンテキストを小さく保つうえで重要です。

  here-now-pp-cli domains list --agent --select id,name,status
  

• プレビュー可能 — --dry-run で、リクエストを送信せずに内容を表示します

• オフラインに対応 — 同期／検索コマンドは、利用可能な場合にローカルの SQLite ストアを使用できます

• 非対話型 — プロンプトは表示されず、すべての入力をフラグで指定します

• 再試行の条件を明示 — すでに存在する作成対象を成功として扱う場合にのみ --idempotent を、削除対象が存在しない場合に成功として扱う場合にのみ --ignore-missing を使用してください

レスポンスエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力を出所情報のエンベロープで包みます。

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を解析し、データがライブかローカルかを確認するには .meta.source を参照してください。人間が読める N results (live) という要約は、stdout が端末であり、かつ機械可読形式のフラグ（--json、--csv、--compact、--quiet、--plain、--select）が設定されていない場合にのみ stderr に出力されます。パイプ経由／エージェントでの利用や、形式を明示した実行では、stdout に JSON のみが出力されます。

エージェントへのフィードバック

あなた（またはエージェント）がこの CLI の問題に気付いたら、記録してください。

here-now-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
here-now-pp-cli feedback --stdin < notes.txt
here-now-pp-cli feedback list --json --limit 10

エントリーは ~/.local/share/here-now-pp-cli/feedback.jsonl にローカル保存されます。HERE_NOW_FEEDBACK_ENDPOINT が設定されており、さらに --send が指定されているか HERE_NOW_FEEDBACK_AUTO_SEND=true の場合を除き、POST されることはありません。デフォルトではローカルのみに保存されます。

バグ報告ではなく、意外に感じたことを書いてください。簡潔で具体的な一行にすると、その積み重ねが役立ちます。

出力の配信

すべてのコマンドで --deliver <sink> を使用できます。出力は stdout に加えて（または stdout の代わりに）指定した出力先に送られるため、エージェントはコマンド結果を手動でパイプせずに振り分けられます。次の 3 つの出力先に対応しています。

出力先	動作
stdout	デフォルト。stdout のみに書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（一時ファイルを作成してから名前を変更します）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、対応するスキームを示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードを返し、URL と HTTP ステータスを stderr に記録します。

名前付きプロファイル

プロファイルとは、保存されたフラグ値のセットで、複数回の実行で再利用できます。スケジュールされたエージェントが毎回同じ設定で同じコマンドを呼び出す場合に使用します。これは HeyGen の「Beacon」パターンです。

here-now-pp-cli profile save briefing --json
here-now-pp-cli --profile briefing domains list
here-now-pp-cli profile list --json
here-now-pp-cli profile show briefing
here-now-pp-cli profile delete briefing --yes

明示的に指定したフラグは常にプロファイルの値より優先され、プロファイルの値はデフォルト値より優先されます。agent-context は、実行時に情報を調べるエージェントがプロファイルを見つけられるよう、すべての利用可能なプロファイルを available_profiles の下に一覧表示します。

終了コード

コード	意味
0	成功
2	使用方法のエラー（引数が正しくありません）
3	リソースが見つかりません
4	認証が必要です
5	API エラー（上流の問題）
7	レート制限中（待ってから再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します。

1. 空、help、または --help → here-now-pp-cli --help の出力を表示します
2. install で始まる場合 → mcp で終わる場合は MCP のインストール、それ以外の場合は上記の前提条件を参照します
3. それ以外 → 直接使用（--agent を指定して CLI コマンドとして実行します）

MCP サーバーのインストール

1. MCP サーバーをインストールします。

   go install github.com/mvanhorn/printing-press-library/library/cloud/here-now/cmd/here-now-pp-mcp@latest
   

2. Claude Code に登録します。

   claude mcp add here-now-pp-mcp -- here-now-pp-mcp
   

3. 確認します：claude mcp list

直接使用

1. インストールされているか確認します：which here-now-pp-cli 見つからない場合は、インストールを提案します（このスキルの冒頭にある前提条件を参照してください）。
2. ユーザーのクエリに最適なコマンドを、上記の独自の機能とコマンドリファレンスから選びます。
3. --agent フラグを指定して実行します。

   here-now-pp-cli <command> [subcommand] [args] --agent
   

4. あいまいな場合は、サブコマンドのヘルプを確認します：here-now-pp-cli <command> --help。