Get Ref Plans running at full power in about ten minutes.
In this guide you’ll connect a repo, plan a feature with AI, and hand off the work to coding agents that open PRs for you. It takes about ten minutes.By the end you’ll have a connected repo, a configured agent, and a clear path from rough idea to merged code.
1
Sign up
Create an account at plan.ref.tools. You’ll land on a blank doc — your space to think through what you want to build.
2
Connect your codebase
Link a GitHub repo so Ref can read your code and write plans that match your architecture.
Select the repos you want to index and click Add to Ref
Once indexed, Ref can read files, find existing patterns, and reference them when structuring your tasks.
3
Pick a coding agent
Choose which coding agent Ref should use to implement your tasks.
Open Settings (gear icon)
Click the Agents tab
Select an agent and follow the setup instructions below
Cursor
Devin
Warp OZ
Claude Code, Codex, and more
1. Add your API keyPaste your Cursor API key in the Agents settings tab. Get one from cursor.com/dashboard under the Cloud Agents tab.
2. (Optional) Install MCP server so agents can send messages and access the plan directly
Installing the Ref Plans MCP server lets Cursor read, write, and collaborate on plan documents. It’s optional for single-agent workflows but required for multi-agent orchestration.Add the MCP serverOpen cursor.com, click MCPs, click the + button and select Custom MCP then fill in the form or json as follows.
Replace YOUR_REF_API_KEY with your key from ref.tools/keys.Configure security rulesCursor’s cloud agents run in a sandbox that blocks external network requests by default. You need to allowlist api.plan.ref.tools so the agent can reach the MCP server.In the Cursor dashboard, go to Cloud Agents > Security Rules and add api.plan.ref.tools to the allowed domains.See the full Cursor MCP install guide for details.
2. (Optional) Install MCP server so agents can send messages and access the plan directly
Installing the Ref Plans MCP server lets Devin read, write, and collaborate on plan documents. It’s optional for single-agent workflows but required for multi-agent orchestration.Add the MCP serverIn the Devin dashboard, go to Settings > MCP Marketplace and click Add MCP Server:
Name:ref-plan
URL:https://api.plan.ref.tools/mcp
Add a header x-ref-api-key with your API key from ref.tools/keys
Click Enable
Configure security rulesDevin runs in a sandboxed environment. If your workspace has network restrictions, ensure api.plan.ref.tools is allowed. Devin typically permits MCP server URLs automatically once enabled.See the full Devin MCP install guide for details.
1. Add your API keyPaste your Warp API key (starts with wk-...) in the Agents settings tab. In the Warp desktop app, open Settings > Platform and create an API key.
Environment ID (optional) — most users with a single environment can leave this blank.
2. (Optional) Install MCP server so agents can send messages and access the plan directly
Installing the Ref Plans MCP server lets Warp read, write, and collaborate on plan documents. It’s optional for single-agent workflows but required for multi-agent orchestration.See the MCP install docs for step-by-step setup. If your environment restricts outbound network access, ensure api.plan.ref.tools is allowed.
1. No API key neededThese work as launcher agents — Ref generates a prompt with embedded webhook commands. You paste it into the agent yourself, and it reports progress back via the webhooks.Supported launchers:
Claude Code Web
Codex (Cloud and Desktop)
Factory
Windsurf
Zed
GitHub Copilot
Cursor Desktop
2. (Optional) Install MCP server so agents can send messages and access the plan directly
Installing the Ref Plans MCP server lets these agents read, write, and collaborate on plan documents directly. It’s optional for single-agent workflows but required for multi-agent orchestration.See the MCP install docs for step-by-step setup instructions for your agent.
4
Write down what you're working on
No need for perfect formatting — just get your ideas down:
A rough description of the feature or bug
Links to a Linear ticket or GitHub issue
A schema, API shape, or data model
Bullet points, stream of consciousness, whatever gets it across
This is your thinking space. Get everything important out of your head and onto the page.If you want to pull in context from Linear, Asana, or GitHub Issues, you’ll need to connect those first — see the Integrations guide for setup.
5
Build the plan with Ref
Open the chat panel and ask Ref to turn your notes into tasks. For example:
Research the codebase and break this into tasks withimplementation steps and verification criteria.
Ref reads through your indexed repos, finds the patterns that matter — auth flows, DB models, API routes — and turns your notes into concrete tasks with file paths and verification steps. Ask it to split a task, add more detail, or reconsider an approach until the plan feels right.Once the draft is down, use comments to leave feedback or tag teammates for review. Ref can address comments directly, updating the plan based on what you and your team surface.
Ref researches your codebase and drafts a plan
Have agents address comments directly on the plan
6
Ship it
When your tasks are ready, tell Ref to start implementing. You can pick specific tasks or hand off the whole plan:
Implement tasks 1-3.
Implement the plan.
Ref spins up a separate coding agent for each task, pre-loaded with the task details, file references, and repo context. Multiple tasks run in parallel, each on its own branch.You can keep working while implementation runs. Progress flows back automatically — watch status updates come in, and continue refining upcoming tasks.When a task finishes, a PR appears directly in your plan. You can provide higher-level feedback as work progresses, or enable auto-merge to let Ref review and merge PRs on your behalf.
Cursor
Devin
Manage multiple agents directly from Ref
What’s next?
Best Practices
Learn how to write plans that get great results.
Multi-Agent Orchestration
Set up fully automated multi-agent orchestration.
Integrations
Connect Linear or GitHub issues for richer context.
Local Agents
Using Claude Code, Codex, or another local agent? Install the MCP server to connect them to Ref.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ref","colors":{"primary":"#454545","light":"#e5e5e5","dark":"#1a1a1a"},"logo":{"light":"https://mintcdn.com/ref/XyifnU3UtNXJVtjg/logo/ref-wordmark-light.svg?fit=max\u0026auto=format\u0026n=XyifnU3UtNXJVtjg\u0026q=85\u0026s=39bee97ed67ca56816a5b3d5f66b397c","dark":"https://mintcdn.com/ref/XyifnU3UtNXJVtjg/logo/ref-wordmark-dark.svg?fit=max\u0026auto=format\u0026n=XyifnU3UtNXJVtjg\u0026q=85\u0026s=d19d58824687148c8265940613155932"},"favicon":"https://mintcdn.com/ref/yXCejt0fegXNOWGL/favicon.svg?fit=max\u0026auto=format\u0026n=yXCejt0fegXNOWGL\u0026q=85\u0026s=ad325e1b700d7bd403ecb8d3ca73b43c","navbar":{"links":[{"href":"mailto:hello@ref.tools","label":"Contact Us"}],"primary":{"type":"button","label":"Dashboard","href":"https://ref.tools/dashboard"}},"footer":{"socials":{"github":"https://github.com/ref-tools/ref-tools-mcp","linkedin":"https://www.linkedin.com/company/107120780"}},"seo":{"metatags":{"og:type":"website","og:site_name":"Ref"},"indexing":"all"},"fonts":{"heading":{"family":"Libre Baskerville","weight":400},"body":{"family":"Inter"}},"contextual":{"options":["copy","view"],"display":"toc"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Home","icon":"house","href":"https://ref.tools"},{"anchor":"Blog","icon":"pen-to-square","href":"https://ref.tools/blog"},{"anchor":"Ref Plans","icon":"list-check","href":"https://plan.ref.tools"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ref","hasAudioNarration":false,"actualSubdomain":"ref","customDomains":["docs.ref.tools"],"gitSource":{"type":"github","owner":"ref-tools","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6aff2b6ae02df8c6e5796e26","clientVersion":"0.0.4271","searchFilterCounts":[{"language":"default","tag":"Plans","count":55},{"language":"default","tag":"Context","count":42},{"language":"default","tag":"Install MCP Server","count":40},{"language":"default","tag":"Integrations","count":13},{"language":"default","tag":"Getting Started","count":8},{"language":"default","tag":"Support","count":6},{"language":"default","tag":"Plans for Your Role","count":5},{"language":"default","tag":"Comparison","count":4},{"language":"default","tag":"Collaboration","count":4},{"language":"default","tag":"Usage","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":".mdx-content{font-size:1.0625rem;line-height:1.7;letter-spacing:normal}.mdx-content :where(p,li){font-size:inherit;line-height:inherit}@media (max-width: 640px){.mdx-content{line-height:1.6}}.mdx-content :where([data-component-part=\"step-content\"],[data-component-part=\"tab-content\"],[data-component-part=\"accordion-content\"]){font-size:inherit;line-height:inherit}.mdx-content [data-component-part=\"callout-content\"],.mdx-content [data-component-part=\"callout-content\"] *{font-size:1rem;line-height:1.6}.mdx-content [data-component-part=\"callout-content\"] code{font-size:0.875em}.mdx-content{text-wrap-style:pretty}h1,.mdx-content :where(h2,h3,h4){text-wrap-style:balance}:where(h1,h2,h3,h4,h5,h6) code{letter-spacing:normal}.mdx-content :not(pre)>code{-webkit-box-decoration-break:clone;box-decoration-break:clone}:root:root{--font-family-headings-custom: var(--font-family-body-custom);--font-weight-headings-custom: 600}h1,.prose h2:not([data-component-part]){font-family:\"Libre Baskerville\", Georgia, serif;font-weight:400;letter-spacing:-0.01em}[data-layout-item=\"toc-title\"] svg{width:14px;height:14px}[data-layout-item=\"toc-title\"]~[data-layout-item=\"toc-list\"]{padding-left:22px}[data-layout-item=\"toc-item-link\"]{padding-block:6px}.rounded-l-xl{border-top-left-radius:4px;border-bottom-left-radius:4px}.rounded-r-xl{border-top-right-radius:4px;border-bottom-right-radius:4px}.rounded-t-xl{border-top-left-radius:4px;border-top-right-radius:4px}.rounded-b-xl{border-bottom-left-radius:4px;border-bottom-right-radius:4px}.rounded-search{border-radius:4px}.rounded-2xl,.rounded-xl{border-radius:4px}.backdrop-blur{transition:none;opacity:0.9;border-bottom:1px solid #a1a1a1}.prompt.memory-prompt{position:relative;display:block;background:none;border:0;border-left:2px solid var(--tw-prose-quote-borders, currentColor);border-radius:0;padding:0 2rem 0 1rem;color:inherit;font:inherit;letter-spacing:inherit}.memory-prompt [data-component-part=\"prompt-actions-wrapper\"]{position:absolute;top:0;right:0}.memory-prompt [data-component-part=\"prompt-action-copy-button\"]{background:none;border:0;color:inherit;width:1.75rem;height:1.75rem;padding:0;opacity:0}.memory-prompt [data-component-part=\"prompt-action-copy-button\"]>[aria-hidden]{display:none}.memory-prompt [data-component-part=\"prompt-action-copy-button\"]::before{content:\"⧉\";font:1.25rem/1 sans-serif}.memory-prompt [data-component-part=\"prompt-action-copy-button\"]:has([role=\"status\"]:not(:empty))::before{content:\"✓\"}.memory-prompt:hover [data-component-part=\"prompt-action-copy-button\"],.memory-prompt:focus-within [data-component-part=\"prompt-action-copy-button\"]{opacity:1}@media (hover: none){.memory-prompt [data-component-part=\"prompt-action-copy-button\"]{opacity:1}}"}]}
{"page":{"pagePath":"plans/getting-started/your-first-plan","slug":"/plans/getting-started/your-first-plan","pageMetadata":{"title":"Your First Plan","description":"Get Ref Plans running at full power in about ten minutes.","href":"/plans/getting-started/your-first-plan"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Get Ref Plans running at full power in about ten minutes.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,Card,CardGroup,CodeBlock,Frame,Heading,OptimizedImage,Step,Steps,Tab,Tabs}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`In this guide you’ll connect a repo, plan a feature with AI, and hand off the work to coding agents that open PRs for you. It takes about ten minutes.`}),`\n`,_jsx(_components.p,{children:`By the end you’ll have a connected repo, a configured agent, and a clear path from rough idea to merged code.`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Sign up`,children:[_jsxs(_components.p,{children:[`Create an account at `,_jsx(_components.a,{href:`https://plan.ref.tools`,children:`plan.ref.tools`}),`. You’ll land on a blank doc — your space to think through what you want to build.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref1-empty-editor.png?fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=4a21fb89436a035e2f0374d190902ac0`,alt:`The plan editor immediately after creating a new plan — empty document titled 'Untitled Plan', the chat panel on the right with quick actions, and a banner prompting you to connect GitHub.`,\"data-og-width\":`5121`,width:`5121`,\"data-og-height\":`2661`,height:`2661`,\"data-path\":`images/your-first/ref1-empty-editor.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref1-empty-editor.png?w=280\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=a9cff6ecc4d83aa83441af2769ee9f2f 280w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref1-empty-editor.png?w=560\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=1cf34d7fbcef29d6df122d634a0e947e 560w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref1-empty-editor.png?w=840\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=ab0dff5167f6d5fc4fa1c3774c46bde2 840w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref1-empty-editor.png?w=1100\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=ced811de9e79fd89b5ac032ca4bc4413 1100w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref1-empty-editor.png?w=1650\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=53c5b693cd05e85eeec2184fa7480204 1650w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref1-empty-editor.png?w=2500\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=f3fdfc90ed65289db354dd4d6d1777dc 2500w`})})]}),_jsxs(Step,{title:`Connect your codebase`,children:[_jsx(_components.p,{children:`Link a GitHub repo so Ref can read your code and write plans that match your architecture.`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Go to `,_jsx(_components.a,{href:`https://ref.tools/resources?tab=github`,children:`ref.tools/resources`})]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Connect GitHub`}),` and authorize Ref`]}),`\n`,_jsxs(_components.li,{children:[`Select the repos you want to index and click `,_jsx(_components.strong,{children:`Add to Ref`})]}),`\n`]}),_jsx(_components.p,{children:`Once indexed, Ref can read files, find existing patterns, and reference them when structuring your tasks.`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref2-repos-list.png?fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=58f98ee4531d8f359926567b7ee6338b`,alt:`The Your Resources page with the Repos tab selected, showing a list of GitHub repositories with branch selectors and 'Add to Ref' buttons.`,\"data-og-width\":`5121`,width:`5121`,\"data-og-height\":`2661`,height:`2661`,\"data-path\":`images/your-first/ref2-repos-list.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref2-repos-list.png?w=280\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=b185d94a2dd78a1ed937d9d3b42aa507 280w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref2-repos-list.png?w=560\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=0736a9770b778b940bcb2f84140f5e1c 560w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref2-repos-list.png?w=840\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=fcc340b7729ea047c63a89561d95e30b 840w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref2-repos-list.png?w=1100\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=c41084b835203635353bd89c36954763 1100w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref2-repos-list.png?w=1650\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=484e5b4017c0f2400e136207df43bdde 1650w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref2-repos-list.png?w=2500\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=c8a2d1062cad8be6168e5e05f2a33475 2500w`})})]}),_jsxs(Step,{title:`Pick a coding agent`,children:[_jsx(_components.p,{children:`Choose which coding agent Ref should use to implement your tasks.`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Open `,_jsx(_components.strong,{children:`Settings`}),` (gear icon)`]}),`\n`,_jsxs(_components.li,{children:[`Click the `,_jsx(_components.strong,{children:`Agents`}),` tab`]}),`\n`,_jsx(_components.li,{children:`Select an agent and follow the setup instructions below`}),`\n`]}),_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Cursor`,id:`cursor`,children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`1. Add your API key`})}),_jsxs(_components.p,{children:[`Paste your `,_jsx(_components.strong,{children:`Cursor`}),` API key in the Agents settings tab. Get one from `,_jsx(_components.a,{href:`https://cursor.com/dashboard?tab=cloud-agents`,children:`cursor.com/dashboard`}),` under the `,_jsx(_components.strong,{children:`Cloud Agents`}),` tab.`]}),_jsxs(Accordion,{title:`2. (Optional) Install MCP server so agents can send messages and access the plan directly`,id:`2-optional-install-mcp-server-so-agents-can-send-messages-and-access-the-plan-directly`,children:[_jsxs(_components.p,{children:[`Installing the Ref Plans MCP server lets Cursor read, write, and collaborate on plan documents. It’s optional for single-agent workflows but required for `,_jsx(_components.a,{href:`/plans/workflows/multi-agent`,children:`multi-agent orchestration`}),`.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Add the MCP server`})}),_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`cursor.com`}),`, click `,_jsx(_components.strong,{children:`MCPs`}),`, click the `,_jsx(_components.code,{children:`+`}),` button and select `,_jsx(_components.code,{children:`Custom MCP`}),` then fill in the form or json as follows.`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`11`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`11`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mcpServers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ref-plan\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"http\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.plan.ref.tools/mcp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"headers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"x-ref-api-key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"YOUR_REF_API_KEY\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsxs(_components.p,{children:[`Replace `,_jsx(_components.code,{children:`YOUR_REF_API_KEY`}),` with your key from `,_jsx(_components.a,{href:`https://ref.tools/keys`,children:`ref.tools/keys`}),`.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Configure security rules`})}),_jsxs(_components.p,{children:[`Cursor’s cloud agents run in a sandbox that blocks external network requests by default. You need to allowlist `,_jsx(_components.code,{children:`api.plan.ref.tools`}),` so the agent can reach the MCP server.`]}),_jsxs(_components.p,{children:[`In the Cursor dashboard, go to `,_jsx(_components.strong,{children:`Cloud Agents > Security Rules`}),` and add `,_jsx(_components.code,{children:`api.plan.ref.tools`}),` to the allowed domains.`]}),_jsxs(_components.p,{children:[`See the full `,_jsx(_components.a,{href:`/plans/install/cursor`,children:`Cursor MCP install guide`}),` for details.`]})]})]}),_jsxs(Tab,{title:`Devin`,id:`devin`,children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`1. Add your API key`})}),_jsxs(_components.p,{children:[`Paste your `,_jsx(_components.strong,{children:`Devin`}),` API key in the Agents settings tab. Get one from `,_jsx(_components.a,{href:`https://app.devin.ai/settings/api-keys`,children:`app.devin.ai/settings/api-keys`}),`.`]}),_jsxs(Accordion,{title:`2. (Optional) Install MCP server so agents can send messages and access the plan directly`,id:`2-optional-install-mcp-server-so-agents-can-send-messages-and-access-the-plan-directly-1`,children:[_jsxs(_components.p,{children:[`Installing the Ref Plans MCP server lets Devin read, write, and collaborate on plan documents. It’s optional for single-agent workflows but required for `,_jsx(_components.a,{href:`/plans/workflows/multi-agent`,children:`multi-agent orchestration`}),`.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Add the MCP server`})}),_jsxs(_components.p,{children:[`In the Devin dashboard, go to `,_jsx(_components.a,{href:`https://app.devin.ai/settings/mcp-marketplace`,children:`Settings > MCP Marketplace`}),` and click `,_jsx(_components.strong,{children:`Add MCP Server`}),`:`]}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Name:`}),` `,_jsx(_components.code,{children:`ref-plan`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`URL:`}),` `,_jsx(_components.code,{children:`https://api.plan.ref.tools/mcp`})]}),`\n`,_jsxs(_components.li,{children:[`Add a header `,_jsx(_components.code,{children:`x-ref-api-key`}),` with your API key from `,_jsx(_components.a,{href:`https://ref.tools/keys`,children:`ref.tools/keys`})]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Enable`})]}),`\n`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Configure security rules`})}),_jsxs(_components.p,{children:[`Devin runs in a sandboxed environment. If your workspace has network restrictions, ensure `,_jsx(_components.code,{children:`api.plan.ref.tools`}),` is allowed. Devin typically permits MCP server URLs automatically once enabled.`]}),_jsxs(_components.p,{children:[`See the full `,_jsx(_components.a,{href:`/plans/install/devin`,children:`Devin MCP install guide`}),` for details.`]})]})]}),_jsxs(Tab,{title:`Warp OZ`,id:`warp-oz`,children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`1. Add your API key`})}),_jsxs(_components.p,{children:[`Paste your `,_jsx(_components.strong,{children:`Warp API key`}),` (starts with `,_jsx(_components.code,{children:`wk-...`}),`) in the Agents settings tab. In the Warp desktop app, open `,_jsx(_components.strong,{children:`Settings > Platform`}),` and create an API key.`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Environment ID`}),` (optional) — most users with a single environment can leave this blank.`]}),`\n`]}),_jsxs(Accordion,{title:`2. (Optional) Install MCP server so agents can send messages and access the plan directly`,id:`2-optional-install-mcp-server-so-agents-can-send-messages-and-access-the-plan-directly-2`,children:[_jsxs(_components.p,{children:[`Installing the Ref Plans MCP server lets Warp read, write, and collaborate on plan documents. It’s optional for single-agent workflows but required for `,_jsx(_components.a,{href:`/plans/workflows/multi-agent`,children:`multi-agent orchestration`}),`.`]}),_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/plans/install/index`,children:`MCP install docs`}),` for step-by-step setup. If your environment restricts outbound network access, ensure `,_jsx(_components.code,{children:`api.plan.ref.tools`}),` is allowed.`]})]})]}),_jsxs(Tab,{title:`Claude Code, Codex, and more`,id:`claude-code%2C-codex%2C-and-more`,children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`1. No API key needed`})}),_jsxs(_components.p,{children:[`These work as `,_jsx(_components.strong,{children:`launcher`}),` agents — Ref generates a prompt with embedded webhook commands. You paste it into the agent yourself, and it reports progress back via the webhooks.`]}),_jsx(_components.p,{children:`Supported launchers:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Claude Code Web`}),`\n`,_jsx(_components.li,{children:`Codex (Cloud and Desktop)`}),`\n`,_jsx(_components.li,{children:`Factory`}),`\n`,_jsx(_components.li,{children:`Windsurf`}),`\n`,_jsx(_components.li,{children:`Zed`}),`\n`,_jsx(_components.li,{children:`GitHub Copilot`}),`\n`,_jsx(_components.li,{children:`Cursor Desktop`}),`\n`]}),_jsxs(Accordion,{title:`2. (Optional) Install MCP server so agents can send messages and access the plan directly`,id:`2-optional-install-mcp-server-so-agents-can-send-messages-and-access-the-plan-directly-3`,children:[_jsxs(_components.p,{children:[`Installing the Ref Plans MCP server lets these agents read, write, and collaborate on plan documents directly. It’s optional for single-agent workflows but required for `,_jsx(_components.a,{href:`/plans/workflows/multi-agent`,children:`multi-agent orchestration`}),`.`]}),_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/plans/install/index`,children:`MCP install docs`}),` for step-by-step setup instructions for your agent.`]})]})]})]})]}),_jsxs(Step,{title:`Write down what you're working on`,children:[_jsx(_components.p,{children:`No need for perfect formatting — just get your ideas down:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`A rough description of the feature or bug`}),`\n`,_jsx(_components.li,{children:`Links to a Linear ticket or GitHub issue`}),`\n`,_jsx(_components.li,{children:`A schema, API shape, or data model`}),`\n`,_jsx(_components.li,{children:`Bullet points, stream of consciousness, whatever gets it across`}),`\n`]}),_jsx(_components.p,{children:`This is your thinking space. Get everything important out of your head and onto the page.`}),_jsxs(_components.p,{children:[`If you want to pull in context from Linear, Asana, or GitHub Issues, you’ll need to connect those first — see the `,_jsx(_components.a,{href:`/plans/integrations/overview`,children:`Integrations guide`}),` for setup.`]})]}),_jsxs(Step,{title:`Build the plan with Ref`,children:[_jsx(_components.p,{children:`Open the chat panel and ask Ref to turn your notes into tasks. For example:`}),_jsx(CodeBlock,{numberOfLines:`3`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Research the codebase and break this into tasks with`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`implementation steps and verification criteria.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`Ref reads through your indexed repos, finds the patterns that matter — auth flows, DB models, API routes — and turns your notes into concrete tasks with file paths and verification steps. Ask it to split a task, add more detail, or reconsider an approach until the plan feels right.`}),_jsx(_components.p,{children:`Once the draft is down, use comments to leave feedback or tag teammates for review. Ref can address comments directly, updating the plan based on what you and your team surface.`}),_jsx(Frame,{caption:`Ref researches your codebase and drafts a plan`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref4-agent-writing-plan.png?fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=7c4265628629fff54a9f45c31195c0a4`,alt:`Split view showing rough notes in the plan editor on the left, and the chat panel on the right where Ref is researching the codebase and writing tasks.`,\"data-og-width\":`5121`,width:`5121`,\"data-og-height\":`2661`,height:`2661`,\"data-path\":`images/your-first/ref4-agent-writing-plan.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref4-agent-writing-plan.png?w=280\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=68871d84351a893799d8a548e2a7e255 280w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref4-agent-writing-plan.png?w=560\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=98b338c3f43ebcda8903040390d0cfd0 560w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref4-agent-writing-plan.png?w=840\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=f78b4c78f80288337c490448b016e6cc 840w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref4-agent-writing-plan.png?w=1100\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=d01122fbcfc40004c198eb4aae56d4ca 1100w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref4-agent-writing-plan.png?w=1650\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=09d28820c417c0881da4ac4b94f881b8 1650w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref4-agent-writing-plan.png?w=2500\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=13fad6c74c575dd84e9be2e6be4d1450 2500w`})}),_jsx(`br`,{}),_jsx(Frame,{caption:`Have agents address comments directly on the plan`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref5-comment.png?fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=9a7f10dd5924e521a26dd1436b9e267d`,alt:`A comment thread on a task — the author leaving feedback, and the chat panel showing Ref addressing the comment and updating the plan.`,\"data-og-width\":`5118`,width:`5118`,\"data-og-height\":`2660`,height:`2660`,\"data-path\":`images/your-first/ref5-comment.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref5-comment.png?w=280\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=033a056be4a7833c30463d33c5968449 280w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref5-comment.png?w=560\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=5f516ae3d634c6c87d97163e706ef8b1 560w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref5-comment.png?w=840\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=8d878321822bf3c26a99b0ab894f8d62 840w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref5-comment.png?w=1100\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=88d4fd142ec8aa09860bb18019a1ef7b 1100w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref5-comment.png?w=1650\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=d4937d971dac945d2c71b962ca65484c 1650w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref5-comment.png?w=2500\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=f6024b09463f7ee1166c60f384075883 2500w`})})]}),_jsxs(Step,{title:`Ship it`,children:[_jsx(_components.p,{children:`When your tasks are ready, tell Ref to start implementing. You can pick specific tasks or hand off the whole plan:`}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Implement tasks 1-3.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Implement the plan.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`Ref spins up a separate coding agent for each task, pre-loaded with the task details, file references, and repo context. Multiple tasks run in parallel, each on its own branch.`}),_jsx(_components.p,{children:`You can keep working while implementation runs. Progress flows back automatically — watch status updates come in, and continue refining upcoming tasks.`}),_jsxs(_components.p,{children:[`When a task finishes, a PR appears directly in your plan. You can provide higher-level feedback as work progresses, or enable `,_jsx(_components.strong,{children:`auto-merge`}),` to let Ref review and merge PRs on your behalf.`]}),_jsx(Frame,{caption:`Manage multiple agents directly from Ref`,children:_jsxs(Tabs,{children:[_jsx(Tab,{title:`Cursor`,id:`cursor-2`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref6-many-cursor-threads.png?fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=e3370a7a373328c6a1f69d866d6497bb`,alt:`Manage multiple agents directly from Ref.`,\"data-og-width\":`2420`,width:`2420`,\"data-og-height\":`1858`,height:`1858`,\"data-path\":`images/your-first/ref6-many-cursor-threads.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref6-many-cursor-threads.png?w=280\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=f495d1bec3de1733c460032f86bba01f 280w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref6-many-cursor-threads.png?w=560\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=9206ab76db5b125e2b00acf67abf31a1 560w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref6-many-cursor-threads.png?w=840\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=bb7b2a9ae94fe6ae638fa9c1a5b08e19 840w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref6-many-cursor-threads.png?w=1100\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=c77657f01e0216b416a07074dea39b89 1100w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref6-many-cursor-threads.png?w=1650\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=f95e37e5d3654198c2aed7ecb8d8fd67 1650w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref6-many-cursor-threads.png?w=2500\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=415cccf7ffd83b818a48aa3d88ac458c 2500w`})}),_jsx(Tab,{title:`Devin`,id:`devin-2`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref7-many-devin-threads.png?fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=dfb659726ffa4a7aff37d499563eef5c`,alt:`Manage multiple agents directly from Ref.`,\"data-og-width\":`5100`,width:`5100`,\"data-og-height\":`2268`,height:`2268`,\"data-path\":`images/your-first/ref7-many-devin-threads.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref7-many-devin-threads.png?w=280\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=a21c9af55f9cbe336a79d364eac4833d 280w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref7-many-devin-threads.png?w=560\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=011690d4f025d6e6dee36e99374827c6 560w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref7-many-devin-threads.png?w=840\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=8b0a167cdec631dc88a1fa6f0e76769d 840w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref7-many-devin-threads.png?w=1100\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=e17eb191f8d6af795ad5415cc35d8d6f 1100w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref7-many-devin-threads.png?w=1650\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=9bbe6b9283bb33227d5383472f69cc85 1650w, https://mintcdn.com/ref/wcEi-GjEn4JC4OwK/images/your-first/ref7-many-devin-threads.png?w=2500\u0026fit=max\u0026auto=format\u0026n=wcEi-GjEn4JC4OwK\u0026q=85\u0026s=f13160a28393205805c89790a61ec1e4 2500w`})})]})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`what’s-next`,children:`What’s next?`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Best Practices`,icon:`trophy`,href:`/plans/getting-started/best-practices`,children:_jsx(_components.p,{children:`Learn how to write plans that get great results.`})}),_jsx(Card,{title:`Multi-Agent Orchestration`,icon:`robot`,href:`/plans/workflows/multi-agent`,children:_jsx(_components.p,{children:`Set up fully automated multi-agent orchestration.`})}),_jsx(Card,{title:`Integrations`,icon:`plug`,href:`/plans/integrations/overview`,children:_jsx(_components.p,{children:`Connect Linear or GitHub issues for richer context.`})}),_jsx(Card,{title:`Local Agents`,icon:`terminal`,href:`/plans/install/index`,children:_jsx(_components.p,{children:`Using Claude Code, Codex, or another local agent? Install the MCP server to connect them to Ref.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Your First Plan","description":"Get Ref Plans running at full power in about ten minutes.","href":"/plans/getting-started/your-first-plan"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What’s next?","slug":"what’s-next","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ref/cdbaba620e45ac96/modify.js"],"subdomain":"ref","siteName":"Ref","title":"Your First Plan - Ref","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T22:38:42.810Z","originalFileLocation":"plans/getting-started/your-first-plan.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Get Ref Plans running at full power in about ten minutes.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ref\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ref/dS8wJGyZzUbcN0Fx/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ref/dS8wJGyZzUbcN0Fx/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ref/dS8wJGyZzUbcN0Fx/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ref/dS8wJGyZzUbcN0Fx/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ref/dS8wJGyZzUbcN0Fx/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ref/dS8wJGyZzUbcN0Fx/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ref/dS8wJGyZzUbcN0Fx/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ref/dS8wJGyZzUbcN0Fx/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ref/dS8wJGyZzUbcN0Fx/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Your First Plan - Ref\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get Ref Plans running at full power in about ten minutes.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ref\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ref.tools/plans/getting-started/your-first-plan\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ref.mintlify.site/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Your+First+Plan\u0026amp;description=Get+Ref+Plans+running+at+full+power+in+about+ten+minutes.\u0026amp;theme=3d18494ac4ab0303bf4d0aeb\u0026amp;signature=2c110db327c829e0db2cfb03d6ce1ca648c2052ae0286a191dad5c7fe591613a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Your First Plan - Ref\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get Ref Plans running at full power in about ten minutes.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ref.mintlify.site/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Your+First+Plan\u0026amp;description=Get+Ref+Plans+running+at+full+power+in+about+ten+minutes.\u0026amp;theme=3d18494ac4ab0303bf4d0aeb\u0026amp;signature=2c110db327c829e0db2cfb03d6ce1ca648c2052ae0286a191dad5c7fe591613a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ref/dS8wJGyZzUbcN0Fx/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ref\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#454545\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ref.tools/plans/getting-started/your-first-plan\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/plans/getting-started/your-first-plan.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ref.tools/#organization\",\"name\":\"Ref\",\"url\":\"https://docs.ref.tools\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ref/XyifnU3UtNXJVtjg/logo/ref-wordmark-light.svg?fit=max\u0026auto=format\u0026n=XyifnU3UtNXJVtjg\u0026q=85\u0026s=39bee97ed67ca56816a5b3d5f66b397c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ref.tools#website\",\"name\":\"Ref\",\"url\":\"https://docs.ref.tools\",\"publisher\":{\"@id\":\"https://docs.ref.tools/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ref.tools/plans/getting-started/your-first-plan#webpage\",\"url\":\"https://docs.ref.tools/plans/getting-started/your-first-plan\",\"name\":\"Your First Plan\",\"description\":\"Get Ref Plans running at full power in about ten minutes.\",\"dateModified\":\"2026-11-04T22:38:42.810Z\",\"isPartOf\":{\"@id\":\"https://docs.ref.tools#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ref.tools/plans/getting-started/your-first-plan#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ref.tools/plans/getting-started/your-first-plan#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting Started\",\"item\":\"https://docs.ref.tools/plans/getting-started/intro\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Your First Plan\",\"item\":\"https://docs.ref.tools/plans/getting-started/your-first-plan\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.ref.tools/plans/getting-started/your-first-plan#article\",\"headline\":\"Your First Plan\",\"name\":\"Your First Plan\",\"description\":\"Get Ref Plans running at full power in about ten minutes.\",\"url\":\"https://docs.ref.tools/plans/getting-started/your-first-plan\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ref.tools/plans/getting-started/your-first-plan#webpage\"},\"dateModified\":\"2026-11-04T22:38:42.810Z\",\"publisher\":{\"@id\":\"https://docs.ref.tools/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ref.tools#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ref\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ref\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/plans/getting-started/your-first-plan.md","siteName":"Ref","nav":{"global":{"anchors":[{"anchor":"Home","icon":"house","href":"https://ref.tools"},{"anchor":"Blog","icon":"pen-to-square","href":"https://ref.tools/blog"},{"anchor":"Ref Plans","icon":"list-check","href":"https://plan.ref.tools"}]},"tabs":[{"tab":"Plans","groups":[{"group":"Getting Started","pages":[{"title":"Overview","description":"Ref Plans in one page.","href":"/plans/getting-started/intro"},{"title":"Your First Plan","href":"/plans/getting-started/your-first-plan"},{"title":"Rich Content","description":"Add images, diagrams, interactive widgets, and collapsible detail sections to your plans.","href":"/plans/getting-started/rich-content"},{"title":"Best Practices","href":"/plans/getting-started/best-practices"}]},{"group":"Workflows","pages":[{"title":"Ways to Work with Plans","href":"/plans/workflows/overview"},{"title":"Multi-Agent Orchestration","href":"/plans/workflows/multi-agent"},{"title":"Claude Code /plan Hook","href":"/plans/workflows/claude-code-hook"}]},{"group":"Ref memory","pages":[{"title":"Overview","href":"/plans/memory/overview"},{"title":"Using Ref memory","href":"/plans/memory/how-it-works"}]},{"group":"Plans for Your Role","pages":[{"title":"Overview","href":"/plans/workflows/roles"},{"title":"Early-Career Engineer","href":"/plans/workflows/role-early-career"},{"title":"Senior / Staff Engineer","href":"/plans/workflows/role-senior-staff"},{"title":"Tech Lead / Manager","href":"/plans/workflows/role-tech-lead"},{"title":"Vibecoder","href":"/plans/workflows/role-vibecoder"}]},{"group":"Integrations","pages":[{"title":"Overview","href":"/plans/integrations/overview"},{"title":"Cursor Background Agents","href":"/plans/integrations/cursor"},{"title":"Devin","href":"/plans/integrations/devin"},{"title":"Warp OZ","href":"/plans/integrations/warp-oz"},{"title":"exe.dev","href":"/plans/integrations/exe-dev"},{"title":"Claude Code Web","href":"/plans/integrations/claude-code-web"},{"title":"Codex","href":"/plans/integrations/codex"},{"title":"Linear","href":"/plans/integrations/linear"},{"title":"Asana","href":"/plans/integrations/asana"},{"title":"GitHub Issues \u0026 PRs","href":"/plans/integrations/github"},{"title":"Slack","href":"/plans/integrations/slack"},{"title":"Custom MCP Servers","href":"/plans/integrations/custom-mcp"},{"title":"Custom Launchers","href":"/plans/integrations/custom-launchers"}]},{"group":"Collaboration","pages":[{"title":"Sharing Plans","href":"/plans/collaboration/sharing"},{"title":"Review Requests","href":"/plans/collaboration/reviews"},{"title":"Change Control","href":"/plans/collaboration/change-control"},{"title":"Team Plans \u0026 Visibility","href":"/plans/collaboration/team-visibility"}]},{"group":"Install MCP Server","pages":[{"title":"Installation","href":"/plans/install/index"},{"title":"Claude Code","href":"/plans/install/claude-code"},{"title":"Codex CLI","href":"/plans/install/codex"},{"title":"Gemini CLI","href":"/plans/install/gemini-cli"},{"title":"VS Code","href":"/plans/install/vscode"},{"title":"Zed","href":"/plans/install/zed"},{"title":"Cursor","href":"/plans/install/cursor"},{"title":"Antigravity","href":"/plans/install/antigravity"},{"title":"Windsurf","href":"/plans/install/windsurf"},{"title":"Kiro","href":"/plans/install/kiro"},{"title":"Augment","href":"/plans/install/augment"},{"title":"Goose","href":"/plans/install/goose"},{"title":"Droid CLI","href":"/plans/install/droid-cli"},{"title":"Amp","href":"/plans/install/amp"},{"title":"OpenCode","href":"/plans/install/opencode"},{"title":"Cline","href":"/plans/install/cline"},{"title":"Roo Code","href":"/plans/install/roo-code"},{"title":"Devin","href":"/plans/install/devin"},{"title":"ChatGPT","href":"/plans/install/chatgpt"},{"title":"Claude Desktop and Web","href":"/plans/install/claude-desktop"}]},{"group":"Skills and plugins","pages":[{"title":"Overview","href":"/plans/skills"}]},{"group":"Comparison","pages":[{"title":"Ref vs Notion \u0026 Google Docs","href":"/plans/comparison/notion-google-docs"},{"title":"Ref vs Markdown in the Repo","href":"/plans/comparison/markdown-in-repo"},{"title":"Migrating from Conductor","href":"/plans/comparison/migrating-from-conductor"}]},{"group":"Usage","pages":[{"title":"Pricing","href":"/usage/pricing"},{"title":"Credits","href":"/usage/credits"},{"title":"Teams","href":"/usage/teams"},{"title":"Enterprise","href":"/usage/enterprise"}]},{"group":"Support","pages":[{"title":"Status","href":"/support/status"},{"title":"Brand Assets","href":"/brand/assets"},{"title":"Report a Bug","href":"/support/report-bug"},{"title":"Request Docs","href":"/support/request-docs"},{"title":"Privacy \u0026 Security","href":"/support/privacy-security"},{"title":"Contact","href":"/support/contact"}]},{"group":"Changelog","pages":[{"title":"Monthly Updates","href":"/changelog"}]}]},{"tab":"Context","pages":[{"title":"Context","href":"/context/getting-started/intro"}]}]},"basePath":"","title":"Your First Plan - Ref","deploymentId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","buildId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DMn5ZJp6.js","DynamicMarkdown-5yMTCLas.js","zoom-image-lightbox-BUkqX3JF.js","lightbox-handle-r17bVUz3.js"]}