Integrations Overview

Ref Plans integrates with coding agents (where you send tasks for implementation) and context sources (where you pull planning context from).

​

Cloud agents (API-based)

Cloud agents connect directly through API keys. Ref launches the agent and tracks its progress automatically — no manual intervention required. These agents can also be launched programmatically by an orchestrator agent via the LaunchAgent MCP tool as part of multi-agent orchestration. Cloud agents provide:

• Automatic launch — Ref starts the agent session for you
• Status tracking — Progress updates flow back to Ref automatically
• Orchestration support — Can be launched by an orchestrator agent via LaunchAgent with harness: "cursor", harness: "devin", or harness: "warp-oz"

Configure API keys in Settings > Agent Settings at plan.ref.tools.

​

Launcher agents (webhook-based)

Launcher agents work by appending progress-reporting instructions (curl commands) to the task prompt. You initiate the agent session yourself, and the agent reports back to Ref by executing the webhook commands included in the prompt. Launcher agents require you to:

1. Click Launch Agent in the plan UI to generate the prompt
2. Start the agent session yourself (or paste the prompt)
3. The agent executes the embedded webhook commands to report progress back to Ref

​

Context sources

Pull context from your project management and development tools into your plans:

​

Custom MCP servers

Connect your own remote MCP server to make its tools available to ref-thread agents. Custom MCP servers are configured in Settings and can be attached per thread from the message composer — see Custom MCP Servers.

​

Custom Launchers

Use Custom Launchers to deep-link into Ref from any tool that can construct a URL. The /new URL can seed plan content and optionally start an agent thread immediately.