Versiones

PlanBefore sigue el versionado semántico (vMAJOR.MINOR.PATCH). Cada versión se compila en CI a partir de un tag y se publica en las versiones de GitHub con un archivo checksums.txt (SHA-256).

PlanBefore v0.7.0

Publicado — Ver en GitHub

Highlights

  • Edit part of a planning document without rewriting it. A new

spec.patch call lets your planner change one section of an existing Markdown spec (requirement, tasks, progress, review) inside your project's spec directory, instead of sending the whole file back. It can append to the end of the document, insert before or after a section, or replace a section's body while keeping its heading. Sections are picked by their exact heading, optionally with its level and parent headings. If no section or more than one matches, the edit fails; the Node never guesses.

  • No lost edits. Every spec.patch carries the version of the file the

planner read. If the file changed since then, for example because another conversation edited it, nothing is written and the planner is told to read it again. All the changes in one call are applied together or not at all.

  • Large documents stay intact. file.read and file.read_batch now

return a sha256 of the whole file, even when only a few lines were read or the read was cut short. A planner can read just the section it needs and patch it, and the parts it never read are left byte for byte as they were.

  • Same limits as before. spec.patch only edits existing .md files in

the project's spec directory, never follows symlinks, respects your excluded paths and the spec size limit, and writes atomically, exactly like spec.write. It never creates files; spec.write still creates and fully replaces documents.

Fixes

  • A request the Node rejects on purpose (for example reading a file that does

not exist) is no longer logged as an internal error; the log shows its reason code instead.

Upgrade notes

Run the install command again, then restart the Node: pbnode stop && pbnode serve --background.

Until a Node is updated, spec.patch on its projects fails with unknown_method; everything else keeps working. Reconnect or refresh PlanBefore in your planner app so it picks up the new tool.


Install

macOS / Linux:

curl -fsSL https://planbefore.kvnlabs.xyz/install.sh | REPOFLOW_VERSION=v0.7.0 sh

Windows (PowerShell):

$env:REPOFLOW_VERSION = 'v0.7.0'; irm https://planbefore.kvnlabs.xyz/install.ps1 | iex

Both installers verify the SHA-256 of the download against checksums.txt. Manual installation, requirements (git, rg) and first steps: https://planbefore.kvnlabs.xyz/install

The binaries are not code-signed yet; macOS and Windows may show a warning for files downloaded with a browser. See the installation guide.

Descargas de PlanBefore v0.7.0
PlataformaArchivoTamañoSHA-256
macOS — Apple Siliconpbnode_0.7.0_darwin_arm64.tar.gz
pbnode-darwin-arm64
3.5 MiB62e6823dde2ecec5…
macOS — Intelpbnode_0.7.0_darwin_amd64.tar.gz
pbnode-darwin-amd64
3.8 MiB9491d0694aa13c0b…
Linux — ARM64pbnode_0.7.0_linux_arm64.tar.gz
pbnode-linux-arm64
3.5 MiB7e4b4051d91fed17…
Linux — x86_64pbnode_0.7.0_linux_amd64.tar.gz
pbnode-linux-amd64
3.9 MiB95d592522b4b0334…
Windows — ARM64pbnode_0.7.0_windows_arm64.zip
pbnode-windows-arm64.exe
3.5 MiBf4364950888a133a…
Windows — x64pbnode_0.7.0_windows_amd64.zip
pbnode-windows-amd64.exe
3.9 MiB07c0c8f946d17757…

Todos los checksums SHA-256: checksums.txt para v0.7.0

Versiones anteriores

PlanBefore v0.8.0-rc.1 preliminar 17 oct 2026

Ver en GitHub

Highlights

  • Approve a new Node from your PlanBefore account. pbnode login now

enrolls the Node through the PlanBefore server set in hub.url. It prints a link and a short code; open the link, sign in to your PlanBefore account and approve the code. The Node's key is saved only after you approve, and a denied or expired code leaves the Node unenrolled.

  • The Node never decides who owns it. Ownership comes from the account

that approves the code on the PlanBefore page, not from anything the Node sends.

  • Clearer behavior while waiting. If the server asks the Node to poll more

slowly, pbnode login waits and keeps going instead of failing. If the server you point at does not offer Node enrollment yet, pbnode login stops with a clear error instead of trying another service.

