Skip to main content

REPL

The Plandex REPL is a developer-friendly chat interface. It's the easiest way to use Plandex.

Start​

To start the REPL, just run plandex or pdx in any project directory (or sub-directory).

If you don't have a current plan in the directory, the REPL will create a new one. Otherwise, it will use the current plan.

Commands​

All Plandex CLI commands are available in the REPL. Just type a backslash (\) followed by the command.

The REPL also has a few special commands of its own:

  • \quit or \q to quit the REPL
  • \help or \h for help
  • @ plus a relative file path for loading files into context (note that if you're using auto-context mode, loading files yourself is optional)
  • \run or \r plus a relative file path for using a file as a prompt
  • \chat or \ch to switch to chat mode and have a conversation without making changes
  • \tell or \t to switch to tell mode and implement tasks
  • \multi or \m to switch to multi-line mode
  • \send or \s to send the current prompt to Plandex (for sending a prompt in multi-line mode, since enter gives you a newline)

REPL Flags​

The REPL has a few convenient flags you can use to start it with different modes, autonomy settings, and model packs. You can pass any of these to plandex or pdx when starting the REPL.

  Mode
    --chat, -c     Start in chat mode (for conversation without making changes)
    --tell, -t     Start in tell mode (for implementation)

  Autonomy
    --no-auto      None → step-by-step, no automation
    --basic        Basic → auto-continue plans, no other automation
    --plus         Plus → auto-update context, smart context, auto-commit changes
    --semi         Semi-Auto → auto-load context
    --full         Full-Auto → auto-apply, auto-exec, auto-debug

  Models
    --daily        Daily driver pack (default models, balanced capability, cost, and speed)
    --strong       Strong pack (more capable models, higher cost and slower)
    --cheap        Cheap pack (less capable models, lower cost and faster)
    --oss          Open source pack (open source models)

    --gemini-planner       Gemini pack (Gemini 2.5 Pro for planning, default models for other roles)
    --o3-planner           OpenAI o3-medium for planning, default models for other roles
    --r1-planner           DeepSeek R1 for planning, default models for other roles
    --perplexity-planner   Perplexity for planning, default models for other roles
    --opus-planner         Anthropic Opus 4 for planning, default models for other roles