How-to Guides
Step-by-step walkthroughs for every workflow RuneSpoke supports. 31 guides total.
Categories
Your first five minutes with RuneSpoke
A whirlwind tour of the platform. Open this if you just signed up and want to know what to click first.
Ship a PR end-to-end
From issue creation through deployment, using the gated ship pipeline (code → GitHub → QA → deploy).
Wire CI checks into the merge gate
Make the RuneSpoke Merge button enforce a green build from GitHub Actions, CircleCI, Travis, or any GitHub commit status provider.
Force-merge an emergency PR
How to bypass the approval + CI gate when you need to ship a hotfix RIGHT NOW. Every force-merge is recorded in the Audit Log.
Roll back a deploy
Re-deploy a previous Docker image tag to roll back. RuneSpoke does not auto-revert - you choose the target image.
Connect your AWS account
Wire AWS so RuneSpoke can deploy to EC2 via SSM, read CloudWatch metrics, scale via SDK, and send transactional email via SES.
Deploy a Docker image to EC2
How the actual deploy works under the hood - useful to read when troubleshooting a stuck deploy.
Read CloudWatch metrics in the Monitoring tab
Built-in CloudWatch dashboard per AWS connection - CPU, memory, network, request count.
Configure transactional email via AWS SES
RuneSpoke sends user invites, notifications, and password resets via AWS SES v2 (matching the production setup on runespoke.ai).
Add a user to your workspace
Invite a teammate via email. They get a magic link to set their password.
Scope an AI agent with ARC
Agent Access (ARC) controls what an AI agent - a coding agent, an automation workflow, an in-app assistant - may do on its own, propose for a human, or never touch. The agent runs on whatever LLM you bring (Claude, GPT, Gemini, …); ARC governs the actions, not the model. An agent can never exceed the person it acts for. This wires one up end-to-end.
Run a cloud agent
Hand an AI agent a task and a repo; it works autonomously in an isolated sandbox and opens a PR - every action governed by the agent's ARC policy, on your own model, with prod actions proposed for a human.
Preview and interact with your app
Run the app you're building in a sandbox and click through it in the browser - hit its API, log in, test it - before you push, PR, or deploy. Reached over a secure tunnel with no inbound ports, so it works behind any corporate firewall.
Team Chat - channels, threads, DMs
Real-time team messaging inside the Hub: public and private channels, threaded replies, emoji reactions, and direct messages - so the conversation lives next to your issues, PRs, and deploys.
Set up roles, permissions, and groups
RuneSpoke ships with 78 fine-grained permissions, system roles, and a groups system that lets you compose them. This is how you wire it up.
Review the Audit Log
Admin-only timeline of deploys, merges, reviews, group membership changes, and credential vault writes.
Store and rotate credentials in the vault
How encrypted credential storage works, and how to rotate without dropping connections.
Enable real-time updates (Supabase Realtime)
Wire Supabase Realtime so the notification bell, activity feed, and comments threads update without a refresh.
Scope issues, PRs, and wiki pages to projects
Why project scoping matters when you have more than one app, and how to use the per-project filter on every list view.
Manage team membership
Teams in the Issue Tracker are loose groups of users - useful for "assign this to the Frontend team" instead of a specific person.
Mirror GitHub issues into RuneSpoke
When you open an issue on GitHub, RuneSpoke can auto-create a matching row so all your work is visible in one place.
Edit, version, and restore a wiki page
Every wiki edit is versioned. Browse history, view any prior snapshot, and restore a revision (reversibly).
Build a wiki page hierarchy
Pages can nest under a parent so your docs grow into a real handbook instead of a flat list.
Start pages from a template
Built-in templates seed common doc structures (guides, technical specs, process docs).
Use Cmd+K global search
One box to find any issue, PR, wiki page, user, or project across the platform.
Comment on issues and PRs
Comments are polymorphic - one table, multiple targets. Mentioning watchers fires notifications.
Use the Activity feed
The "what just happened" timeline. Pulls from issues, PRs, reviews, comments, and deploys.
Manage your notifications
The bell icon in the top-right is per-user. Notifications fire on issue assignments, PR reviews, merges, deploys, and comments.
Connect GitHub via OAuth
How to register the OAuth app and connect your account so RuneSpoke can read PRs, sync state, and pull CI checks.
Connect Slack for notifications + /runespoke slash commands
Set up Slack OAuth so RuneSpoke can post notifications and respond to /runespoke commands.
Configure Anthropic Claude as your AI provider
Set up Claude for code review, chat assistance, and the unified AI service.