Tagviu Docs
↗
Open app ↗

tagviu

CLI usage

Create a Dev Environment in the dashboard, copy the secret from View, pair once, then inspect local URLs. Public URLs work without pairing unless you pass --save.

Quick start

# Optional: point at a local Tagviu instance
export TAGVIU_API_URL=http://localhost:3000

# From Dashboard → Developer → View
tagviu login api_…

tagviu whoami
tagviu http://localhost:3000
tagviu http://127.0.0.1:3000 --json
tagviu https://orashus.com
tagviu https://orashus.com --save --json
tagviu mcp
tagviu logout

Human output (example)

$ tagviu http://localhost:3000
✓ Fetched http://localhost:3000
✓ Tagviu inspection complete

Preview (expires in ~1h):
https://tagviu.orashus.com/local-preview/lp_…

Public URL (example)

$ tagviu https://orashus.com
✓ Tagviu inspection complete
Score: 87/100

$ tagviu https://orashus.com --save
✓ Tagviu inspection complete
Score: 87/100

Preview:
https://tagviu.orashus.com/local-preview/lp_…

Commands

  • tagviu login <secret>

    Pair this machine to a Dev Environment. Copy the secret from Dashboard → Developer → View.

  • tagviu whoami

    Confirm the paired account / environment is still valid on this machine.

  • tagviu <localhost-url> [--json]

    Fetch loopback HTML locally, submit it to Tagviu, print the ephemeral preview URL (and JSON with --json). Always saves a LocalPreview.

  • tagviu <public-url> [--json] [--save]

    POST /api/inspect (Tagviu fetches the page). Default does not persist. --save requires pairing and creates a LocalPreview (data.url).

  • tagviu mcp

    Local MCP stdio (inspect_local_url + inspect_remote_url). Uses TAGVIU_API_KEY if set, otherwise credentials.json. JSON-RPC on stdout only - no help banners.

  • tagviu logout

    POST /api/cli/logout to unbind the machine, then clear the local credentials file.

  • tagviu --version / --help

    Print version or usage.

Environment

TAGVIU_API_URL

API base URL. Default https://tagviu.orashus.com.

TAGVIU_API_KEY

Optional environment secret. If set, the CLI and local MCP use it instead of credentials.json.

Exit codes

  • 0Success
  • 1General error
  • 2Invalid arguments
  • 3Auth / pairing failure
  • 4Local fetch failed
  • 5Tagviu API error