mrkeyoor.com_
Mon 02 Nov 01:09 UTC
AI Toolsevaluationupdated 26 Oct 2026

plandex review

Plandex is a terminal coding agent for tasks that span multiple steps and files. Its README describes a cumulative diff that keeps generated changes separate from project files before application, plus plan history and branches. That review workflow is a reason to evaluate it; it does not establish filesystem isolation or correct edits.

+75stars / 7d
Verdict

Plandex merits a restricted evaluation if its plan-and-diff workflow fits your work and you can operate the local server. Our September 28, 2026 run of commit e2d7720 recorded a 35-second install step and a successful 44-second build step, but also an unsuccessful vet result and no demonstrated behavioral tests in the CLI command scope. It did not verify an installed CLI or a working coding session. The README's Cloud wind-down notice and the open third-party apply-path report are concrete reasons for caution; they do not prove that the repository is abandoned or that we reproduced a vulnerability.

We ran it

Lab card: what happened when we ran plandexScreenshot of plandex (github.com/plandex-ai/plandex)
Install✓ · 35s360 packages
Build✓ · 44s
Tests✓ · 10s0 passed · 0 failed of 0 (go test)
Repo696 files~81,449 lines of source · 32.2 MB · 1 CI workflows · tests dir

Answers from our run

Does plandex build from source?

Dependencies installed in 35 seconds (360 packages), and the build succeeded in 44 seconds. We cloned commit e2d7720 into a clean Debian container with 3 CPUs and no project-specific setup.

Do plandex's tests pass?

Yes. The project's own test command finished in 10 seconds and reported 0 passed, 0 failed (go test).

Who should not use plandex?

New users seeking Plandex Cloud: the README says it began winding down on October 3, 2025 and no longer accepts new users.

What are the alternatives to plandex?

Aider, OpenCode. Plandex merits a restricted evaluation if its plan-and-diff workflow fits your work and you can operate the local server.

Setup3/5Documented local setup requires Docker, a server and model credentials. Our September 28, 2026 CLI run completed an install step in 35 seconds but did not verify binary installation or a working session.
Docs3/5The supplied README and local quickstart explain hosting choice, prerequisites, sign-in, provider configuration and WSL support. Broader production documentation was not verified in this review.
Community2/5A 2026 issue and proposed fix show community participation, while metadata records the last push on October 3, 2025. Maintainer responsiveness and adoption are not established.
Maturity2/5cli/v2.2.1 is available, but our e2d7720 build record includes vet diagnostics and no demonstrated behavioral tests. The supplied apply-path report is unresolved and was not reproduced by us.

Discussed on

  1. hnShow HN: Plandex – an AI coding engine for complex tasks304 points
  2. hnShow HN: Plandex v2 – open source AI coding agent for large projects and tasks257 points
  3. hnPlandex 1.1.0 – LLM driven development in the terminal. Now multi-modal.13 points
  4. hnShow HN: Plandex v2 – OSS AI coding agent w/ diff sandbox, full auto, 2M context4 points

Who it’s for

Developers evaluating a planning workflow for changes across multiple files.
Self-hosters willing to operate a local Docker server and configure model credentials.
Developers who want plan branches and configurable autonomy, as described in the README.
Evaluators who can restrict filesystem access and inspect changes before applying them.

Who it’s NOT for

New users seeking Plandex Cloud: the README says it began winding down on October 3, 2025 and no longer accepts new users.
Developers expecting native Windows Command Prompt or PowerShell support: the README requires WSL.
Teams requiring demonstrated behavioral test coverage from this review: our recorded CLI run provides none.
Teams expecting this review to establish unattended-operation safety: we did not evaluate that, and an open third-party report describes writes outside the project directory.

Setup reality

In our recorded run on September 28, 2026, commit e2d7720 was evaluated under app/cli. The install step exited 0 in 35 seconds, with a recorded dependency count of 360. Its empty output tail does not establish what was downloaded or whether a CLI binary was installed.

The build step was marked successful with exit 0 in 44 seconds, but its saved tail contains two context-cancellation diagnostics and vet-exit:1. This is a successful recorded build step with an unsuccessful vet result, not a clean validation result. The go test step exited 0 in 10 seconds; its tail lists 17 packages with [no test files]. The parser recorded 0 passed, 0 failed and 0 total tests. Those observations describe this CLI command scope, not exhaustive repository coverage.

The documented local quickstart requires Git, Docker and Docker Compose. It starts the server with ./start_local.sh, installs the CLI separately, and uses plandex sign-in with http://localhost:8099 as the default local host. OpenRouter is the quickstart's quickest provider option, configured through OPENROUTER_API_KEY. We did not run that complete workflow or verify an installed binary, server connection or model-backed task.

A reviewable plan still needs a restricted environment

Plandex's appeal is its documented separation between generated changes and project files. For developers considering a large change, that creates a place to inspect the proposed work before applying it. It should not be treated as an operating-system sandbox.

The README describes plan version history, branches, configurable autonomy and optional automatic Git commits. It also claims a 2-million-token effective context window with the default model pack, roughly 100,000 tokens per file, and project maps for directories containing 20 million tokens or more. These are upstream capability claims. Our run did not measure context capacity, planning quality, edit accuracy, model cost or browser debugging.

What our recorded run establishes