Upgrade notes

This is a release candidate. It is never installed by default: the normal install command keeps installing the latest stable version. To try it, pin this exact version with the command in the Install section below, then restart the Node: pbnode stop && pbnode serve --background.

Nodes that are already enrolled keep working with this version, and with v0.7.0, without enrolling again: they keep their identity, owner and name. You do not need to update them. Do not run pbnode login --force on a Node that already works: it replaces the Node's identity with a new one that has to be approved again, and the Node stops using its old identity even if the new enrollment never completes.

New enrollments with this version only work once your PlanBefore server supports approving Nodes from your account. Until then pbnode login fails with a "not available" (404) error and the Node is not enrolled. Install this candidate only if you were asked to test that flow.


Install

macOS / Linux:

curl -fsSL https://planbefore.kvnlabs.xyz/install.sh | REPOFLOW_VERSION=v0.8.0-rc.1 sh

Windows (PowerShell):

$env:REPOFLOW_VERSION = 'v0.8.0-rc.1'; irm https://planbefore.kvnlabs.xyz/install.ps1 | iex

Both installers verify the SHA-256 of the download against checksums.txt. Manual installation, requirements (git, rg) and first steps: https://planbefore.kvnlabs.xyz/install

The binaries are not code-signed yet; macOS and Windows may show a warning for files downloaded with a browser. See the installation guide.

Descargas de PlanBefore v0.8.0-rc.1
PlataformaArchivoTamañoSHA-256
macOS — Apple Siliconpbnode_0.8.0-rc.1_darwin_arm64.tar.gz
pbnode-darwin-arm64
3.5 MiBcc5a0aee6d64dbd5…
macOS — Intelpbnode_0.8.0-rc.1_darwin_amd64.tar.gz
pbnode-darwin-amd64
3.8 MiB5d96164f966064cf…
Linux — ARM64pbnode_0.8.0-rc.1_linux_arm64.tar.gz
pbnode-linux-arm64
3.5 MiB279fec8b960118ed…
Linux — x86_64pbnode_0.8.0-rc.1_linux_amd64.tar.gz
pbnode-linux-amd64
3.9 MiBaa8194245003522d…
Windows — ARM64pbnode_0.8.0-rc.1_windows_arm64.zip
pbnode-windows-arm64.exe
3.5 MiBc1982648d04d73dd…
Windows — x64pbnode_0.8.0-rc.1_windows_amd64.zip
pbnode-windows-amd64.exe
3.9 MiB13719e824e4144bc…

Todos los checksums SHA-256: checksums.txt para v0.8.0-rc.1

PlanBefore v0.6.0 26 sept 2026

Ver en GitHub

Highlights

  • Your planner can follow a task without you asking. A new task.wait

call waits (up to 25 seconds at a time) until a task or checkpoint finishes and returns the same result as task.status. Planners such as ChatGPT now start a task, keep waiting and go straight to the review, so you no longer have to type "review" between steps. task.status is still there for a quick check.

  • Open the task's conversation in Codex Desktop. When a task finishes, the

Node stops holding its Codex conversation, so about a minute later you can open it in Codex Desktop instead of seeing "open in another app". The next task resumes the same conversation.

  • Find it by name. Conversations the Node creates are titled

PB - <requirement> (for example PB - rf-login), so they no longer all look the same in the sidebar.

  • Readable conversations. Each task message now starts with

PB · <requirement> · <task title>, and the agent ends with a readable report (result, summary, files, checks, deviations) followed by the machine-readable JSON block the Node validates. If the report is malformed, nothing is committed, as before.

  • The task pack is the only source of the task. The local agent is told

to implement exactly the task it receives and to report anything that was missing, instead of rebuilding the requirement from other planning documents.

Upgrade notes

Run the install command again, then restart the Node: pbnode stop && pbnode serve --background.

If you leave a task's conversation open in Codex Desktop, the next task (or checkpoint) of that requirement fails with thread_busy until you close it there; nothing else changes and you can start it again. Conversations created before this version keep their current name.


Install

macOS / Linux:

curl -fsSL https://planbefore.kvnlabs.xyz/install.sh | REPOFLOW_VERSION=v0.6.0 sh

Windows (PowerShell):

