Skip to content
refine

Make everyprompt count.

Refine reads your repo on your machine and turns a rough request into a spec your coding agent can act on: the goal, the files that matter, what to leave alone and how to know it's done. Less explaining, more building.

Start refining

Writes specs for Claude Code, Cursor, Codex, VS Code and Gemini

You type

Goal

Cut the wait between Pay and the confirmation page without changing what customers see.

Context

3 of 412 files
  • lib/cart/total.tsrecalculates the total on every keystroke
  • app/api/orders/route.tsruns two queries one after the other
  • app/checkout/page.tsxrenders the payment step

Keep

  • Leave lib/payments/ alone
  • Prices stay in integer cents

Done when

  • pnpm test passes
  • The checkout flow test stays green
Try

Set as XML-style sections with file paths

Sample project. Refine sends file paths and reasons, never file contents.

Two words aren't enough for an agent that hasn't read your code.

So it guesses. It picks a framework, invents a pattern and calls the job done when it compiles. You spend the next three messages correcting it, and paying for the tokens.

For “add login”Your agent guessesRefine tells it
FrameworkAssumes plain React and a pages folderNext.js 14 with the app router
AuthWrites a JWT helper from scratchNextAuth, already in package.json
DataCreates a second users tableThe existing Prisma User model
PatternInvents its own route structureFollow app/api/signup/route.ts
Done meansIt compilesSign-in works, /login redirects, signup tests pass
Off limitsNothing, so migrations get rewrittenprisma/migrations/ and app/api/billing/

What happens when you press enter

About as long as it takes to switch windows. The model doesn't get smarter. It gets the right facts.

  1. Scan on your machine

    Reads manifests, a trimmed file tree, your CLAUDE.md, AGENTS.md and Cursor rules, git state, and the files most relevant to the task.

  2. Keep secrets out

    Respects .gitignore and .refineignore. Skips .env files, keys and credentials every time, and never reads them.

  3. Ask, only when it matters

    If the task is too vague, you get one to three questions. In CI it records its assumptions in the spec instead.

  4. Build one spec

    Goal, relevant files, constraints and acceptance criteria. File paths and short notes, not pasted files, so it stays small.

  5. Format it for your agent

    The same spec, written the way Claude Code, Cursor, Codex, VS Code or Gemini reads best.

Your code is read on your machine.

Only a small, filtered bundle leaves it, and you can print that bundle before anything is sent.

Secrets are never read
.env files, keys and credentials are skipped whatever .gitignore says. Only a count leaves.
File contents stay local
Relevant files are ranked on your machine. Refine sends their paths and signatures, not their bodies.
Nothing is kept
The service doesn't store or log your task, the bundle or the spec. Usage counts only.
No keys to manage
Sign in once with refine login. No Anthropic or OpenAI key to set up or leak.
refine "add login" --dry-run
Nothing is sent. No sign-in needed.

Included
  File tree: 18 of 18 file names
  Rules files: CLAUDE.md, README.md
  Relevant files (names and reasons):
    app/api/signup/route.ts
    prisma/schema.prisma
  Signatures: 3 files, no bodies

Excluded by the secret filter: 11
  .env
  .env.local
  .aws/credentials
  certs/server.key
  deploy/id_ed25519
  ...names stay on your machine

Use it wherever you already prompt.

One account, one token, the same spec everywhere.

  • Command line

    Refine a task and get the spec on your clipboard.

    refine "add login"
  • MCP server

    Claude Code, Codex, Cursor and VS Code call Refine themselves before they start work.

    claude mcp add refine
  • Claude Code plugin

    A /refine command, with an optional hook that adds project context.

    /refine add login
  • GitHub Action

    Label an issue and Refine replies with one comment holding a spec grounded in your code.

    label: refine
  • Agent instructions

    Generate CLAUDE.md, AGENTS.md, Cursor and Copilot files from a scan of your repo.

    refine init
  • Browser and editor

    A Refine button on ChatGPT and Claude.ai, and a VS Code extension.

    Refine: Refine a task...

Write your team's conventions once.

Refine Team applies your rules to every member's specs, in every repo. Admins edit them as YAML, every save is a numbered version, and publishing an older one rolls back.

Set up a team
# Version 7, published
rules:
  - id: tests.vitest
    title: Use Vitest
    lifecycle: active
    output_slot: constraints
    guidance: Write tests next to the code, as *.test.ts files.
profiles:
  "*":
    doNotTouch: [db/migrations/**]

One subscription. No API keys.

Cancel any time from your account page.

Refine Pro

Monthly subscription

For one developer. Up to 500 specs a month.

  • Every client: CLI, MCP server, plugin, editor, browser and GitHub Action
  • Specs for Claude Code, Cursor, Codex, VS Code and Gemini
  • Clarifying questions and --dry-run
  • No model API keys to manage
Start refining

Refine Team

Monthly, per seat

For engineering teams. Up to 500 specs a month per member.

  • Everything in Pro, for every member
  • Shared conventions applied to every spec, in every repo
  • Numbered versions, publish and roll back
  • Import an existing CLAUDE.md or AGENTS.md as a first draft
Set up a team

Questions

Does my code leave my machine?

Scanning, the secret filter and file selection run locally. Refine sends a small bundle: file names, the contents of rules files like CLAUDE.md, the paths of relevant files with a one-line reason each, and exported signatures without function bodies. Your absolute project path is replaced with /repo.

Can I see exactly what is sent?

Yes. Run refine "your task" --dry-run. It prints the full request body and what the secret filter skipped, then stops. Nothing is sent and you don't need to sign in.

Do you store my code or my specs?

No. The service doesn't store or log the task, the bundle or the spec. It keeps the time, size and outcome of each request, for usage and billing.

Do I need an Anthropic or OpenAI key?

No. Refine is hosted. Sign in once with refine login and every client uses the same account.

Which agents does it work with?

Claude Code, Cursor, Codex and VS Code, with Gemini in preview. A generic format works with anything that accepts a prompt.

Can I install it from npm?

Not yet. Refine is in early development and the CLI is built from source for now. The getting started guide takes about five minutes.