Our recorded run began on September 28, 2026 at 03:00:16.738 UTC, using commit e2d772072efadbe41d2946d97d79be55532dbab5, abbreviated e2d7720. The command scope was ./app/cli. The recorded configuration was 3 CPUs, 8 GB of memory and image golang:1.24-bookworm. The image label does not verify the actual Go runtime version. The supplied record does not establish container privilege settings or secret handling.

The checkout measurements were 696 files, approximately 81,449 lines of source and 32.2 MB. Detection recorded one CI workflow and a test directory; neither establishes executed coverage.

Recorded step Result What it supports
Install Exit 0, 35 seconds; dependency count 360 Step completion. The saved tail is empty, so it does not verify dependency downloads or binary installation.
Build Marked successful, exit 0, 44 seconds Build-step completion, qualified by the saved vet diagnostics.
Tests Exit 0, 10 seconds The saved output lists 17 CLI packages with no test files; the parser records 0 passed, 0 failed and 0 total.

The raw build duration is 43.8 seconds, rounded to 44 in the summary. Its tail reports discarded context-cancellation functions at lib/apply_cgroup_linux.go:25:7 and cmd/browser.go:183:11, followed by vet-exit:1. The raw install and test durations are 34.5 and 10.434 seconds, respectively. Build-step success therefore should not be described as a clean vet result.

The go test result is not a failing test suite, and it is not evidence of passing behavioral tests. These are recorded parser summaries and output tails; no new execution or complete-log reconciliation established exhaustive unique coverage. We did not test the server, an installed binary, provider authentication or a measured coding workload. No audit result was recorded.

Local setup includes a server and model credentials

The local-mode quickstart describes a client-server architecture intended for a single local user. It requires Git, Docker and Docker Compose. The documented sequence clones the repository, changes into plandex/app and runs ./start_local.sh. A separate terminal installs the CLI, then runs plandex sign-in and selects the local host at http://localhost:8099.

The quickstart calls OpenRouter the quickest provider option and sets OPENROUTER_API_KEY. The README also permits other model-provider accounts and keys. These instructions explain the route to a session; our CLI build record does not verify that route end to end.

Windows support is through WSL. The README explicitly excludes Command Prompt and PowerShell. It also says Plandex Cloud began winding down on October 3, 2025 and stopped accepting new users. A new evaluation should therefore start with the local or self-hosted route rather than assume Cloud access.

The apply-path concern is a report, not our finding

Open issue 352 reports that model-controlled paths can cause applied changes to write outside the project directory. Its author identifies CLI version 2.2.1 and says they demonstrated the behavior through ApplyFiles. That is a third-party report; our recorded run did not reproduce it or establish its applicability to every build.

The supplied pull request 358 extract shows an open proposal to add containment checks for writes and deletes. An open proposal does not establish that a fix has shipped or that the proposed implementation is sufficient.

For an evaluation, use a restricted workspace, keep automatic apply disabled and inspect destinations before application. Manual approval alone is not proof of containment: issue 352 says the confirmation displays a file count without the destination paths. Treat the cumulative diff as a review feature rather than a security boundary.

Maintenance evidence supports caution, not an abandonment verdict

The supplied GitHub metadata records the last repository push as October 3, 2025 and marks the repository as neither archived nor disabled. The supplied release page labels cli/v2.2.1 as latest. Those observations establish a stale push date and an available release, not the maintainers' intentions or future support.

The open 2026 issue and proposed fix show community reporting and contribution. They do not establish maintainer responsiveness. Neither stars nor an updated repository metadata timestamp proves active code maintenance.

How to use the ratings

These are editorial evidence ratings, not benchmark results. On this five-point rubric, 1 means little supporting evidence or a major obstacle, 2 means material concerns or substantial unverified behavior, 3 means a documented route with meaningful setup or verification gaps, 4 means detailed evidence for the assessed dimension, and 5 requires broad corroboration and relevant verification. Unknown adoption and compatibility do not earn a high score.

Setup earns 3 because the local route is documented but includes a server and provider configuration that our run did not exercise. Documentation earns 3 because the supplied README and local quickstart explain that route, while broader production instructions were not verified here. Community earns 2 because reports and a proposed fix coexist with the old push date, without established maintainer responsiveness. Maturity earns 2 because the recorded build has vet diagnostics, behavioral operation remains unverified, and the apply-path report remains unresolved in the supplied evidence.

If you proceed, verify the current code and issue status first, then attempt a small change in a restricted project. Check the installed binary, server connection, generated destinations and resulting diff before considering a larger task. Aider's Git-centered workflow and OpenCode's separate plan agent are relevant alternatives, but we did not compare their performance or safety in this run.

Alternatives

ProjectWhat it isPick it when
Aider gh↗Terminal AI pair programming with Git integration.Choose Aider when you want its documented automatic commits and familiar Git tools to inspect and undo AI changes.
OpenCode gh↗An open-source coding agent with build and plan agents.Consider OpenCode when you want a documented plan agent that denies file edits by default and asks permission before bash commands, alongside a full-access build agent.

Sources

  1. Plandex README
  2. Plandex repository metadata
  3. Plandex v2.2.1 release
  4. Plandex local-mode quickstart
  5. Path traversal report for apply changes
  6. Proposed path containment fix

More ai tools reviews

kornia · skills · anarlog · pr-agent · agent-sprite-forge · KiroCrew · the whole board →

Related reading