$env:REPOFLOW_VERSION = 'v0.6.0'; irm https://planbefore.kvnlabs.xyz/install.ps1 | iex

Both installers verify the SHA-256 of the download against checksums.txt. Manual installation, requirements (git, rg) and first steps: https://planbefore.kvnlabs.xyz/install

The binaries are not code-signed yet; macOS and Windows may show a warning for files downloaded with a browser. See the installation guide.

Descargas de PlanBefore v0.6.0
PlataformaArchivoTamañoSHA-256
macOS — Apple Siliconpbnode_0.6.0_darwin_arm64.tar.gz
pbnode-darwin-arm64
3.5 MiB410d7ae0518dd054…
macOS — Intelpbnode_0.6.0_darwin_amd64.tar.gz
pbnode-darwin-amd64
3.8 MiB6c0eb37b05a63f1c…
Linux — ARM64pbnode_0.6.0_linux_arm64.tar.gz
pbnode-linux-arm64
3.5 MiBb15f9dbef31fbe46…
Linux — x86_64pbnode_0.6.0_linux_amd64.tar.gz
pbnode-linux-amd64
3.9 MiB4986068452db156d…
Windows — ARM64pbnode_0.6.0_windows_arm64.zip
pbnode-windows-arm64.exe
3.5 MiBef238968ae7f3242…
Windows — x64pbnode_0.6.0_windows_amd64.zip
pbnode-windows-amd64.exe
3.9 MiBf802f7cee7b8cbaf…

Todos los checksums SHA-256: checksums.txt para v0.6.0

PlanBefore v0.5.0 22 sept 2026

Ver en GitHub

Highlights

  • Tasks now work with Codex's default sandbox. Your local developer agent

no longer needs to write to .git. The Node prepares the requirement's branch before the first task and, when a task finishes as done, creates one new commit with exactly the files that task changed, verifies it against Git and reports its hash. The agent only edits files and runs checks, so executor.sandbox: workspace-write is enough for the whole flow: branch, task, commit, checkpoint, next task and fix packs.

  • Your existing work stays yours. Uncommitted changes, staged changes,

untracked files and planning documents that existed before a task are never included in its commit and are left exactly as they were.

  • Fails safe instead of guessing. If the Node cannot isolate a task's

changes safely (a file you were already editing that the task also touched, a change the agent did not report, or the branch, HEAD or index changed by someone else during the task), it does not commit: the run ends with git_finalize_failed and the changes stay in place for you to review. Cancelled, timed-out, blocked or failed runs never commit.

  • The Node never pushes, merges, opens pull requests, resets, cleans, amends

or squashes, and it never rolls anything back. The MCP Git tools remain read-only; there is still no tool for Git changes, shell commands or arbitrary file writes. Accepting a task is still up to you.

Fixes

  • A commit touching files in subdirectories is now verified correctly.
  • A cancellation that arrives while a task is finishing no longer lets that

task commit; cancelling while the Node is already committing is rejected.

  • A commit left behind by a Node crash is reported as drift instead of being

silently built upon.

Upgrade notes

Run the install command again, then restart the Node: pbnode stop && pbnode serve --background.

If you set executor.sandbox: danger-full-access only so that tasks could create branches and commit, you can switch back to the default workspace-write (or remove the setting) and restart the Node. danger-full-access is still accepted, but no longer required.


Install

macOS / Linux:

curl -fsSL https://planbefore.kvnlabs.xyz/install.sh | REPOFLOW_VERSION=v0.5.0 sh

Windows (PowerShell):

$env:REPOFLOW_VERSION = 'v0.5.0'; irm https://planbefore.kvnlabs.xyz/install.ps1 | iex

Both installers verify the SHA-256 of the download against checksums.txt. Manual installation, requirements (git, rg) and first steps: https://planbefore.kvnlabs.xyz/install

The binaries are not code-signed yet; macOS and Windows may show a warning for files downloaded with a browser. See the installation guide.

