Spaces:
Paused
Paused
File size: 2,621 Bytes
a80a15d | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 | ---
sidebar_position: 4
sidebar_label: REPL
---
# 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
```
|