CLI

rails-markup is a Thor CLI shipped with the gem. Run bin/rails-markup <command>.

Commands

Command	What it does
`server`	Start the HTTP + MCP server.
`init`	Interactive setup wizard (accent, position, size, FAB, screenshots, URL, MCP scope).
`mcp`	Start the MCP-only server (stdio).
`configure`	Set MCP env vars (`--global`, `--codex`, or local).
`status`	Show MCP config across all scopes.
`sessions`	List active annotation sessions (MCP mode).
`session ID`	Get a session with its annotations.
`watch`	Watch for new annotations (polls pending).
`pending`	Fetch pending annotations.
`resolve ID`	Resolve an annotation with a summary.
`resolve-all`	Resolve all pending annotations.
`dismiss ID`	Dismiss an annotation with a reason.
`reply ID MESSAGE`	Reply to an annotation thread.
`acknowledge ID`	Mark an annotation acknowledged.
`fetch [ENV]`	Fetch pending annotations (default: local dev).
`setup-production`	Generate a token and configure production access.
`man`	Full command reference with examples.
`version`	Print the version.

Examples

bin/rails-markup init                 # guided setup
bin/rails-markup pending              # what needs doing
bin/rails-markup resolve 42 --summary "Fixed the padding"
bin/rails-markup watch                # live loop for an agent

source: nauman/rails-markup · rev 1.2.1