Skip to main content
Install local RELAI guidance once, restart the host, then use short prompts while the plugin follows the current CLI workflow and your selected permission profile.

​
Supported interfaces

  • Codex CLI and desktop
  • Claude Code and desktop
  • Cursor
  • GitHub Copilot
Installing guidance is local and does not require the corresponding coding-agent CLI to be installed or authenticated. Live interaction still depends on the host: Cursor must expose its native ask-questions tool, and GitHub Copilot must run in an interactive session with ask_user. Copilot cloud-agent and other headless sessions cannot complete workflows that need an answer.
Plugin availability is not identical workflow parity.Each host can load the guidance, but a workflow stops with an actionable message when that host cannot present RELAI’s typed question or approval.

​
Install local guidance

If you already ran relai setup --agent <host>, the guidance for that host is installed; restart or reload it and continue. Use the commands below to add another host or refresh the bundled guidance later.

Follow https://cli-docs.relai.ai/plugins to install the RELAI integration for this coding agent. Preserve unrelated settings and tell me when I need to restart or reload the host.

Installation is local and idempotentYou can rerun the install command after a RELAI update. It preserves unrelated host settings and unowned plugin or skill directories.

​
What the plugin does

Uses the installed CLI

The guidance checks the available command help instead of assuming flags from an older release.

Respects permissions

The plugin follows auto, accept_edits, or ask. Use ask when you want consequential actions to pause for review.

Explains artifacts

Ask for scenarios, conversations, scores, file locations, and before-and-after optimizer evidence in normal language.

​
Your first plugin prompt

Use RELAI to check whether this agent project is ready. Keep the check read-only and explain any blockers.

​
Optional: share the proactive workflow policy

After initialization succeeds, the plugin may offer to install RELAI’s shared proactive policy so collaborators using repository instructions can recognize when a conversation should update EvalsWiki, reuse existing coverage, create grounded coverage, or run a focused simulation. Installation always requires explicit approval.
The policy has narrow file boundariesrelai policy install updates only existing regular AGENTS.md and CLAUDE.md files at the repository root. It never creates an instruction file, follows a symlink, or changes nested instruction files. It validates every target before changing any of them and fails without writes if no eligible root file exists.
Run only after reviewing and approving the shared policy:
remove never deletes the instruction file or unrelated content. Both commands are idempotent.

Plugin active?

Run the guided sample or use the Quickstart on your own repository.