wovo

wovo

あらゆる AI ツールやターミナルから、HTML をバージョン管理され、共有可能なライブラリにデプロイできます。wovo は wovo.dev の CLI および MCP サーバーです。

デプロイするたびに新しいバージョンのスナップショットが作成され、公開 URL が返され、ページがワークスペースのライブラリに保存されます。同じスラッグに再デプロイしても上書きされず、いつでもロールバックできるバージョンが追加されます。

インストール

npx で一時的に実行します：

npx @gowovo/wovo deploy ./report.html

または、グローバルにインストールして wovo コマンドを使います：

npm i -g @gowovo/wovo
wovo deploy ./report.html

接続（推奨）

コマンドを 1 つ実行するだけです。ブラウザーが開いてサインインすると、AI ツールが設定されます。トークンをコピーする必要はありません。

npx @gowovo/wovo setup

以降は、エージェントに「これを Wovo にデプロイして」と伝えるだけで、ページがライブラリに保存されます。

手動での認証（CI／ヘッドレス環境）

ブラウザーが使えない場合（CI やサーバーなど）は、wovo.dev のワークスペース設定から取得したデプロイトークンを、環境変数、設定ファイル、または --token で指定します：

export WOVO_TOKEN="wv_…"
export WOVO_WORKSPACE="my-workspace"

CLI

wovo setup               # connect your AI tool: browser sign-in + skill + MCP + test deploy
                         #   --scope project|user        this project, or every project on this machine
                         #   --behavior auto|ask|manual  publish automatically, offer first, or only on request
wovo deploy <file|dir>   # deploy one .html, or every .html under a folder
wovo list                # list pages in the workspace
wovo pages archive <slug>          # hide a page from the library (link still works)
wovo pages unarchive <slug>        # restore an archived page
wovo pages move <slug> --space S   # change a page's space
wovo pages rename <slug> <new>     # change a page's path; old links redirect
wovo domains list                  # custom domains
wovo domains add <d> --page <slug> # link a domain (prints DNS records)
wovo domains status <d>            # re-check DNS / verification
wovo domains remove <d>            # unlink a domain

フラグ	デフォルト	説明
--workspace W	環境変数 WOVO_WORKSPACE。未設定の場合はトークンから解決	対象のワークスペース
--space S	トップフォルダー名	スペースごとにページをグループ化
--tool T	cli	ソースツールのタグ
--slug S	パスから生成	明示的なスラッグ（単一ファイルのデプロイ）
--url U	環境変数 WOVO_URL、または https://wovo.dev	Wovo のベース URL
--token T	環境変数 WOVO_TOKEN	デプロイトークン

設定の解決順序： CLI フラグ → ./wovo.json → 環境変数（WOVO_URL、WOVO_TOKEN、WOVO_WORKSPACE）。

// wovo.json
{ "workspace": "my-workspace", "token": "wv_…", "space": "reports" }

使用例

WOVO_TOKEN=… wovo deploy ./report.html --workspace acme
wovo deploy ./site --workspace acme --tool claude-code
wovo list --workspace acme

MCP サーバー

wovo には MCP サーバー（wovo-mcp）も含まれており、AI エージェントがツールを使ってページをデプロイしたり、一覧表示したりできます。Claude Code に登録します：

claude mcp add wovo \
  --env WOVO_TOKEN=wv_… \
  --env WOVO_WORKSPACE=my-workspace \
  -- npx -y -p @gowovo/wovo wovo-mcp

ツール：wovo_deploy（インラインの html またはファイルの path）、wovo_list、wovo_pages_archive、 wovo_pages_unarchive、wovo_pages_move、wovo_pages_rename、wovo_domains_list、 wovo_domains_add、wovo_domains_remove、wovo_domains_status。

要件

Node.js >= 18（グローバルな fetch を使用します）。CLI は依存関係ゼロです。MCP サーバーは @modelcontextprotocol/sdk と zod を使用します。

ライセンス

MIT © Shashank Jha