Repository navigation
PlanBefore v0.5.0
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 asdone, 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-writeis 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,HEADor index changed by
someone else during the task), it does not commit: the run ends with
git_finalize_failedand 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 shWindows (PowerShell):
$env:REPOFLOW_VERSION = 'v0.5.0'; irm https://planbefore.kvnlabs.xyz/install.ps1 | iexBoth 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.