Descargas de PlanBefore v0.5.0
PlataformaArchivoTamañoSHA-256
macOS — Apple Siliconpbnode_0.5.0_darwin_arm64.tar.gz
pbnode-darwin-arm64
3.5 MiB0ca069e726d4ca39…
macOS — Intelpbnode_0.5.0_darwin_amd64.tar.gz
pbnode-darwin-amd64
3.8 MiB6bd20893acf14c4c…
Linux — ARM64pbnode_0.5.0_linux_arm64.tar.gz
pbnode-linux-arm64
3.5 MiB0c0aefc10a56c0a5…
Linux — x86_64pbnode_0.5.0_linux_amd64.tar.gz
pbnode-linux-amd64
3.9 MiBffd18a57833212c2…
Windows — ARM64pbnode_0.5.0_windows_arm64.zip
pbnode-windows-arm64.exe
3.4 MiB5d217aad8e07e6d7…
Windows — x64pbnode_0.5.0_windows_amd64.zip
pbnode-windows-amd64.exe
3.9 MiB00379c1a57f7c3bb…

Todos los checksums SHA-256: checksums.txt para v0.5.0

PlanBefore v0.4.0 21 sept 2026

Ver en GitHub

Highlights

  • Planning documents in your repository. You can now let PlanBefore write

Markdown planning documents (requirements, tasks, progress, reviews) into one folder you authorize per project: pbnode expose <path> --spec-root specs. Writes are limited to .md files inside that folder, never follow symlinks and are atomic. Remove the permission with --clear-spec-root; pbnode projects shows it. Projects without a spec folder stay read-only.

  • Tasks run by your local developer agent. An authorized MCP client can

ask your own Codex installation to implement one task on your machine. The agent receives only that task, works on a dedicated branch, commits its work and returns a structured report; PlanBefore checks the reported commit against Git and never accepts a task on its own. Runs are asynchronous and can be cancelled without touching your working tree.

  • New MCP tools: spec.write, task.start, task.status, task.cancel,

rf.checkpoint and rf.status. The existing analysis tools are unchanged and read-only, and there is still no tool for arbitrary file writes, shell commands or Git changes.

  • pbnode status now says whether task execution is available.

Upgrade notes

Run the install command again, then restart the Node: pbnode stop && pbnode serve --background.

Task execution is optional. Without Codex, everything else keeps working and the task tools report that execution is unavailable. To enable it, add an executor: block to your config.yaml (see the README). If codex is not on your PATH —the Codex desktop app ships it inside its own bundle— set executor.command to the full path of the binary.

With the default sandbox (workspace-write), current Codex versions let the agent read .git but not write it, so a task that needs a branch or a commit stops as blocked without changing your repository. Letting the agent create branches and commit requires executor.sandbox: danger-full-access, which gives the agent full access to your machine, not just the project. That is your decision; PlanBefore never changes it for you.

Local task state is stored only on your machine, next to your configuration (workflow/state.json, readable only by you). The agent's report is returned to the MCP client that asked for it, like any other tool result; PlanBefore does not store it on its servers.


Install

macOS / Linux:

curl -fsSL https://planbefore.kvnlabs.xyz/install.sh | REPOFLOW_VERSION=v0.4.0 sh

Windows (PowerShell):

$env:REPOFLOW_VERSION = 'v0.4.0'; irm https://planbefore.kvnlabs.xyz/install.ps1 | iex

Both installers verify the SHA-256 of the download against checksums.txt. Manual installation, requirements (git, rg) and first steps: https://planbefore.kvnlabs.xyz/install

The binaries are not code-signed yet; macOS and Windows may show a warning for files downloaded with a browser. See the installation guide.

Descargas de PlanBefore v0.4.0
PlataformaArchivoTamañoSHA-256
macOS — Apple Siliconpbnode_0.4.0_darwin_arm64.tar.gz
pbnode-darwin-arm64
3.5 MiB7586751977ce0c30…
macOS — Intelpbnode_0.4.0_darwin_amd64.tar.gz
pbnode-darwin-amd64
3.8 MiB041ae0f5b9e59c51…
Linux — ARM64pbnode_0.4.0_linux_arm64.tar.gz
pbnode-linux-arm64
3.5 MiB93a663f93e9fc013…
Linux — x86_64pbnode_0.4.0_linux_amd64.tar.gz
pbnode-linux-amd64
3.9 MiB069596b099097a8c…
Windows — ARM64pbnode_0.4.0_windows_arm64.zip
pbnode-windows-arm64.exe
3.4 MiBe8cfdc81cbe2a7ad…
Windows — x64pbnode_0.4.0_windows_amd64.zip
pbnode-windows-amd64.exe
3.8 MiB3e66e9415fd4e0f2…

