Files
plan2code/docs/index.html
T

470 lines
28 KiB
HTML

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Plan2Code: plan and build with your AI agent in your browser</title>
<meta name="description" content="Plan and build with an AI coding agent on a page in your browser. You answer the questions and approve each phase, and the specs land in your repo as plain files.">
<meta name="color-scheme" content="light dark">
<link rel="icon" href="favicon.ico" sizes="32x32">
<link rel="icon" type="image/png" sizes="32x32" href="favicon.png">
<link rel="icon" href="favicon.svg" type="image/svg+xml">
<link rel="apple-touch-icon" href="apple-touch-icon.png">
<style>
/* The web console's palette and type (src/web-console/public/styles/tokens.css), so the
site and the product look like one thing, with the Plan2Code blue as the
accent: #2455a4 in light, and the console's Ocean highlight (palette.js),
which the screenshots use, in dark. System fonts only, like the console. */
:root {
--bg: #f6f3ee;
--panel: #ffffff;
--panel-2: #fbf9f6;
--ink: #1d1a17;
--ink-2: #5d564d;
--ink-3: #8f8779;
--rule: #e4ddd1;
--rule-2: #cfc6b6;
--accent: #2455a4;
--accent-soft: #ecf2f9;
--accent-ink: #ffffff;
--accent-line: #9ab4d3;
--ok: #2f6b45;
--focus: #1f6feb;
--code-bg: #1d1a17;
--code-ink: #f0ece5;
--shadow: 0 1px 2px rgba(29, 26, 23, 0.05), 0 8px 24px rgba(29, 26, 23, 0.06);
--shadow-lg: 0 2px 4px rgba(29, 26, 23, 0.06), 0 24px 60px rgba(29, 26, 23, 0.12);
--sans: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
--serif: "Iowan Old Style", Charter, Georgia, Cambria, serif;
--mono: ui-monospace, SFMono-Regular, "Cascadia Mono", Menlo, Consolas, monospace;
--radius: 10px;
--width: 1120px;
--gutter: 24px;
}
@media (prefers-color-scheme: dark) {
:root {
--bg: #171513;
--panel: #201d1a;
--panel-2: #262220;
--ink: #f0ece5;
--ink-2: #b6afa3;
--ink-3: #8b8376;
--rule: #332e29;
--rule-2: #46403a;
--accent: #619fe5;
--accent-soft: #1a2533;
--accent-ink: #0c1117;
--accent-line: #3d5978;
--ok: #74c28f;
--focus: #6aa3ff;
--code-bg: #0f0d0c;
--code-ink: #f0ece5;
--shadow: 0 1px 2px rgba(0, 0, 0, 0.4), 0 8px 24px rgba(0, 0, 0, 0.35);
--shadow-lg: 0 2px 4px rgba(0, 0, 0, 0.45), 0 24px 60px rgba(0, 0, 0, 0.5);
}
}
* { box-sizing: border-box; }
html { scroll-behavior: smooth; }
body {
margin: 0;
background: var(--bg);
color: var(--ink);
font: 17px/1.6 var(--sans);
-webkit-font-smoothing: antialiased;
overflow-wrap: break-word;
}
img { max-width: 100%; height: auto; }
a { color: var(--accent); text-underline-offset: 3px; }
a:hover { text-decoration-thickness: 2px; }
code { font-family: var(--mono); font-size: 0.88em; }
:focus-visible { outline: 2px solid var(--focus); outline-offset: 3px; border-radius: 4px; }
h1, h2, h3 { font-family: var(--serif); font-weight: 600; line-height: 1.15; margin: 0; }
h2 { font-size: clamp(1.8rem, 4vw, 2.5rem); margin-bottom: 12px; }
h3 { font-size: 1.45rem; margin: 8px 0; }
.muted { color: var(--ink-2); }
.wrap { max-width: var(--width); margin: 0 auto; padding: 0 var(--gutter); }
.narrow { max-width: 780px; margin: 0 auto; padding: 0 var(--gutter); text-align: center; }
.skip { position: absolute; left: -9999px; top: 0; background: var(--panel); color: var(--ink); padding: 10px 16px; z-index: 10; }
.skip:focus { left: 0; }
/* Planny, drawn as the console draws him: shell, star eye, lip, arms up. */
.planny { display: block; margin: 0 auto; width: 44px; height: 60px; overflow: visible; }
.planny .shell { fill: var(--panel); stroke: var(--ink-2); stroke-width: 1.3; }
.planny .smile, .planny .arm path { fill: none; stroke: var(--ink-2); stroke-linecap: round; }
.planny .smile { stroke-width: 0.9; }
.planny .arm path { stroke-width: 1.2; }
.planny .arm circle, .planny .foot { fill: var(--ink-2); }
.planny .eye { fill: var(--accent); }
/* Screenshots: framed like a window, one per theme via <picture>. */
.shot { display: block; border: 1px solid var(--rule-2); border-radius: var(--radius); overflow: hidden; background: var(--panel); box-shadow: var(--shadow); }
.shot img { display: block; width: 100%; }
.shot.big { border-radius: 14px; box-shadow: var(--shadow-lg); }
/* The install command and its copy button. */
.cmd { position: relative; display: inline-flex; align-items: center; gap: 12px; max-width: 100%; background: var(--code-bg); color: var(--code-ink); border-radius: var(--radius); padding: 10px 10px 10px 18px; text-align: left; }
.cmd pre { margin: 0; min-width: 0; overflow-x: auto; font: 14.5px/1.5 var(--mono); white-space: pre; }
.cmd pre span { color: var(--accent-line); user-select: none; }
.copy { flex: none; display: inline-flex; align-items: center; gap: 6px; border: 0; border-radius: 7px; background: var(--accent); color: var(--accent-ink); font: 700 13px/1 var(--sans); padding: 10px 12px; cursor: pointer; min-height: 40px; }
.copy:hover { filter: brightness(1.08); }
.copy svg { width: 16px; height: 16px; fill: none; stroke: currentColor; stroke-width: 2; stroke-linecap: round; stroke-linejoin: round; }
.copy .tick { display: none; }
.copy.-done .clip { display: none; }
.copy.-done .tick { display: block; }
.before { margin: 0 auto 20px; max-width: 640px; text-align: left; background: var(--panel); border: 1px solid var(--rule-2); border-radius: var(--radius); padding: 14px 18px; font-size: 15px; }
.before h3 { font-size: 1.05rem; margin: 0 0 8px; }
.before ul { margin: 0; padding-left: 20px; color: var(--ink-2); }
.before li { margin: 4px 0; }
.before strong { color: var(--ink); }
.then { margin: 12px 0 0; color: var(--ink-2); font-size: 15px; }
/* Hero: centered headline, then the dashboard at full width. */
.hero { padding: 40px 0 32px; background: linear-gradient(to bottom, var(--panel), var(--bg)); }
.hero .narrow { max-width: 960px; }
.hero h1 { font-size: clamp(2.2rem, 5.6vw, 3.7rem); line-height: 1.06; margin: 12px 0 14px; }
.hero .lede { font-size: 1.2rem; color: var(--ink-2); margin: 0 auto 22px; max-width: 60ch; }
.stage { max-width: 1200px; margin: 0 auto; padding: 8px var(--gutter) 72px; }
/* Sections. */
section.s { padding: 72px 0; }
section.alt { background: var(--panel); border-block: 1px solid var(--rule); }
.intro { max-width: 62ch; margin: 0; }
/* How a session goes: alternating screenshot and text rows. */
.row { display: grid; grid-template-columns: minmax(0, 7fr) minmax(0, 5fr); gap: 48px; align-items: center; margin-top: 56px; }
.row.flip { grid-template-columns: minmax(0, 5fr) minmax(0, 7fr); }
.row.flip .shot { order: 2; }
.row .k { font-family: var(--serif); font-size: 3rem; line-height: 1; color: var(--accent); }
.row p { color: var(--ink-2); margin: 0; }
/* The pipeline: a vertical line of steps, then the utilities. */
.line { list-style: none; margin: 36px 0 0; padding: 0; position: relative; }
.line::before { content: ""; position: absolute; left: 11px; top: 10px; bottom: 26px; width: 2px; background: var(--rule-2); }
.line li { position: relative; padding: 0 0 26px 48px; }
.line li::before { content: ""; position: absolute; left: 4px; top: 7px; width: 16px; height: 16px; border-radius: 50%; background: var(--panel); border: 2px solid var(--accent); }
.line li.opt::before { border-style: dashed; }
.line h3 { display: inline; font-family: var(--sans); font-size: 1.15rem; font-weight: 650; }
.chip { display: inline-block; margin-left: 8px; vertical-align: 2px; font-size: 11px; font-weight: 700; letter-spacing: 0.08em; text-transform: uppercase; color: var(--ink-2); border: 1px solid var(--rule-2); border-radius: 999px; padding: 2px 8px; }
.line p { margin: 4px 0 0; color: var(--ink-2); max-width: 64ch; }
.line code { color: var(--ink-2); font-size: 13px; }
.utils { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 12px; margin-top: 12px; }
.util { border: 1px solid var(--rule-2); border-radius: var(--radius); background: var(--bg); padding: 16px; }
.util h3 { font-family: var(--sans); font-size: 1rem; font-weight: 650; margin: 8px 0 4px; }
.util p { margin: 0; font-size: 14.5px; color: var(--ink-2); }
.util .chip { margin-left: 0; }
/* What the page gives you: a two-column list. */
.feat { columns: 2; column-gap: 56px; margin-top: 36px; }
.feat div { break-inside: avoid; padding: 18px 0; border-top: 1px solid var(--rule); }
.feat h3 { font-size: 1.2rem; margin: 0 0 4px; }
.feat p { margin: 0; color: var(--ink-2); }
.feat-shots { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 24px; margin-top: 40px; }
.feat-shots figure { margin: 0; }
.feat-shots figcaption { margin-top: 10px; font-size: 14.5px; color: var(--ink-2); }
/* The rules: numbered. */
ol.rules { list-style: none; padding: 0; margin: 32px 0 0; counter-reset: r; }
ol.rules li { counter-increment: r; display: grid; grid-template-columns: 3.5rem minmax(0, 1fr); gap: 16px; padding: 22px 0; border-top: 1px solid var(--rule); }
ol.rules li::before { content: counter(r); font-family: var(--serif); font-size: 2.6rem; line-height: 1; color: var(--accent); }
ol.rules h3 { font-family: var(--sans); font-size: 1.15rem; font-weight: 650; margin: 0 0 4px; }
ol.rules p { margin: 0; color: var(--ink-2); }
/* Prefer the terminal? */
.term-band { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1fr); gap: 48px; align-items: center; }
pre.term { background: var(--code-bg); color: var(--code-ink); border-radius: var(--radius); padding: 22px; margin: 0; font: 14.5px/1.8 var(--mono); overflow-x: auto; }
/* Closing install and footer. */
.close { text-align: center; }
.close .muted { margin: 0 0 22px; }
footer { border-top: 1px solid var(--rule); padding: 26px 0 32px; color: var(--ink-2); font-size: 14.5px; }
footer .wrap { display: flex; flex-wrap: wrap; justify-content: center; gap: 8px 22px; }
footer a { color: inherit; }
@media (max-width: 820px) {
.row, .row.flip, .term-band, .feat-shots { grid-template-columns: minmax(0, 1fr); gap: 20px; }
.row.flip .shot { order: 0; }
.row { margin-top: 44px; }
.feat { columns: 1; }
.utils { grid-template-columns: minmax(0, 1fr); }
section.s { padding: 56px 0; }
}
@media (max-width: 600px) {
:root { --gutter: 16px; }
body { font-size: 16px; }
.hero { padding-top: 40px; }
.cmd { display: flex; }
.cmd pre { font-size: 13px; }
ol.rules li { grid-template-columns: 2.5rem minmax(0, 1fr); }
}
@media (prefers-reduced-motion: reduce) {
html { scroll-behavior: auto; }
* { transition: none !important; animation: none !important; }
}
</style>
</head>
<body>
<a class="skip" href="#main">Skip to the content</a>
<main id="main">
<section class="hero" aria-labelledby="hero-title">
<div class="narrow">
<svg class="planny" viewBox="0 0 22 30" aria-hidden="true" focusable="false">
<rect class="foot" x="5.7" y="27.1" width="3.6" height="1.7" rx="0.85"/>
<rect class="foot" x="12.7" y="27.1" width="3.6" height="1.7" rx="0.85"/>
<rect class="shell" x="3" y="7" width="16" height="20" rx="3.2"/>
<path class="eye" d="M11 10.95 L11.79 12.91 L13.9 13.06 L12.28 14.42 L12.79 16.47 L11 15.35 L9.21 16.47 L9.72 14.42 L8.1 13.06 L10.21 12.91 Z"/>
<path class="smile" d="M8.3 18.4 Q11 21 13.7 18.4"/>
<g class="arm"><path d="M3 16.5 L1.1 13.7"/><circle cx="1.1" cy="13.7" r="0.85"/></g>
<g class="arm"><path d="M19 16.5 L20.9 13.7"/><circle cx="20.9" cy="13.7" r="0.85"/></g>
</svg>
<h1 id="hero-title">Plan and build with your AI agent, on one page.</h1>
<p class="lede">Plan2Code asks the questions, drafts the plan and builds it one phase at a time. You answer and approve in your browser, and the specs land in your repo.</p>
<div class="before" id="before-start">
<h3>Before you start</h3>
<ul>
<li><strong>Node.js 18 or newer.</strong> Check with <code>node --version</code>. No Node? Get it from <a href="https://nodejs.org/">nodejs.org</a> (the LTS download), or run <code>winget install OpenJS.NodeJS.LTS</code> on Windows, <code>brew install node</code> on macOS, or use <code>nvm</code> on Linux. Then open a new terminal.</li>
<li><strong>Start from your project.</strong> Open your terminal in the project you want to work on (<code>cd</code> into it) before you run anything. Plan2Code works on the folder you start it in.</li>
<li><strong>Ways in.</strong> <code>plan2code</code> (Claude Code, Devin or Codex), or type <code>/plan2code</code> in your agent (<code>$plan2code</code> in Codex).</li>
<li><strong>No agent yet?</strong> Install Claude Code, Codex or Devin first, or let the <code>plan2code</code> command's setup page walk you through it.</li>
</ul>
</div>
<div class="cmd">
<pre id="install-cmd"><span aria-hidden="true">$ </span>npx --allow-git=all git+https://github.com/jparkerweb/plan2code.git</pre>
<button class="copy" type="button" aria-label="Copy the install command">
<svg class="clip" viewBox="0 0 24 24" aria-hidden="true"><rect x="9" y="9" width="11" height="12" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
<svg class="tick" viewBox="0 0 24 24" aria-hidden="true"><path d="M4 12.5 9.5 18 20 6.5"/></svg>
<span class="label">Copy</span>
</button>
</div>
<p class="then">then, from your project, run <code>plan2code</code> (Claude Code, Devin or Codex), or type <code>/plan2code</code> in your agent (<code>$plan2code</code> in Codex).</p>
<p class="then">It always opens a menu; no output at all means npm could not reach the repository and hid the reason: <code>git ls-remote https://github.com/jparkerweb/plan2code.git</code> shows why.</p>
</div>
</section>
<div class="stage">
<picture class="shot big">
<source media="(prefers-color-scheme: dark)" srcset="screenshots/dashboard-dark.webp">
<img src="screenshots/dashboard-light.webp" width="2560" height="1600" alt="The Plan2Code dashboard for a task API that is half built: a Set up card, then the steps in order, with the Implement card marked Suggested and reading Phase 3 of 4 is next.">
</picture>
</div>
<section class="s" id="session" aria-labelledby="session-title">
<div class="wrap">
<h2 id="session-title">How a session goes</h2>
<p class="intro muted">One page, from the first card to the sign-off. Your agent does the work in the terminal; you do your part here.</p>
<div class="row">
<picture class="shot">
<source media="(prefers-color-scheme: dark)" srcset="screenshots/question-dark.webp">
<img src="screenshots/question-light.webp" width="2560" height="1600" loading="lazy" alt="A Plan question card, How tasks are paged, with three options, the first marked Suggested, each with its trade-off underneath.">
</picture>
<div>
<span class="k" aria-hidden="true">1</span>
<h3>Pick a card, answer on the page</h3>
<p>Pick a step on the dashboard and it starts right there. Questions arrive a few at a time, each option with its trade-off written under it.</p>
</div>
</div>
<div class="row flip">
<picture class="shot">
<source media="(prefers-color-scheme: dark)" srcset="screenshots/build-dark.webp">
<img src="screenshots/build-light.webp" width="2560" height="1600" loading="lazy" alt="A phase of a task API being built: 5 of 11 done on the progress bar, and the phase's task list with the first five ticked.">
</picture>
<div>
<span class="k" aria-hidden="true">2</span>
<h3>Watch it build</h3>
<p>Tasks tick off as they land, and the line beside Planny says what is being worked on right now.</p>
</div>
</div>
<div class="row">
<picture class="shot">
<source media="(prefers-color-scheme: dark)" srcset="screenshots/signoff-dark.webp">
<img src="screenshots/signoff-light.webp" width="2560" height="1600" loading="lazy" alt="The Approve this phase card, with a button to read the completion report and three choices: Review the code first, Approve this phase, and I want changes.">
</picture>
<div>
<span class="k" aria-hidden="true">3</span>
<h3>Sign off</h3>
<p>Read the completion report, then approve the phase or ask for changes. In Implement, you can also have the code reviewed first.</p>
</div>
</div>
</div>
</section>
<section class="s alt" id="pipeline" aria-labelledby="pipeline-title">
<div class="wrap">
<h2 id="pipeline-title">The pipeline</h2>
<p class="intro muted">Every step is a card on the dashboard. Each one writes files the next one reads, so any session can pick up cold.</p>
<ol class="line">
<li class="opt"><h3>Pathfinder</h3><span class="chip">Step 0 · optional</span><p>A foggy idea becomes a clear list of decisions, settled one question at a time. <code>/plan2code-0-pathfinder</code></p></li>
<li><h3>Plan</h3><span class="chip">Step 1</span><p>Requirements, technical design and your approval: the shape of what gets built. <code>/plan2code-1-plan</code></p></li>
<li><h3>Document</h3><span class="chip">Step 2</span><p>The plan becomes a checklist of small tasks, grouped into phases, that a developer can just do. <code>/plan2code-2-document</code></p></li>
<li><h3>Implement</h3><span class="chip">Step 3 · once per phase</span><p>Builds the next phase, task by task, with a report and your sign-off at the end. <strong>Implement + review</strong> adds a careful review of the changes before the sign-off. <code>/plan2code-3-implement</code></p></li>
<li><h3>Finalize</h3><span class="chip">Step 4</span><p>Checks the work, writes the summary, files the specs away and suggests the commit message. <code>/plan2code-4-finalize</code></p></li>
</ol>
<div class="utils">
<div class="util"><span class="chip">Any time</span><h3>Quick task</h3><p>Too small for the full process? A quick plan, then it just builds it.</p></div>
<div class="util"><span class="chip">Any time</span><h3>Review</h3><p>A second opinion on the changes. Problems ranked, and you pick what gets fixed.</p></div>
<div class="util"><span class="chip">Any time</span><h3>Handoff</h3><p>Pack the current session into a document a fresh session can pick up cold.</p></div>
<div class="util"><span class="chip">Any time</span><h3>Codebase X-ray</h3><p>Explains how and why an area works, or ranks the rough spots worth fixing into a brief for planning.</p></div>
<div class="util"><span class="chip">Any time</span><h3>Diagnose a bug</h3><p>Finds a bug's cause and writes it up without fixing it, then hands the fix to Quick task, or to Plan when it is big.</p></div>
<div class="util"><span class="chip">Any time</span><h3>Changelog</h3><p>Picks the next version and drafts the entries, which you edit before Git commits them.</p></div>
<div class="util"><span class="chip">Any time</span><h3>Git</h3><p>A board for branches, pull, push and commits that opens on the likely next step.</p></div>
</div>
<div class="row" id="git-board">
<picture class="shot">
<source media="(prefers-color-scheme: dark)" srcset="screenshots/git-dark.webp">
<img src="screenshots/git-light.webp" width="2560" height="1600" loading="lazy" alt="The git board on feature/task-endpoints: the Changes tab, badged 3, opens on a Next step card reading Commit 3 files, above the three changed files ticked for the commit. Branches and Sync tabs and a Done with git button sit beside it.">
</picture>
<div>
<h3>The git board</h3>
<p>Three tabs, <strong>Changes</strong>, <strong>Branches</strong> and <strong>Sync</strong>, and it opens on the one holding your likely next step: commit, pull, push, publish, open a pull request or tidy up branches. That step is one main button. Each tab badges what is waiting on it, a stopped rebase or merge gets one block with every file marked, and nothing is pushed, published or deleted without asking. It never force-pushes.</p>
</div>
</div>
</div>
</section>
<section class="s" id="features" aria-labelledby="features-title">
<div class="wrap">
<h2 id="features-title">What the page gives you</h2>
<p class="intro muted">The same workflow as the terminal, with more room to think.</p>
<div class="feat">
<div><h3>Trade-offs in plain view</h3><p>Questions arrive a few at a time, each option with its trade-off written under it, so you choose rather than guess.</p></div>
<div><h3>Review before you approve</h3><p>Review the code first, on the sign-off card, reviews exactly the files the phase changed. You tick which findings get fixed, then approve.</p></div>
<div><h3>The Ask tab</h3><p>A chat beside the cards for anything you want to know. It is answered at the agent's next check-in and never holds up your answers.</p></div>
<div><h3>Attachments on notes</h3><p>Paste a screenshot or attach a document to a note on any question, and show instead of describe.</p></div>
<div><h3>A notebook of your own</h3><p>A private pad for each project folder, in Markdown with pictures. It never goes into your project, and the agent never sees it.</p></div>
<div><h3>Workspace folders</h3><p>Add a shared library or a design folder as read-only context, and point at it by its <code>@name</code>.</p></div>
<div><h3>Session meter</h3><p>A ring in the top bar turns from green to red as a session grows long, and suggests when a fresh one would serve you better.</p></div>
<div><h3>Runs on your machine</h3><p>A small program Plan2Code starts for you serves the page on <code>127.0.0.1</code>. No account, no dependencies, and nothing leaves your computer.</p></div>
</div>
<div class="feat-shots">
<figure>
<picture class="shot">
<source media="(prefers-color-scheme: dark)" srcset="screenshots/ask-dark.webp">
<img src="screenshots/ask-light.webp" width="2560" height="1600" loading="lazy" alt="The Ask tab: the question Where are tasks paged? and Plan2Code's answer naming the file.">
</picture>
<figcaption>The Ask tab, answered between tasks.</figcaption>
</figure>
<figure>
<picture class="shot">
<source media="(prefers-color-scheme: dark)" srcset="screenshots/finish-dark.webp">
<img src="screenshots/finish-light.webp" width="2560" height="1600" loading="lazy" alt="The finished screen after a phase: what happened, the next command with a Copy button, and a Back to the dashboard button.">
</picture>
<figcaption>Every ending says what to run next.</figcaption>
</figure>
<figure style="grid-column:1/-1;max-width:calc(50% - 12px);justify-self:center">
<picture class="shot">
<source media="(prefers-color-scheme: dark)" srcset="screenshots/notepad-dark.webp">
<img src="screenshots/notepad-light.webp" width="2560" height="1600" loading="lazy" alt="The Notebook open over a question: two named tabs, and a heading, bullets and bold styled in place as they are typed.">
</picture>
<figcaption>Your own notebook, private to the folder.</figcaption>
</figure>
</div>
</div>
</section>
<section class="s alt" id="rules" aria-labelledby="rules-title">
<div class="wrap">
<h2 id="rules-title">The rules</h2>
<p class="intro muted">Four rules do most of the work.</p>
<ol class="rules">
<li><div><h3>Keep each session short.</h3><p>Chaining a couple of small skills on the dashboard is fine. Start a fresh console session when the session meter turns red, and always before a big planning or build step. The specs on disk carry everything between sessions.</p></div></li>
<li><div><h3>No code until the plan hits 90% confidence.</h3><p>Step 1 will not finalize below the threshold. Under it, the agent keeps asking and keeps reading your code, and writes every assumption down where you can argue with it.</p></div></li>
<li><div><h3>Checkboxes are the state, not the chat.</h3><p>Progress lives in the spec files. Any agent, any session, resumes cold from them.</p></div></li>
<li><div><h3>Approve a phase to close it.</h3><p>On the sign-off card, or by replying <code>approved</code> in the terminal. Nothing advances on a guess about what you meant.</p></div></li>
</ol>
</div>
</section>
<section class="s" id="terminal" aria-labelledby="terminal-title">
<div class="wrap term-band">
<div>
<h2 id="terminal-title">Prefer the terminal?</h2>
<p class="muted">Every skill also runs right in the terminal. Each one asks at the start whether you want the page or the terminal; add <code>--web</code> to skip the question and go straight to the page.</p>
<p><a href="https://github.com/jparkerweb/plan2code#prefer-the-terminal">See every command in the README</a></p>
</div>
<pre class="term">/plan2code
/plan2code-1-plan --web plan a REST API for tasks</pre>
</div>
</section>
<section class="s alt close" id="install" aria-labelledby="install-title">
<div class="narrow">
<h2 id="install-title">Install</h2>
<p class="muted">Run it again any time to update.</p>
<div class="before" id="before-start-2">
<h3>Before you start</h3>
<ul>
<li><strong>Node.js 18 or newer.</strong> Check with <code>node --version</code>. No Node? Get it from <a href="https://nodejs.org/">nodejs.org</a> (the LTS download), or run <code>winget install OpenJS.NodeJS.LTS</code> on Windows, <code>brew install node</code> on macOS, or use <code>nvm</code> on Linux. Then open a new terminal.</li>
<li><strong>Start from your project.</strong> Open your terminal in the project you want to work on (<code>cd</code> into it) before you run anything. Plan2Code works on the folder you start it in.</li>
<li><strong>Ways in.</strong> <code>plan2code</code> (Claude Code, Devin or Codex), or type <code>/plan2code</code> in your agent (<code>$plan2code</code> in Codex).</li>
<li><strong>No agent yet?</strong> Install Claude Code, Codex or Devin first, or let the <code>plan2code</code> command's setup page walk you through it.</li>
</ul>
</div>
<div class="cmd">
<pre><span aria-hidden="true">$ </span>npx --allow-git=all git+https://github.com/jparkerweb/plan2code.git</pre>
<button class="copy" type="button" aria-label="Copy the install command">
<svg class="clip" viewBox="0 0 24 24" aria-hidden="true"><rect x="9" y="9" width="11" height="12" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
<svg class="tick" viewBox="0 0 24 24" aria-hidden="true"><path d="M4 12.5 9.5 18 20 6.5"/></svg>
<span class="label">Copy</span>
</button>
</div>
<p class="then">then, from your project, run <code>plan2code</code> (Claude Code, Devin or Codex), or type <code>/plan2code</code> in your agent (<code>$plan2code</code> in Codex).</p>
<p class="then">It always opens a menu; no output at all means npm could not reach the repository and hid the reason: <code>git ls-remote https://github.com/jparkerweb/plan2code.git</code> shows why.</p>
</div>
</section>
</main>
<footer>
<div class="wrap">
<a href="https://github.com/jparkerweb/plan2code">Plan2Code on GitHub</a>
<span>MIT license</span>
<a href="https://github.com/jparkerweb/plan2code/releases">Releases</a>
</div>
</footer>
<script>
(function () {
var CMD = 'npx --allow-git=all git+https://github.com/jparkerweb/plan2code.git';
function wire(btn) {
var label = btn.querySelector('.label');
var timer;
function done() {
btn.classList.add('-done');
label.textContent = 'Copied';
clearTimeout(timer);
timer = setTimeout(function () {
btn.classList.remove('-done');
label.textContent = 'Copy';
}, 1800);
}
function fallback() {
var ta = document.createElement('textarea');
ta.value = CMD;
ta.setAttribute('readonly', '');
ta.style.position = 'fixed';
ta.style.opacity = '0';
document.body.appendChild(ta);
ta.select();
try { document.execCommand('copy'); done(); } catch (e) {}
document.body.removeChild(ta);
}
btn.addEventListener('click', function () {
if (navigator.clipboard && navigator.clipboard.writeText) {
navigator.clipboard.writeText(CMD).then(done, fallback);
} else {
fallback();
}
});
}
var buttons = document.querySelectorAll('.copy');
for (var i = 0; i < buttons.length; i++) wire(buttons[i]);
})();
</script>
</body>
</html>