@html-share/cli

Command-line client for the html-share service.

Requires Node.js 22+ (uses global fetch). No external dependencies.

Install

npm install -g @html-share/cli
htmlshare --help

または npx @html-share/cli <command> で都度実行も可能。

Usage

htmlshare login    [--server <url>] [--team <teamId>]
htmlshare logout
htmlshare init     <document|slide> [<output-path>] [--force]
htmlshare push     <local-file> <remote-path> [-m <msg>] [--base <n>] [--force] [--type slide|document] [--team <id>]
htmlshare pull     <remote-path> [<local-file>] [--version <n>] [--team <id>]
htmlshare ls       [<prefix>] [--team <id>]
htmlshare versions <remote-path> [--team <id>]

Login (OAuth 2.0 Device Authorization Grant)

htmlshare login
# Server URL [https://html-share.miyagawa-687.workers.dev]:
#
# ブラウザで以下の URL を開き、CLI のアクセスを許可してください:
#   https://html-share.miyagawa-687.workers.dev/device?user_code=ABCD-1234
# 表示されているコード: ABCD-1234

ブラウザで承認すると CLI が refresh_token を受け取り、 ~/.config/htmlshare/credentials.json (mode 0600) に { server, refresh_token, defaultTeamId } 形式で保存します。 各 API 呼び出し前に /api/auth/token から短命 JWT を自動取得して使用します。

複数 team に所属している場合は対話で default team を選択。 --team <id> を渡せば対話をスキップできます。

Init (テンプレート書き出し)

htmlshare init document               # -> ./document.html
htmlshare init slide my-deck.html     # -> ./my-deck.html

Push / Pull

htmlshare push ./slides.html /pj/intro.html -m "first draft" --type slide
htmlshare pull /pj/intro.html ./intro.html
htmlshare pull /pj/intro.html --version 3   # stdout に出力

1 MB を超えるファイルは拒否されます。HTTP 409 (楽観ロック競合) は終了コード 2 で、 サーバー側の最新バージョンを表示します。pull → merge → retry、 または --force で上書き。

List & versions

htmlshare ls /pj/
htmlshare versions /pj/intro.html

Logout

htmlshare logout

credentials ファイルを削除します。