{
  "markdown": "# wovo\n\nDeploy any HTML — from any AI tool or your terminal — to a **versioned, shareable library**. `wovo` is the CLI and MCP server for [wovo.dev](https://wovo.dev).\n\nEvery deploy snapshots a new version, returns a live URL, and files the page in your workspace library. Re-deploying the same slug never overwrites — it appends a version you can roll back to.\n\n## Install\n\nRun it one-off with `npx`:\n\n```bash\nnpx @gowovo/wovo deploy ./report.html\n```\n\nOr install globally and use the `wovo` command:\n\n```bash\nnpm i -g @gowovo/wovo\nwovo deploy ./report.html\n```\n\n## Connect (recommended)\n\nOne command — it opens your browser to sign in, then wires up your AI tool. **No token to copy.**\n\n```bash\nnpx @gowovo/wovo setup\n```\n\nFrom then on, just tell your agent \"deploy this to Wovo\" and the page lands in your library.\n\n### Manual auth (CI / headless)\n\nWhen there's no browser (CI, a server), provide a **deploy token** from your workspace settings on [wovo.dev](https://wovo.dev) via env, a config file, or `--token`:\n\n```bash\nexport WOVO_TOKEN=\"wv_…\"\nexport WOVO_WORKSPACE=\"my-workspace\"\n```\n\n## CLI\n\n```bash\nwovo setup               # connect your AI tool: browser sign-in + skill + MCP + test deploy\n                         #   --scope project|user        this project, or every project on this machine\n                         #   --behavior auto|ask|manual  publish automatically, offer first, or only on request\nwovo deploy <file|dir>   # deploy one .html, or every .html under a folder\nwovo list                # list pages in the workspace\nwovo pages archive <slug>          # hide a page from the library (link still works)\nwovo pages unarchive <slug>        # restore an archived page\nwovo pages move <slug> --space S   # change a page's space\nwovo pages rename <slug> <new>     # change a page's path; old links redirect\nwovo domains list                  # custom domains\nwovo domains add <d> --page <slug> # link a domain (prints DNS records)\nwovo domains status <d>            # re-check DNS / verification\nwovo domains remove <d>            # unlink a domain\n```\n\n| Flag | Default | What it does |\n|------|---------|--------------|\n| `--workspace W` | env `WOVO_WORKSPACE`, else resolved from the token | Target workspace |\n| `--space S` | top folder name | Group pages under a space |\n| `--tool T` | `cli` | Source-tool tag |\n| `--slug S` | derived from path | Explicit slug (single-file deploys) |\n| `--url U` | env `WOVO_URL` or `https://wovo.dev` | Wovo base URL |\n| `--token T` | env `WOVO_TOKEN` | Deploy token |\n\n**Config resolution:** CLI flags → `./wovo.json` → env (`WOVO_URL`, `WOVO_TOKEN`, `WOVO_WORKSPACE`).\n\n```jsonc\n// wovo.json\n{ \"workspace\": \"my-workspace\", \"token\": \"wv_…\", \"space\": \"reports\" }\n```\n\n### Examples\n\n```bash\nWOVO_TOKEN=… wovo deploy ./report.html --workspace acme\nwovo deploy ./site --workspace acme --tool claude-code\nwovo list --workspace acme\n```\n\n## MCP server\n\n`wovo` also ships an [MCP](https://modelcontextprotocol.io) server (`wovo-mcp`) so AI agents can deploy and list pages as tools. Register it with Claude Code:\n\n```bash\nclaude mcp add wovo \\\n  --env WOVO_TOKEN=wv_… \\\n  --env WOVO_WORKSPACE=my-workspace \\\n  -- npx -y -p @gowovo/wovo wovo-mcp\n```\n\nTools: `wovo_deploy` (inline `html` or a file `path`), `wovo_list`, `wovo_pages_archive`,\n`wovo_pages_unarchive`, `wovo_pages_move`, `wovo_pages_rename`, `wovo_domains_list`,\n`wovo_domains_add`, `wovo_domains_remove`, `wovo_domains_status`.\n\n## Requirements\n\nNode.js **>= 18** (uses the global `fetch`). Zero dependencies for the CLI; the MCP server uses `@modelcontextprotocol/sdk` and `zod`.\n\n## License\n\nMIT © Shashank Jha\n",
  "bytes": 3636,
  "sha": "5988c71031c8f63ad3f02f3f82c63dc16f25fc650453f5f61f6afc8f7af6cddf",
  "repo_slug": "theshajha/wovo-cli",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_theshajha_wovo_ce97c102/readme"
}