Skip to main content
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.
AgentDescription
Cursor Background AgentsLaunches a Cursor background agent via API key. Writes code, creates branches, and opens PRs.
DevinLaunches a Devin session via API key. Writes code, creates branches, and opens PRs.
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" or harness: "devin"
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.
AgentDescription
Claude Code WebSends task to Claude Code in the cloud
CodexSends task to OpenAI Codex
Cursor LocalSends task to your local Cursor instance
Copy & PasteCopies the task prompt for manual use in any agent
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:
SourceDescription
LinearAttach Linear tickets for context; agent can update ticket status
AsanaAttach Asana tasks for context; agent can update task fields and add comments
GitHub Issues & PRsAttach GitHub issues and PRs; track PRs linked to plans

Cursor Background Agents

Launch Cursor background agents from your plans.

Devin

Launch Devin sessions from your plans.

Claude Code Web

Send tasks to Claude Code in the cloud.

Codex

Send tasks to OpenAI Codex.

Linear

Connect Linear tickets to your plans.

Asana

Connect Asana tasks to your plans.

GitHub

Connect GitHub issues and PRs to your plans.