{
  "schemaVersion": "1.0",
  "item": {
    "slug": "here-now",
    "name": "here.now",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/adamludwin/here-now",
    "canonicalUrl": "https://clawhub.ai/adamludwin/here-now",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/here-now",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=here-now",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/publish.sh",
      "references/REFERENCE.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/here-now"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/here-now",
    "agentPageUrl": "https://openagent3.xyz/skills/here-now/agent",
    "manifestUrl": "https://openagent3.xyz/skills/here-now/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/here-now/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "here.now",
        "body": "Skill version: 1.8.3\n\nCreate a live URL from any file or folder. Static hosting only.\n\nTo install or update (recommended): npx skills add heredotnow/skill --skill here-now -g\n\nFor repo-pinned/project-local installs, run the same command without -g."
      },
      {
        "title": "Requirements",
        "body": "Required binaries: curl, file, jq\nOptional environment variable: $HERENOW_API_KEY\nOptional credentials file: ~/.herenow/credentials"
      },
      {
        "title": "Create a site",
        "body": "./scripts/publish.sh {file-or-dir}\n\nOutputs the live URL (e.g. https://bright-canvas-a7k2.here.now/).\n\nUnder the hood this is a three-step flow: create/update -> upload files -> finalize. A site is not live until finalize succeeds.\n\nWithout an API key this creates an anonymous site that expires in 24 hours.\nWith a saved API key, the site is permanent.\n\nFile structure: For HTML sites, place index.html at the root of the directory you publish, not inside a subdirectory. The directory's contents become the site root. For example, publish my-site/ where my-site/index.html exists — don't publish a parent folder that contains my-site/.\n\nYou can also publish raw files without any HTML. Single files get a rich auto-viewer (images, PDF, video, audio). Multiple files get an auto-generated directory listing with folder navigation and an image gallery."
      },
      {
        "title": "Update an existing site",
        "body": "./scripts/publish.sh {file-or-dir} --slug {slug}\n\nThe script auto-loads the claimToken from .herenow/state.json when updating anonymous sites. Pass --claim-token {token} to override.\n\nAuthenticated updates require a saved API key."
      },
      {
        "title": "Client attribution",
        "body": "Pass --client so here.now can track reliability by agent:\n\n./scripts/publish.sh {file-or-dir} --client cursor\n\nThis sends X-HereNow-Client: cursor/publish-sh on publish API calls.\nIf omitted, the script sends a fallback value."
      },
      {
        "title": "API key storage",
        "body": "The publish script reads the API key from these sources (first match wins):\n\n--api-key {key} flag (CI/scripting only — avoid in interactive use)\n$HERENOW_API_KEY environment variable\n~/.herenow/credentials file (recommended for agents)\n\nTo store a key, write it to the credentials file:\n\nmkdir -p ~/.herenow && echo \"{API_KEY}\" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials\n\nIMPORTANT: After receiving an API key, save it immediately — run the command above yourself. Do not ask the user to run it manually. Avoid passing the key via CLI flags (e.g. --api-key) in interactive sessions; the credentials file is the preferred storage method.\n\nNever commit credentials or local state files (~/.herenow/credentials, .herenow/state.json) to source control."
      },
      {
        "title": "State file",
        "body": "After every site create/update, the script writes to .herenow/state.json in the working directory:\n\n{\n  \"publishes\": {\n    \"bright-canvas-a7k2\": {\n      \"siteUrl\": \"https://bright-canvas-a7k2.here.now/\",\n      \"claimToken\": \"abc123\",\n      \"claimUrl\": \"https://here.now/claim?slug=bright-canvas-a7k2&token=abc123\",\n      \"expiresAt\": \"2026-02-18T01:00:00.000Z\"\n    }\n  }\n}\n\nBefore creating or updating sites, you may check this file to find prior slugs.\nTreat .herenow/state.json as internal cache only.\nNever present this local file path as a URL, and never use it as source of truth for auth mode, expiry, or claim URL."
      },
      {
        "title": "What to tell the user",
        "body": "Always share the siteUrl from the current script run.\nRead and follow publish_result.* lines from script stderr to determine auth mode.\nWhen publish_result.auth_mode=authenticated: tell the user the site is permanent and saved to their account. No claim URL is needed.\nWhen publish_result.auth_mode=anonymous: tell the user the site expires in 24 hours. Share the claim URL (if publish_result.claim_url is non-empty and starts with https://) so they can keep it permanently. Warn that claim tokens are only returned once and cannot be recovered.\nNever tell the user to inspect .herenow/state.json for claim URLs or auth status."
      },
      {
        "title": "Limits",
        "body": "AnonymousAuthenticatedMax file size250 MB5 GBExpiry24 hoursPermanent (or custom TTL)Rate limit5 / hour / IP60 / hour free, 200 / hour hobbyAccount neededNoYes (get key at here.now)"
      },
      {
        "title": "Getting an API key",
        "body": "To upgrade from anonymous (24h) to permanent sites:\n\nAsk the user for their email address.\nRequest a one-time sign-in code:\n\ncurl -sS https://here.now/api/auth/agent/request-code \\\n  -H \"content-type: application/json\" \\\n  -d '{\"email\": \"user@example.com\"}'\n\nTell the user: \"Check your inbox for a sign-in code from here.now and paste it here.\"\nVerify the code and get the API key:\n\ncurl -sS https://here.now/api/auth/agent/verify-code \\\n  -H \"content-type: application/json\" \\\n  -d '{\"email\":\"user@example.com\",\"code\":\"ABCD-2345\"}'\n\nSave the returned apiKey yourself (do not ask the user to do this):\n\nmkdir -p ~/.herenow && echo \"{API_KEY}\" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials"
      },
      {
        "title": "Script options",
        "body": "FlagDescription--slug {slug}Update an existing site instead of creating--claim-token {token}Override claim token for anonymous updates--title {text}Viewer title (non-HTML sites)--description {text}Viewer description--ttl {seconds}Set expiry (authenticated only)--client {name}Agent name for attribution (e.g. cursor)--base-url {url}API base URL (default: https://here.now)--allow-nonherenow-base-urlAllow sending auth to non-default --base-url--api-key {key}API key override (prefer credentials file)"
      },
      {
        "title": "Duplicate a site",
        "body": "curl -sS -X POST https://here.now/api/v1/publish/{slug}/duplicate \\\n  -H \"Authorization: Bearer {API_KEY}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{}'\n\nCreates a full copy of the site under a new slug. All files are copied server-side — no upload needed. The new site is immediately live. Requires authentication and ownership of the source site.\n\nOptionally override viewer metadata (shallow-merged with the source):\n\ncurl -sS -X POST https://here.now/api/v1/publish/{slug}/duplicate \\\n  -H \"Authorization: Bearer {API_KEY}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"viewer\": {\"title\": \"My Copy\"}}'"
      },
      {
        "title": "Beyond the script",
        "body": "For delete, metadata patch (including password protection), duplicate, claim, list, and other operations, see references/REFERENCE.md."
      },
      {
        "title": "Handle",
        "body": "Handles are user-owned subdomain namespaces on here.now (for example, yourname.here.now) that route paths to your sites. Claiming a handle requires a paid plan (Hobby or above).\n\nHandle endpoints: /api/v1/handle\nHandle format: lowercase letters/numbers/hyphens, 2-30 chars, no leading/trailing hyphens"
      },
      {
        "title": "Custom domains",
        "body": "Bring your own domain (e.g. example.com) and serve sites from it. Custom domains: 1 on Free, up to 5 on Hobby.\n\nDomain endpoints: /api/v1/domains and /api/v1/domains/:domain"
      },
      {
        "title": "Add a custom domain",
        "body": "curl -sS https://here.now/api/v1/domains \\\n  -H \"Authorization: Bearer {API_KEY}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"domain\": \"example.com\"}'\n\nResponse includes DNS instructions. Point an ALIAS record (or CNAME for subdomains) to fallback.here.now. SSL is provisioned automatically.\n\nMost domains use an ALIAS record (sometimes called ANAME or CNAME flattening). Subdomains (e.g. docs.example.com) can also use a standard CNAME record."
      },
      {
        "title": "Check domain status",
        "body": "curl -sS https://here.now/api/v1/domains/example.com \\\n  -H \"Authorization: Bearer {API_KEY}\"\n\nStatus is pending until DNS is verified and SSL is active, then becomes active."
      },
      {
        "title": "List custom domains",
        "body": "curl -sS https://here.now/api/v1/domains \\\n  -H \"Authorization: Bearer {API_KEY}\""
      },
      {
        "title": "Remove a custom domain",
        "body": "curl -sS -X DELETE https://here.now/api/v1/domains/example.com \\\n  -H \"Authorization: Bearer {API_KEY}\"\n\nRemoves the domain and all links under it."
      },
      {
        "title": "Links",
        "body": "Links connect a site to a location on your handle or a custom domain. The same endpoints work for both — omit the domain parameter to target your handle, or include it to target a custom domain.\n\nLink endpoints: /api/v1/links and /api/v1/links/:location\nRoot location sentinel for path params: __root__\nChanges propagate globally in up to 60 seconds (Cloudflare KV)\n\nLink to your handle:\n\ncurl -sS https://here.now/api/v1/links \\\n  -H \"Authorization: Bearer {API_KEY}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"location\": \"docs\", \"slug\": \"bright-canvas-a7k2\"}'\n\nLink to a custom domain:\n\ncurl -sS https://here.now/api/v1/links \\\n  -H \"Authorization: Bearer {API_KEY}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"location\": \"\", \"slug\": \"bright-canvas-a7k2\", \"domain\": \"example.com\"}'\n\nAn empty location makes it the homepage (e.g. https://example.com/). Use \"location\": \"docs\" for https://example.com/docs/.\n\nFull docs: https://here.now/docs"
      }
    ],
    "body": "here.now\n\nSkill version: 1.8.3\n\nCreate a live URL from any file or folder. Static hosting only.\n\nTo install or update (recommended): npx skills add heredotnow/skill --skill here-now -g\n\nFor repo-pinned/project-local installs, run the same command without -g.\n\nRequirements\nRequired binaries: curl, file, jq\nOptional environment variable: $HERENOW_API_KEY\nOptional credentials file: ~/.herenow/credentials\nCreate a site\n./scripts/publish.sh {file-or-dir}\n\n\nOutputs the live URL (e.g. https://bright-canvas-a7k2.here.now/).\n\nUnder the hood this is a three-step flow: create/update -> upload files -> finalize. A site is not live until finalize succeeds.\n\nWithout an API key this creates an anonymous site that expires in 24 hours. With a saved API key, the site is permanent.\n\nFile structure: For HTML sites, place index.html at the root of the directory you publish, not inside a subdirectory. The directory's contents become the site root. For example, publish my-site/ where my-site/index.html exists — don't publish a parent folder that contains my-site/.\n\nYou can also publish raw files without any HTML. Single files get a rich auto-viewer (images, PDF, video, audio). Multiple files get an auto-generated directory listing with folder navigation and an image gallery.\n\nUpdate an existing site\n./scripts/publish.sh {file-or-dir} --slug {slug}\n\n\nThe script auto-loads the claimToken from .herenow/state.json when updating anonymous sites. Pass --claim-token {token} to override.\n\nAuthenticated updates require a saved API key.\n\nClient attribution\n\nPass --client so here.now can track reliability by agent:\n\n./scripts/publish.sh {file-or-dir} --client cursor\n\n\nThis sends X-HereNow-Client: cursor/publish-sh on publish API calls. If omitted, the script sends a fallback value.\n\nAPI key storage\n\nThe publish script reads the API key from these sources (first match wins):\n\n--api-key {key} flag (CI/scripting only — avoid in interactive use)\n$HERENOW_API_KEY environment variable\n~/.herenow/credentials file (recommended for agents)\n\nTo store a key, write it to the credentials file:\n\nmkdir -p ~/.herenow && echo \"{API_KEY}\" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials\n\n\nIMPORTANT: After receiving an API key, save it immediately — run the command above yourself. Do not ask the user to run it manually. Avoid passing the key via CLI flags (e.g. --api-key) in interactive sessions; the credentials file is the preferred storage method.\n\nNever commit credentials or local state files (~/.herenow/credentials, .herenow/state.json) to source control.\n\nState file\n\nAfter every site create/update, the script writes to .herenow/state.json in the working directory:\n\n{\n  \"publishes\": {\n    \"bright-canvas-a7k2\": {\n      \"siteUrl\": \"https://bright-canvas-a7k2.here.now/\",\n      \"claimToken\": \"abc123\",\n      \"claimUrl\": \"https://here.now/claim?slug=bright-canvas-a7k2&token=abc123\",\n      \"expiresAt\": \"2026-02-18T01:00:00.000Z\"\n    }\n  }\n}\n\n\nBefore creating or updating sites, you may check this file to find prior slugs. Treat .herenow/state.json as internal cache only. Never present this local file path as a URL, and never use it as source of truth for auth mode, expiry, or claim URL.\n\nWhat to tell the user\nAlways share the siteUrl from the current script run.\nRead and follow publish_result.* lines from script stderr to determine auth mode.\nWhen publish_result.auth_mode=authenticated: tell the user the site is permanent and saved to their account. No claim URL is needed.\nWhen publish_result.auth_mode=anonymous: tell the user the site expires in 24 hours. Share the claim URL (if publish_result.claim_url is non-empty and starts with https://) so they can keep it permanently. Warn that claim tokens are only returned once and cannot be recovered.\nNever tell the user to inspect .herenow/state.json for claim URLs or auth status.\nLimits\n\tAnonymous\tAuthenticated\nMax file size\t250 MB\t5 GB\nExpiry\t24 hours\tPermanent (or custom TTL)\nRate limit\t5 / hour / IP\t60 / hour free, 200 / hour hobby\nAccount needed\tNo\tYes (get key at here.now)\nGetting an API key\n\nTo upgrade from anonymous (24h) to permanent sites:\n\nAsk the user for their email address.\nRequest a one-time sign-in code:\ncurl -sS https://here.now/api/auth/agent/request-code \\\n  -H \"content-type: application/json\" \\\n  -d '{\"email\": \"user@example.com\"}'\n\nTell the user: \"Check your inbox for a sign-in code from here.now and paste it here.\"\nVerify the code and get the API key:\ncurl -sS https://here.now/api/auth/agent/verify-code \\\n  -H \"content-type: application/json\" \\\n  -d '{\"email\":\"user@example.com\",\"code\":\"ABCD-2345\"}'\n\nSave the returned apiKey yourself (do not ask the user to do this):\nmkdir -p ~/.herenow && echo \"{API_KEY}\" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials\n\nScript options\nFlag\tDescription\n--slug {slug}\tUpdate an existing site instead of creating\n--claim-token {token}\tOverride claim token for anonymous updates\n--title {text}\tViewer title (non-HTML sites)\n--description {text}\tViewer description\n--ttl {seconds}\tSet expiry (authenticated only)\n--client {name}\tAgent name for attribution (e.g. cursor)\n--base-url {url}\tAPI base URL (default: https://here.now)\n--allow-nonherenow-base-url\tAllow sending auth to non-default --base-url\n--api-key {key}\tAPI key override (prefer credentials file)\nDuplicate a site\ncurl -sS -X POST https://here.now/api/v1/publish/{slug}/duplicate \\\n  -H \"Authorization: Bearer {API_KEY}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{}'\n\n\nCreates a full copy of the site under a new slug. All files are copied server-side — no upload needed. The new site is immediately live. Requires authentication and ownership of the source site.\n\nOptionally override viewer metadata (shallow-merged with the source):\n\ncurl -sS -X POST https://here.now/api/v1/publish/{slug}/duplicate \\\n  -H \"Authorization: Bearer {API_KEY}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"viewer\": {\"title\": \"My Copy\"}}'\n\nBeyond the script\n\nFor delete, metadata patch (including password protection), duplicate, claim, list, and other operations, see references/REFERENCE.md.\n\nHandle\n\nHandles are user-owned subdomain namespaces on here.now (for example, yourname.here.now) that route paths to your sites. Claiming a handle requires a paid plan (Hobby or above).\n\nHandle endpoints: /api/v1/handle\nHandle format: lowercase letters/numbers/hyphens, 2-30 chars, no leading/trailing hyphens\nCustom domains\n\nBring your own domain (e.g. example.com) and serve sites from it. Custom domains: 1 on Free, up to 5 on Hobby.\n\nDomain endpoints: /api/v1/domains and /api/v1/domains/:domain\nAdd a custom domain\ncurl -sS https://here.now/api/v1/domains \\\n  -H \"Authorization: Bearer {API_KEY}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"domain\": \"example.com\"}'\n\n\nResponse includes DNS instructions. Point an ALIAS record (or CNAME for subdomains) to fallback.here.now. SSL is provisioned automatically.\n\nMost domains use an ALIAS record (sometimes called ANAME or CNAME flattening). Subdomains (e.g. docs.example.com) can also use a standard CNAME record.\n\nCheck domain status\ncurl -sS https://here.now/api/v1/domains/example.com \\\n  -H \"Authorization: Bearer {API_KEY}\"\n\n\nStatus is pending until DNS is verified and SSL is active, then becomes active.\n\nList custom domains\ncurl -sS https://here.now/api/v1/domains \\\n  -H \"Authorization: Bearer {API_KEY}\"\n\nRemove a custom domain\ncurl -sS -X DELETE https://here.now/api/v1/domains/example.com \\\n  -H \"Authorization: Bearer {API_KEY}\"\n\n\nRemoves the domain and all links under it.\n\nLinks\n\nLinks connect a site to a location on your handle or a custom domain. The same endpoints work for both — omit the domain parameter to target your handle, or include it to target a custom domain.\n\nLink endpoints: /api/v1/links and /api/v1/links/:location\nRoot location sentinel for path params: __root__\nChanges propagate globally in up to 60 seconds (Cloudflare KV)\n\nLink to your handle:\n\ncurl -sS https://here.now/api/v1/links \\\n  -H \"Authorization: Bearer {API_KEY}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"location\": \"docs\", \"slug\": \"bright-canvas-a7k2\"}'\n\n\nLink to a custom domain:\n\ncurl -sS https://here.now/api/v1/links \\\n  -H \"Authorization: Bearer {API_KEY}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"location\": \"\", \"slug\": \"bright-canvas-a7k2\", \"domain\": \"example.com\"}'\n\n\nAn empty location makes it the homepage (e.g. https://example.com/). Use \"location\": \"docs\" for https://example.com/docs/.\n\nFull docs: https://here.now/docs"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/adamludwin/here-now",
    "publisherUrl": "https://clawhub.ai/adamludwin/here-now",
    "owner": "adamludwin",
    "version": "1.8.3",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/here-now",
    "downloadUrl": "https://openagent3.xyz/downloads/here-now",
    "agentUrl": "https://openagent3.xyz/skills/here-now/agent",
    "manifestUrl": "https://openagent3.xyz/skills/here-now/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/here-now/agent.md"
  }
}