Todos los checksums SHA-256: checksums.txt para v0.4.0

PlanBefore v0.3.0 19 sept 2026

Ver en GitHub

PlanBefore Node v0.3.0.

See what changed and how to install it at https://planbefore.kvnlabs.xyz/releases


Install

macOS / Linux:

curl -fsSL https://planbefore.kvnlabs.xyz/install.sh | REPOFLOW_VERSION=v0.3.0 sh

Windows (PowerShell):

$env:REPOFLOW_VERSION = 'v0.3.0'; irm https://planbefore.kvnlabs.xyz/install.ps1 | iex

Both installers verify the SHA-256 of the download against checksums.txt. Manual installation, requirements (git, rg) and first steps: https://planbefore.kvnlabs.xyz/install

The binaries are not code-signed yet; macOS and Windows may show a warning for files downloaded with a browser. See the installation guide.

Descargas de PlanBefore v0.3.0
PlataformaArchivoTamañoSHA-256
macOS — Apple Siliconpbnode_0.3.0_darwin_arm64.tar.gz
pbnode-darwin-arm64
3.4 MiB6d875057a1108607…
macOS — Intelpbnode_0.3.0_darwin_amd64.tar.gz
pbnode-darwin-amd64
3.7 MiB95e51f987ac32cc6…
Linux — ARM64pbnode_0.3.0_linux_arm64.tar.gz
pbnode-linux-arm64
3.4 MiBc7c10f682b2653fd…
Linux — x86_64pbnode_0.3.0_linux_amd64.tar.gz
pbnode-linux-amd64
3.8 MiB6389e366a65ef575…
Windows — ARM64pbnode_0.3.0_windows_arm64.zip
pbnode-windows-arm64.exe
3.3 MiB328de3beb454e9ca…
Windows — x64pbnode_0.3.0_windows_amd64.zip
pbnode-windows-amd64.exe
3.7 MiBa9514a546420ba26…

Todos los checksums SHA-256: checksums.txt para v0.3.0

PlanBefore v0.3.0-rc.1 preliminar 19 sept 2026

Ver en GitHub

PlanBefore Node v0.3.0-rc.1.

See what changed and how to install it at https://planbefore.kvnlabs.xyz/releases


Install

macOS / Linux:

curl -fsSL https://planbefore.kvnlabs.xyz/install.sh | REPOFLOW_VERSION=v0.3.0-rc.1 sh

Windows (PowerShell):

$env:REPOFLOW_VERSION = 'v0.3.0-rc.1'; irm https://planbefore.kvnlabs.xyz/install.ps1 | iex

Both installers verify the SHA-256 of the download against checksums.txt. Manual installation, requirements (git, rg) and first steps: https://planbefore.kvnlabs.xyz/install

The binaries are not code-signed yet; macOS and Windows may show a warning for files downloaded with a browser. See the installation guide.

Descargas de PlanBefore v0.3.0-rc.1
PlataformaArchivoTamañoSHA-256
macOS — Apple Siliconpbnode_0.3.0-rc.1_darwin_arm64.tar.gz
pbnode-darwin-arm64
3.4 MiBf5b1d6300e76907e…
macOS — Intelpbnode_0.3.0-rc.1_darwin_amd64.tar.gz
pbnode-darwin-amd64
3.7 MiB67096d9aed252a8f…
Linux — ARM64pbnode_0.3.0-rc.1_linux_arm64.tar.gz
pbnode-linux-arm64
3.4 MiB3b8588e40cd11647…
Linux — x86_64pbnode_0.3.0-rc.1_linux_amd64.tar.gz
pbnode-linux-amd64
3.8 MiB00be0cc0f59851f5…
Windows — ARM64pbnode_0.3.0-rc.1_windows_arm64.zip
pbnode-windows-arm64.exe
3.3 MiBcc815de61744b434…
Windows — x64pbnode_0.3.0-rc.1_windows_amd64.zip
pbnode-windows-amd64.exe
3.7 MiB1a7e60cf826e62cf…

Todos los checksums SHA-256: checksums.txt para v0.3.0-rc.1

El historial completo está en Versiones de GitHub.