Skip to content

Repository files navigation

Roadrunner Admin plugin

Install Roadrunner's administration capabilities in Claude Code or Codex. The plugin connects to Roadrunner's hosted MCP server using your existing Roadrunner identity through OAuth; it does not contain credentials or backend implementation code.

Note

This is a preview distribution scaffold. Roadrunner enables capabilities separately for each tenant, and the available capability set will expand over time.

Prerequisites

  • A Roadrunner account with access to the tenant you want to administer
  • Admin MCP enabled for that tenant by Roadrunner
  • A current Claude Code or Codex installation

Install in Claude Code

claude plugin marketplace add roadrunner-tuff/roadrunner-admin-plugin
claude plugin install roadrunner-admin@roadrunner

Start a new Claude Code session, open /mcp, and complete the Roadrunner sign-in flow when prompted.

To update later:

claude plugin marketplace update roadrunner
claude plugin update roadrunner-admin@roadrunner

Install in Codex

codex plugin marketplace add roadrunner-tuff/roadrunner-admin-plugin
codex plugin add roadrunner-admin@roadrunner

Complete the Roadrunner OAuth prompt during installation, then start a new Codex session so the plugin's skill and MCP tools are loaded.

Use

Ask the client to show the Roadrunner admin capabilities available to you, or invoke the roadrunner-admin skill explicitly. The skill discovers the live capability catalog before attempting an operation, so newly released server capabilities do not require a plugin update.

Installing this public package does not grant Roadrunner access. The server validates the signed-in user, selected organization, active tenant membership, tenant enablement, and capability permissions on every call.

Development

Run the repository checks:

python3 scripts/validate.py
claude plugin validate --strict .

Local marketplace testing:

claude plugin marketplace add .
claude plugin install roadrunner-admin@roadrunner

codex plugin marketplace add .
codex plugin add roadrunner-admin@roadrunner

Use isolated client profiles when testing so local development does not replace an installed release.

Security and privacy

Licensed under the Apache License 2.0.

About

Installable Roadrunner Admin plugin for Claude Code and Codex

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages