orfc

Your agent writes the plan.

Your team reviews it. You iterate.

Push markdown or HTML — RFCs, architecture docs, implementation plans, dashboards with charts. Inline review, in-browser editing, full version history. Organize with folders and tags.

NewFolders, tags, and HTML docs→

Install

$ npm install -g @orfc/cli

$ orfc login

✓ Authenticated

$ orfc push design.html# or plan.md

--folder "Q2 Planning" --tag architecture

✓ Published → https://orfc.dev/p/xK7mQ2

$ orfc pull xK7mQ2

✓ 3 comments pulled → feedback.md

$ orfc edit xK7mQ2

✓ Updated → https://orfc.dev/p/xK7mQ2 (v2)

Works with

Any agent that writes markdown or HTML

Cursor

Claude Code

Windsurf

Any terminal

How it works

Your agent writes a plan in markdown or HTML.

Push it. Share the link. Reviewers comment inline.

Pull the feedback. Iterate. Ship.

Documentation

Getting started

Install the CLI globally, then authenticate once with your email.

$ npm install -g @orfc/cli

$ orfc login

✓ Authenticated as you@company.com

Your API key is saved to ~/.orfc/config.json. You only need to log in once.

Publishing a plan

Push any markdown or HTML file to get a shareable link. For markdown, the title is auto-detected from the first # heading; for HTML, from <title> or the first <h1>. HTML docs render the author's own theme — sanitized, but with inline SVG, charts, and styling preserved.

$ orfc push plan.md

✓ Published → https://orfc.dev/p/xK7mQ2

# link copied to clipboard, browser opens automatically

Pipe from stdin, set a custom title, organize with folders and tags, or update an existing plan:

$ cat plan.md | orfc push

$ orfc push plan.md --title "Q2 Architecture"

$ orfc push plan.md --folder "Q2 Planning" --tag rfc # organize

$ orfc push plan.md --update xK7mQ2 # update existing

$ orfc push plan.md --expires 7d # auto-expire in 7 days

Folders & tags

Group plans into folders for projects, releases, or teams. Add tags for cross-cutting categories (rfc, design, postmortem). The dashboard shows a folder tree on the left and a tag filter on top — both also editable per-row.

$ orfc push plan.md --folder "Q2 Planning/Auth" # nested paths

$ orfc push plan.md --tag rfc --tag draft # multiple tags

In-page navigation

Markdown plans render a sticky sub-nav built from their headings, scroll-tracked so reviewers can jump straight to the section they care about. Long RFCs stay readable.

Access control

By default, plans require sign-in to view. You can make them public or restrict to specific people.

Authenticated (default)

Anyone with a valid email sign-in can view the plan.

$ orfc push plan.md

Public

Anyone with the link can view, no sign-in required.

$ orfc push plan.md --access anyone

Domain-restricted

Only people with matching email domains can view. The author always has access.

$ orfc push plan.md --viewers "@company.com"

$ orfc push plan.md --viewers "alice@co.com,bob@co.com"

Notifying reviewers

Send an email to reviewers when you publish, so they know to review.

$ orfc push plan.md --to reviewer@company.com

$ orfc push plan.md --to "alice@co.com,bob@co.com"

Reviewing feedback

Reviewers open the link in their browser, highlight text, and leave inline comments. You can pull those comments back into your markdown.

$ orfc pull xK7mQ2

<!-- [COMMENT by reviewer@co.com]

On: "the specific text they highlighted"

> Their feedback here

-->

Pipe to a file for easy revision:

$ orfc pull xK7mQ2 > feedback.md

$ orfc comments xK7mQ2 # view comments in terminal

Managing plans

The dashboard at orfc.dev/dashboard lists every plan you've published with a folder tree, tag filter, and per-row controls to move or retag. The CLI mirrors the same primitives.

$ orfc list # list all your published plans

$ orfc open xK7mQ2 # open in browser

$ orfc delete xK7mQ2 # permanently delete

Editing & version history

Edit plans directly in the browser or from your terminal. Every update automatically preserves the previous version.

Web editing

Plan authors see an Edit button on their documents. Click to switch to a markdown editor with live preview. Cmd+S to save.

CLI editing

Pull, edit in your terminal editor, and push back in one command.

$ orfc edit xK7mQ2 # opens in $EDITOR

Version history

Click History on any plan to see all previous versions with diffs. Every update — from the web, CLI, or an agent — is tracked.

Agent workflow

Agents (Cursor, Claude Code, Windsurf) can use orfc to share implementation plans for human review before executing. This is the typical flow:

Agent generates a markdown plan for the implementation

Agent publishes and notifies the reviewer

orfc push plan.md --viewers "@company.com" --to you@company.com

Human reviews on orfc.dev, leaves inline comments on specific sections

Agent pulls feedback and reads inline comments

orfc pull xK7mQ2 > feedback.md

Agent addresses each comment, revises the plan, and re-publishes

Agent updates the existing plan with revisions

orfc push plan.md --update xK7mQ2

Agent prompt

Copy this prompt into Cursor rules, Claude Code CLAUDE.md, or any agent's system instructions to enable the orfc workflow.

## orfc — plan review workflow Before implementing any non-trivial task, publish your plan for human review using orfc. ### Setup (one-time) npm install -g @orfc/cli orfc login ### Workflow 1. Write your implementation plan as a markdown (plan.md) or HTML (design.html) file 2. Publish it for review: orfc push plan.md --viewers "@company.com" --to reviewer@company.com 3. Wait for the reviewer to leave inline comments on orfc.dev 4. Pull the feedback: orfc pull <slug> > feedback.md 5. Read the comments, address each one, revise your plan 6. Re-publish the updated plan: orfc push plan.md --update <slug> 7. Repeat until approved, then implement ### Key flags --access anyone # make public (no sign-in required) --viewers "@domain.com" # restrict to a domain --to "a@co.com,b@co.com" # email reviewers --update <slug> # update existing plan --title "My Plan" # custom title --folder "Q2/Auth" # nested folder path --tag rfc --tag draft # one or more tags ### Commands orfc push <file> # publish a plan (markdown or HTML) orfc pull <slug> # pull plan with inline comments orfc edit <slug> # pull, edit in $EDITOR, push back orfc comments <slug> # view comments orfc list # list your plans orfc --help # full usage ### Version history Every --update automatically preserves the previous version. Reviewers can view all past versions and diffs on the web.

Configuration

Config is stored at ~/.orfc/config.json. Set defaults so you don't have to repeat flags.

$ orfc config show

$ orfc config set defaultAccess anyone

$ orfc config set defaultExpiry 7d

$ orfc config set slackWebhook https://hooks.slack.com/...

CLI reference

Command	Description
orfc login	Authenticate via browser
orfc push <file>	Publish a markdown or HTML file
orfc pull <slug>	Pull plan with inline comments
orfc comments <slug>	View comments in terminal
orfc list	List all your plans
orfc open <slug>	Open plan in browser
orfc edit <slug>	Pull, edit in $EDITOR, push back
orfc delete <slug>	Delete a plan permanently
orfc config <action>	View or modify config