Concepts
Product-facing vocabulary for events, source plugins, workflow plugins, providers, and bridge room delivery.
Documentation gateway
Start with the overview, then jump into the contracts.
Rainrail keeps product narrative in this site and durable engineering decisions in the self-hosted developer docs.
Start here
Guides
Initial operating guides for GitHub issue automation, PR review follow-up, and Cloudflare event reporting.
Examples
An end-to-end GitHub issue to Project queue to agent PR to review and merge path.
Plugin runtime contract
Source plugin, workflow plugin, and runtime provider boundaries.
Engineering docs index
Public developer docs for contracts, operations, deployment notes, and examples.
GitHub webhook normalization
How GitHub webhook payloads become neutral Rainrail events.
Cloudflare Worker operations
Deploy, required secrets, local development, and production smoke testing.
Cloudflare Pages operations
Preview deploys, production deploys, required secrets, and product site smoke testing.
GitHub-only engineering notes
Internal source specs such as product-site IA stay in GitHub and are not part of public docs navigation.
GitHub repository
Source code, pull requests, workflows, and repository history.
Issue tracker
Open implementation work, bugs, follow-up tasks, and product site improvements.
CLI quick start
Install the Rainrail CLI with Node.js 22.13 or newer available on your machine.
curl -fsSL https://rainrail.dev/install.sh | bash -s -- --add-to-shell --yes
exec $SHELL
rainrail helpFirst-use smoke test
Run a minimal first-use smoke test in a disposable directory. Use rainrail <plugin> help for each plugin's command details.
mkdir -p ~/rainrail-sandbox
cd ~/rainrail-sandbox
mkdir my-agent-ops
cd my-agent-ops
rainrail init
cat rainrail.config.json
rainrail openclaw help
rainrail openclaw session test help