typress
An editorial workshop.EN

CLI

typress の本体は、サーバーとして動くほかに、いくつかのコマンドを持っています。

コマンド一覧

  • typress: サーバーとして起動
  • typress setup: セットアップ画面(root で実行。インストーラーが自動で呼びます)
  • typress admin …: 管理用コマンド(下記)
  • typress mcp: AI アシスタント用の MCP サーバー
  • typress relay: リモートアクセス用の中継サーバー

typress admin

どれも TYPRESS_DATA_DIR のデータベースを直接開きます。サーバーが動いていても使えます。本番では設定ファイルを読み込ませて、typress ユーザーで実行します。

sudo systemd-run --quiet --pipe --wait -p User=typress \
  -p EnvironmentFile=/etc/typress/typress.env \
  /opt/typress/typress admin list-users
  • list-users: ユーザーの一覧
  • reset-password <email>: パスワードを再設定(そのユーザーのログインはすべて切れます)
  • make-admin <email>: 管理者に昇格
  • totp-disable <email>: 2 段階認証を解除
  • self-update <manifest-url>: 署名つきの更新情報からバイナリを入れ替え(TYPRESS_UPDATE_KEYS が必要)。前のバイナリは ${TYPRESS_DATA_DIR}/typress.previous に残ります。

typress mcp

Claude などの AI アシスタントから、記事を読んだり下書きを作ったりできるようにします。標準入出力で動き、--grant で許可した操作だけが使えます。

  • read(既定): 投稿・ページ・タグ・コメントを読む
  • draft: 下書きを作る・編集する
  • publish: 公開・非公開にする
  • moderate: コメントを承認・スパムにする
{
  "command": "/opt/typress/typress",
  "args": ["mcp", "--grant", "read,draft"]
}

--as <email> で操作するユーザーを指定できます(既定は最初の管理者)。

typress relay

スマホアプリから、外から直接届かないサイトを管理するための中継サーバーです。中身は端末とサイトの間で暗号化され、中継は中身を見られません。データも保存しません。typress は公開の中継を運営していないので、使う場合は自分で立てます。

typress relay --port 8443

サイト側は、管理画面の「リモートアクセス」で中継の URL を入れて有効にします。