typress
An editorial workshop.日本語

CLI

Besides running the server, the typress binary has a few commands.

Commands

  • typress: start the server
  • typress setup: the setup screen (run as root; the installer calls it)
  • typress admin …: admin commands, below
  • typress mcp: an MCP server for AI assistants
  • typress relay: a relay for remote access

typress admin

Each one opens the database in TYPRESS_DATA_DIR directly and works while the server runs. In production, load the settings file and run as the typress user:

sudo systemd-run --quiet --pipe --wait -p User=typress \
  -p EnvironmentFile=/etc/typress/typress.env \
  /opt/typress/typress admin list-users
  • list-users: list users
  • reset-password <email>: set a new password (signs that user out everywhere)
  • make-admin <email>: promote to admin
  • totp-disable <email>: turn off two-factor
  • self-update <manifest-url>: replace the binary from a signed manifest (needs TYPRESS_UPDATE_KEYS). The old binary stays at ${TYPRESS_DATA_DIR}/typress.previous.

typress mcp

Lets an AI assistant such as Claude read posts or write drafts. It speaks over stdio, and only the operations you grant with --grant exist.

  • read (default): read posts, pages, terms and comments
  • draft: create and edit drafts
  • publish: publish and unpublish
  • moderate: approve comments or mark them spam
{
  "command": "/opt/typress/typress",
  "args": ["mcp", "--grant", "read,draft"]
}

--as <email> picks the acting user (default: the first admin).

typress relay

A relay that lets the phone app manage a site it can't reach directly. Traffic is encrypted between the device and the site; the relay can't read it and stores nothing. typress runs no public relay, so you run your own.

typress relay --port 8443

On the site, enter the relay URL under Remote access and turn it on.