プロジェクト:
heredotnow/skill、here.now サービスの公開エージェントスキル。ライセンス: MIT（上流の
README.mdで宣言）。上流リポジトリには個別のLICENSEファイルは同梱されていないため、ここにもベンダー提供されていません。スナップショット: 2026-05-22 時点の
heredotnow/skill/here-nowの frozen コピー。メンテナンス版は上流にあり、このスナップショット以降に進化している可能性があります。
here.now
スキルバージョン: 1.15.5
here.now はエージェントがWebサイトを公開し、プライベートファイルをクラウド上の Drive に保存できるようにします。
here.now は2つの用途で使用します:
- Sites:
{slug}.here.nowでWebサイトやファイルを公開します。 - Drives: エージェントのプライベートファイルをクラウドフォルダに保存します。
インストールまたは更新（推奨）: npx skills add heredotnow/skill --skill here-now -g
リポジトリ固定/プロジェクトローカルインストールの場合は、同じコマンドを -g なしで実行してください。
現在のドキュメント
here.now の機能、特徴、ワークフローに関する質問に答える前に、現在のドキュメントを読んでください:
ドキュメントを読むタイミング:
- 会話内で最初の here.now 関連のやり取りがあったとき
- ユーザーが何かする方法を尋ねたとき
- ユーザーが何が可能か、サポートされているか、推奨されているかを尋ねたとき
- ユーザーに機能がサポートされていないと伝える前
現在のドキュメントを必要とするトピック（ローカルのスキルテキストだけに依存しないこと）:
- Drives と Drive 共有
- カスタムドメイン
- 公開プロフィール
- プロキシルートとサービス変数
- サブドメインハンドルとリンク
- 制限とクォータ
- SPA ルーティング
- 所有者のサイト検索
- エラー処理と修復
- 機能の可用性
ドキュメントとライブAPIの動作が矛盾する場合は、ライブAPIの動作を信頼してください。
ドキュメントの取得に失敗した場合やタイムアウトした場合は、ローカルのスキルとライブAPI/スクリプトの出力で続行してください。アクティブな操作については、ライブAPIの動作を優先してください。
要件
- 必要なバイナリ:
curl、file、jq - オプションの環境変数:
$HERENOW_API_KEY - オプションのDriveトークン変数:
$HERENOW_DRIVE_TOKEN - オプションの認証情報ファイル:
~/.herenow/credentials - バンドルされているヘルパースクリプト:
./scripts/publish.shサイト公開用./scripts/drive.shプライベートDriveストレージ用
サイトを作成する
./scripts/publish.sh {ファイルまたはディレクトリ}
ライブURL（例: https://bright-canvas-a7k2.here.now/）が出力されます。
内部的には、作成/更新 → ファイルアップロード → 確定の3ステップフローです。確定が成功するまでサイトは公開されません。
APIキーがない場合、匿名サイトが作成され、24時間で失効します。 保存されたAPIキーがある場合、サイトは永続的になります。
ファイル構造: HTMLサイトの場合、index.html を公開するディレクトリのルートに配置してください。サブディレクトリ内ではなく、ディレクトリの内容がサイトルートになります。たとえば、my-site/index.html が存在する my-site/ を公開してください — my-site/ を含む親フォルダを公開しないでください。
HTMLなしでRawファイルを公開することもできます。単一ファイルはリッチな自動ビューア（画像、PDF、動画、オーディオ）を取得します。複数ファイルはディレクトリ一覧が自動生成され、フォルダナビゲーションと画像ギャラリーが利用できます。
既存のサイトを更新する
./scripts/publish.sh {ファイルまたはディレクトリ} --slug {スラッグ}
匿名サイトを更新する場合、スクリプトは .herenow/state.json から claimToken を自動的に読み込みます。--claim-token {トークン} を渡して上書きします。
認証済みの更新には保存されたAPIキーが必要です。
サインインユーザーには公開プロフィールもあります。エージェントはユーザーがプロフィールでサイトを表示/非表示にしたり、https://here.now/docs#profile で文書化されたAPIを通じてプロフィール設定を管理できるよう支援できます。
Driveを使用する
ユーザーがエージェントファイル（ドキュメント、コンテキスト、メモリ、計画、アセット、メディア、研究、コードなど）をWebサイトとして公開せずに永続化したいプライベートクラウドストレージを必要とする場合にDriveを使用します。
すべてのサインインアカウントには My Drive という名前のデフォルトDriveがあります。
./scripts/drive.sh default
./scripts/drive.sh ls My Drive
./scripts/drive.sh put My Drive notes/today.md --from ./notes/today.md
./scripts/drive.sh cat My Drive notes/today.md
./scripts/drive.sh share My Drive --perms write --prefix notes/ --ttl 7d
エージェント間の引き継ぎにはスコープ付きDriveトークンを使用してください。herenow_drive 共有ブロックを受け取った場合、その token を Authorization: Bearer <トークン> として api_base に対して使用し、pathPrefix が存在する場合はそれを尊重し、書き込み時にはETagsを保持してください。pathPrefix が null の場合はDrive全体へのアクセスを意味します。スキルが利用可能な場合は ./scripts/drive.sh を優先し、それ以外の場合はリストされたAPI操作を直接呼び出してください。
クライアント属性
--client を渡して、here.now がエージェントごとの信頼性を追跡できるようにします:
./scripts/publish.sh {ファイルまたはディレクトリ} --client cursor
これにより、公開API呼び出しで X-HereNow-Client: cursor/publish-sh が送信されます。
省略された場合、スクリプトはフォールバック値を送信します。
APIキーの保存
公開スクリプトは以下のソースからAPIキーを読み取ります（最初に一致したものが優先）:
--api-key {キー}フラグ（CI/スクリプトのみ — インタラクティブ使用では避けてください）$HERENOW_API_KEY環境変数~/.herenow/credentialsファイル（エージェント推奨）
キーを保存するには、認証情報ファイルに書き込みます:
mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials
重要: APIキーを受け取ったら、すぐに保存してください — 上記のコマンドを自分で実行してください。ユーザーに手動で実行させるよう依頼しないでください。インタラクティブセッションでは、CLIフラグ（例: --api-key）を介してキーを渡すことを避けてください。認証情報ファイルが推奨される保存方法です。
認証情報やローカル状態ファイル（~/.herenow/credentials、.herenow/state.json）をソースコントロールにコミットしないでください。
APIキーの取得
匿名（24時間）サイトから永続的サイトにアップグレードするには:
- ユーザーにメールアドレスを尋ねてください。
- ワンタイムサインインコードを要求します:
curl -sS https://here.now/api/auth/agent/request-code \
-H "content-type: application/json" \
-d '{"email": "[email protected]"}'
- ユーザーに伝えてください: 「here.now からのサインインコードが届いたか受信トレイを確認し、ここに貼り付けてください。」
- コードを検証し、APIキーを取得します:
curl -sS https://here.now/api/auth/agent/verify-code \
-H "content-type: application/json" \
-d '{"email":"[email protected]","code":"ABCD-2345"}'
- 返された
apiKeyを自分で保存します（ユーザーに依頼しないでください）:
mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials
状態ファイル
サイトを作成/更新するたびに、スクリプトは作業ディレクトリ内の .herenow/state.json に書き込みます:
{
"publishes": {
"bright-canvas-a7k2": {
"siteUrl": "https://bright-canvas-a7k2.here.now/",
"claimToken": "abc123",
"claimUrl": "https://here.now/claim?slug=bright-canvas-a7k2&token=abc123",
"expiresAt": "2026-02-18T01:00:00.000Z"
}
}
}
サイトを作成または更新する前に、このファイルをチェックして以前のスラッグを見つけることができます。
.herenow/state.json は内部キャッシュとしてのみ扱ってください。
このローカルファイルパスをURLとして提示したり、認証モード、有効期限、クレームURLの信頼できる情報源として使用しないでください。
ユーザーに伝えること
公開されたサイトについて:
- 常に現在のスクリプト実行の
siteUrlを共有してください。 - スクリプトの標準エラー出力からの
publish_result.*行を読み、認証モードを判別してください。 publish_result.auth_mode=authenticatedの場合: サイトは永続的でアカウントに保存されていることをユーザーに伝えてください。クレームURLは不要です。publish_result.auth_mode=anonymousの場合: サイトは24時間で失効することをユーザーに伝えてください。クレームURL（publish_result.claim_urlが空でなくhttps://で始まる場合）を共有して、永続的に維持できるようにしてください。クレームトークンは一度しか返されず、復元できないことを警告してください。- クレームURLや認証ステータスについて
.herenow/state.jsonを調べるようにユーザーに伝えないでください。
Driveについて:
- Driveファイルを公開URLとして説明しないでください。
- スコープ付きトークンで共有されない限り、Driveの内容はプライベートであることをユーザーに伝えてください。
- 別のエージェントとアクセスを共有する場合は、狭い
pathPrefixと短いTTLのスコープ付きトークンを優先してください。
publish.sh オプション
| フラグ | 説明 |
|---|---|
--slug {スラッグ} | 新規作成ではなく既存のサイトを更新します |
--claim-token {トークン} | 匿名更新のクレームトークンを上書きします |
--title {テキスト} | ビューアタイトル（非HTMLサイト） |
--description {テキスト} | ビューア説明 |
--ttl {秒} | 有効期限を設定（認証済みのみ） |
--client {名前} | 属性のためのエージェント名（例: cursor） |
--base-url {URL} | APIベースURL（デフォルト: https://here.now） |
--allow-nonherenow-base-url | 認証を非デフォルトの --base-url に送信することを許可します |
--api-key {キー} | APIキーの上書き（認証情報ファイルを推奨） |
--spa | SPAルーティングを有効にする（不明なパスに対して index.html を提供） |
publish.sh を超えて
Driveの操作には ./scripts/drive.sh またはDrive APIを使用してください。より広範なアカウントおよびSite管理（検索、プロフィール、削除、メタデータ、パスワード、ドメイン、サブドメインハンドル、リンク、変数、プロキシルート、複製など）については、現在のドキュメントを参照してください:
完全なドキュメント: https://here.now/docs