Documentation

Everything you need to know about RuneSpoke Hub

IDE & CLI Extensions

Connect your editor or command-line tool to RuneSpoke so AI chat, file access, and project context all flow through one workspace. Each registration produces a unique API key - paste it into the extension config and you're live.

The 3-step flow (same for every IDE)

  1. 1Install the extension for your IDE (instructions per-IDE below).
  2. 2Open Dashboard → Extensions → click Register extension → pick your IDE → name it → submit.
  3. 3Copy the API key from the yellow banner (shown once) and paste it into your extension's connection prompt.

What you get when you connect

Realtime project sync

Files, open tabs, terminal output, and cursor position stream into the dashboard - no copy-paste.

One AI router, every IDE

The platform picks the best AI provider (Claude, GPT-4, Gemini) per request based on your tier rules. Same routing whether you ask from VS Code, Vim, or the web.

Shared issue + wiki context

Your extension can read open RuneFlow issues and link to wiki pages without leaving the editor.

Per-key permissions

Each registration carries its own permission scope. Want a read-only key for a teammate? Uncheck file-access and code-generation.

Setup by IDE

Cursor IDE

The RuneSpoke plugin for Cursor ships as a VSIX. It uses an embedded WebSocket bridge so you get realtime sync with the dashboard.

ai-chatfile-accessproject-analysiscode-generation

Install

  1. 1Download the latest VSIX
    /runespoke-cursor-0.1.0.vsix
  2. 2In Cursor: Cmd-Shift-P → "Extensions: Install from VSIX..."
  3. 3Select the downloaded file and reload Cursor when prompted.

Configure

  1. 1Open the RuneSpoke panel from the activity bar (the rune icon).
  2. 2Click "Connect to RuneSpoke Hub" and paste the API key from the dashboard.
  3. 3Cursor will show "Connected" once the bridge handshake completes.

VS Code

Same plugin as Cursor (Cursor is a VS Code fork). Install from the marketplace or from the VSIX.

ai-chatfile-accessproject-analysiscode-generation

Install

  1. 1Marketplace link
    vscode:extension/runespoke.runespoke-companion
  2. 2Or download the VSIX
    /runespoke-cursor-0.1.0.vsix
  3. 3In VS Code: Cmd-Shift-P → "Extensions: Install from VSIX..."

Configure

  1. 1Cmd-Shift-P → "RuneSpoke: Connect".
  2. 2Paste the API key from the dashboard.
  3. 3The status bar shows "RuneSpoke ✓" when connected.

Claude Code CLI

A thin bridge that lets Claude Code (the official CLI from Anthropic) talk to your RuneSpoke workspace, AI router, and issue tracker.

ai-chatterminal-accessproject-analysis

Install

  1. 1Install via npm
    npm install -g @runespoke/claude-cli
  2. 2Verify the install
    runespoke-claude --version

Configure

  1. 1In your project directory, run:
  2. 2runespoke-claude connect
  3. 3When prompted, paste the API key from the dashboard.
  4. 4The CLI writes the connection to ~/.runespoke/config.json and you can start using Claude Code with full workspace context.

JetBrains IDEs

Works across IntelliJ IDEA, WebStorm, PyCharm, GoLand, Rider, and CLion - one plugin, all IDEs.

ai-chatfile-accessproject-analysiscode-generation

Install

  1. 1JetBrains Marketplace
    https://plugins.jetbrains.com/plugin/runespoke
  2. 2Or in IDE: Settings → Plugins → search "RuneSpoke" → Install
  3. 3Restart the IDE.

Configure

  1. 1Settings → Tools → RuneSpoke.
  2. 2Paste the API key in the "API Key" field.
  3. 3Click "Test Connection". Save.

Vim / Neovim

Lightweight Lua plugin (Neovim) with Vim 8+ compatibility.

ai-chatterminal-accesscode-generation

Install

  1. 1vim-plug
    Plug 'runespoke/runespoke-vim'
  2. 2Lazy.nvim
    { 'runespoke/runespoke-vim' }
  3. 3Then in Vim:
    :PlugInstall

Configure

  1. 1:RunespokeConnect
  2. 2Paste the API key when prompted.
  3. 3:Runespoke chat to start an inline AI session.

Sublime Text

Package Control-installable RuneSpoke companion.

ai-chatfile-accesscode-generation

Install

  1. 1Cmd-Shift-P → Package Control: Install Package
  2. 2Search for "RuneSpoke" and install.

Configure

  1. 1Preferences → Package Settings → RuneSpoke → Settings.
  2. 2Set the api_key field to the key from the dashboard.

Emacs

MELPA-installable runespoke.el package.

ai-chatterminal-accesscode-generation

Install

  1. 1M-x package-install RET runespoke RET
  2. 2Add to init.el
    (require 'runespoke)

Configure

  1. 1M-x runespoke-connect
  2. 2Paste the API key when prompted.
  3. 3Set runespoke-api-key in customize for persistence.

Security notes

  • API keys are hashed (pbkdf2, 100k iterations, sha256) before storage. We can't recover them - that's why the dashboard shows the plaintext key once at registration time.
  • Keys expire after 90 days by default. The dashboard surfaces any registration expiring within 7 days in the stats bar.
  • Revoke instantly from the dashboard - the extension loses access on its next request, no restart needed.
  • If you suspect a key was leaked, revoke it and register a new one. Never commit your API key to git.

Troubleshooting

"Invalid API key" error in the IDE
Double-check the key has no extra whitespace. If you copy-pasted from the yellow banner, the entire string starting with the prefix (cur_, vsc_, cli_, etc.) must be intact. If you lost the key, you have to register a new extension - we can't recover it from the hash.
Extension shows connected but no AI responses
Check Integrations → AI providers - your account needs at least one configured AI provider (Anthropic, OpenAI, Google) for the router to use. Without one, every chat request will 503.
Key expired - what now?
Open Dashboard → Extensions, delete the expired row, register a new one. We don't auto-renew because rotation is a feature - extensions get fresh credentials by design.
Can I have multiple devices with the same IDE?
Yes - register each one separately. Name them clearly (e.g. “MacBook Pro - Cursor”, “Linux Dev Box - Cursor”) so you can revoke a single device without affecting the others.
Still stuck? Open an issue in RuneFlow or check the help center.