pages

name	pages
version	0.9.0
description	Markdown-to-HTML rendering component for zylos. Renders .md files as beautifully styled web pages with code highlighting, dark/light theme, and table of contents. Use when writing reports, documentation, or any content that should be published as a web page. Agent writes a .md file, it's immediately accessible via URL.
type	capability
lifecycle	{"npm":true,"service":{"type":"pm2","name":"zylos-pages","entry":"src/index.js"},"data_dir":"~/zylos/components/pages","hooks":{"post-install":"hooks/post-install.js","pre-upgrade":"hooks/pre-upgrade.js","post-upgrade":"hooks/post-upgrade.js"},"preserve":["config.json"]}
upgrade	{"repo":"zylos-ai/zylos-pages","branch":"main"}
config	{"optional":[{"name":"PAGES_PORT","description":"HTTP port for the pages service","default":"3462"}]}
http_routes	[{"path":"/pages/*","type":"reverse_proxy","target":"localhost:3462","strip_prefix":"/pages"}]
dependencies	[]

Zylos Pages

Render Markdown and HTML files as styled web pages.

Agent CLI (Local DB)

Use this CLI when an agent needs to register local Markdown/HTML files, manage share links, or add an allowed source root. It runs locally and writes the Pages DB/config directly; it does not use HTTP or tokens.

PAGES_DIR="~/.claude/skills/pages"

# Register a local source file as a logical page. Default access is private.
node $PAGES_DIR/src/cli/pages.js register --source /absolute/report.md --uri reports/q3 --title "Q3 Report"

# List registered logical pages.
node $PAGES_DIR/src/cli/pages.js list

# Inspect live share links. Protection metadata is included, never plaintext.
node $PAGES_DIR/src/cli/pages.js shares reports/q3
node $PAGES_DIR/src/cli/pages.js shares --all

# The inverse: someone hands you a link, find out which document it is.
# Resolves expired and revoked links too, and takes the full URL or the token.
node $PAGES_DIR/src/cli/pages.js share-info https://domain/s/<token-id>

# Mint an unprotected link. NOT a default step — see Sharing below.
node $PAGES_DIR/src/cli/pages.js share reports/q3 --duration 7d

# Mint a protected link with a generated password. This explicit command
# returns the secret on stdout; deliver it only through the intended private DM.
node $PAGES_DIR/src/cli/pages.js share reports/q3 --duration 7d --password

# A provided password is read from stdin, never argv or a URL.
printf '%s\n' "$SHARE_SECRET" | node $PAGES_DIR/src/cli/pages.js share reports/q3 --password-stdin

# Explicit repeat retrieval. Ordinary shares/share-info never return plaintext.
node $PAGES_DIR/src/cli/pages.js share-password get https://domain/s/<token-id>

# Manage the password of an EXISTING share without changing its URL.
# enable/rotate generate a 6-digit password (or take one on stdin) and print

node /src/cli/pages.js share-password  https://domain/s/<token-id>
   | node /src/cli/pages.js share-password rotate <token-id> --password-stdin
node /src/cli/pages.js share-password  <token-id>






node /src/cli/pages.js unshare --token <token-id>
node /src/cli/pages.js unshare reports/q3



node /src/cli/pages.js unregister reports/q3


node /src/cli/pages.js allow-root add /absolute/reports --name reports