Plandex REPL 交互式命令行指南从启动到高效使用【免费下载链接】plandexOpen source AI coding agent. Designed for large projects and real world tasks.项目地址: https://gitcode.com/GitHub_Trending/pl/plandexPlandex 是一个面向大型项目和真实世界任务的 AI 编码代理。它提供了两种交互方式一种是标准的单命令 CLI 调用另一种是本文要深入讲解的Plandex REPLRead-Eval-Print Loop——一个开发者友好的交互式聊天界面也是官方文档中明确标注的最容易上手的 Plandex 使用方式。本文将围绕 docs/docs/repl.md 展开结合仓库源码带你完整掌握 REPL 的启动方式、内置命令、模式切换、启动参数以及这些功能在 app/cli/cmd/repl.go 等源码中的具体实现。读完本文你将能够在任何项目目录下一键进入 REPL熟练使用\命令体系、文件加载、多行模式等核心操作理解 chat / tell / multi 三种状态机的工作原理并掌握通过启动 flags 一次性配置模式、自主程度autonomy和模型包组合的最佳实践。一、什么是 Plandex REPLPlandex REPL 是一个驻留在终端中的交互式聊天与任务执行界面。与一次执行一个命令的 CLI 不同REPL 让你在同一个会话中持续地对话、加载上下文、查看 diff、应用修改形成一个完整的思考-实现-验证循环。从源码结构看REPL 的完整实现由三个关键文件构成app/cli/cmd/repl.goREPL 命令的入口与核心执行逻辑包括启动流程、命令解析、补全逻辑app/cli/lib/repl.goREPL 状态管理模式、多行开关、历史记录与子命令执行工具ExecPlandexCommandapp/cli/term/help.goREPL 内可用命令的注册表CliCommands声明了每个命令在 REPL 中是否可用及其别名。其中 app/cli/lib/repl.go 定义了 REPL 的核心状态机type ReplMode string const ( ReplModeTell ReplMode tell ReplModeChat ReplMode chat ) type ReplState struct { Mode ReplMode IsMulti bool }可见 REPL 的核心是双模式 多行开关Mode决定当前输入是聊天还是执行任务IsMulti决定回车键是发送还是换行。这个状态会在会话之间持久化写入repl_settings目录下的 JSON 文件因此你上次退出时的模式会保留到下次启动。二、启动 REPL2.1 最简启动在任何项目目录或子目录下直接运行plandex # 或简写 pdx从 app/cli/cmd/root.go 的Execute函数可以看到无参数运行plandex时会被自动路由到 REPL// if no arguments were passed, start the repl if len(os.Args) 1 || ... { replCmd.ParseFlags(os.Args[1:]) replCmd.Run(replCmd, []string{}) return }也就是说启动 REPL并不需要显式的repl子命令——只要不带命令参数直接运行二进制就会进入 REPL当然你也可以显式地执行plandex repl。2.2 启动时自动创建/复用计划启动后REPL 会检查当前目录是否存在 current plan当前计划没有 current planREPL 会自动调用new子命令创建一个新计划并把你在启动 flags 中指定的自主级别与模型包透传给new见 app/cli/cmd/repl.go已有 current plan直接加载并进入该计划的会话上下文。因此你可以在任意子目录中随时进入 REPL 开始工作无需手动plandex new。三、REPL 中的命令体系3.1 所有 CLI 命令在 REPL 内可用REPL 内输入以反斜杠\开头的命令即可调用全部 Plandex CLI 命令。例如\load src/utils.go # 加载文件到上下文 \diff # 查看待应用改动 \apply # 应用改动 \continue # 继续当前计划 \set-auto full # 设置自主级别CliCommands注册表app/cli/term/help.go中标记了Repl: true的命令都会在 REPL 中启用并带有各自的别名例如命令别名说明\plans\pl列出计划\cd无按名称或序号切换当前计划\current\cu显示当前计划\load\l加载文件/目录/URL/笔记/图片到上下文\ls无列出上下文中的所有内容\rm无按索引、范围、名称或 glob 移除上下文\apply\ap将待处理改动应用到项目文件\reject\rj拒绝某个文件的待处理改动\log无显示计划更新日志\rewind\rw回退到之前的某个状态\continue\c继续执行计划\branches\br列出计划分支\checkout\co切换或创建分支\models无查看当前计划的模型设置\set-model无更新当前计划的模型设置\ps无列出活跃/最近完成的计划流\stop无停止活跃的计划流\connect\conn连接到活跃的计划流在 app/cli/cmd/repl.go 的executor中\之后的字符串会被解析成命令通过ExecPlandexCommandWithParams以子进程方式执行详见下文命令执行的实现原理执行完毕后 prompt 会恢复继续接受下一条输入。3.2 REPL 专属命令除了透传的 CLI 命令REPL 还内置了 7 个专属命令app/cli/cmd/repl.go 的execWithInput中实现命令别名功能\quit\q退出 REPL源码中直接os.Exit(0)\help\h显示帮助重新打印欢迎信息并列出全部命令 相对路径—将文件加载进上下文若处于 auto-context 模式手动加载为可选操作\run\r将文件内容作为 prompt 发送tell -f file或chat -f file取决于当前模式\chat\ch切换到 chat 模式只对话不产生改动\tell\t切换到 tell 模式执行任务、写代码\multi\m切换多行模式回车换行而非发送\send\s发送当前 prompt多行模式下发送用因为此时回车是换行从源码 app/cli/lib/repl.go 可以看到这些别名统一定义在ReplCmdAliases中var ReplCmdAliases map[string]string{ chat: ch, tell: t, multi: m, quit: q, help: h, run: r, send: s, }3.3 多行模式\multi单行模式下回车即发送 prompt。要输入带换行的长 prompt例如多段需求说明输入\multi或\m进入多行模式回车 → 插入换行\send或\s→ 将多行内容作为一条完整 prompt 发送。源码中\send的处理会剥离命令本身并把剩余的多行文本作为 promptapp/cli/cmd/repl.go若没有可发送的内容会提示No prompt to send。3.4 用加载文件到上下文在 prompt 中输入加相对文件路径即可把文件载入上下文例如请参考 src/utils.go 和 docs/api.md 重构这段逻辑其实现逻辑位于 app/cli/cmd/repl.go后面的路径会被收集并转换成\load paths -r命令执行执行后 prompt 中之前已输入的文字会被保留回填到输入框中方便你继续补充 prompt。支持同时引用多个文件并且会自动补全路径。四、两种工作模式chat 与 tellPlandex REPL 的核心设计是对话chat与实现tell分离chat 模式与 AI 自由对话、分析问题、讨论方案不产生任何代码改动tell 模式⚡️描述编码任务让 Plandex 真正去实现——写代码、构建文件、产生待应用的改动。在 prompt 输入框前的提示符中chat 模式显示 tell 模式显示 ⚡️若同时开启了 auto-apply 与 auto-exec 会额外显示 ❗️ 提醒见 app/cli/cmd/repl.go。可以通过\chat/\ch和\tell/\t随时切换模式会持久化到下次会话。一个值得注意的交互细节在 chat 模式下如果 AI 的回复中表达了切换到实现/编码的意图REPL 会检测输出并询问你是否切换到 tell 模式开始实现确认后可直接基于当前对话开始实现tell --from-chat形成先聊方案、确认后落地的流畅工作流app/cli/cmd/repl.go。五、REPL 启动 Flags一次配置模式、自主级别与模型包REPL 支持在启动时通过 flags 预设模式、自主级别和模型包无需进入后再手动设置。这些 flags 定义在 app/cli/cmd/plan_start_helpers.go 的AddNewPlanFlags中repl命令在初始化时通过AddNewPlanFlags(replCmd)挂载app/cli/cmd/repl.go。5.1 模式 Flags--chat, -c Start in chat mode (for conversation without making changes) --tell, -t Start in tell mode (for implementation)注意--chat与--tell互斥同时指定会报错Cannot specify both --chat and --tell flagsapp/cli/cmd/repl.go。5.2 自主级别AutonomyFlagsPlandex 将自主程度划分为 5 个级别从完全手动到全自动--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它们与set-auto命令控制的配置一一对应启动时传入后若当前目录没有 current plan会被透传给new命令以创建带对应自主级别的计划。5.3 模型包Model PackFlags--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在 app/cli/cmd/repl.go 中这些 flags 会被按优先级--no-auto→--full、--oss→--opus-planner等收集并透传给new命令。此外源码中还有一个 REPL 帮助里也列出但官方 repl.md 中未提及的--reasoningReasoning pack可作为补充了解。5.4 组合示例# 以 tell 模式 全自动 强模型包启动 plandex --tell --full --strong # 以 chat 模式 半自动 每日驱动模型启动 pdx -c --semi --daily # 以 tell 模式 手动逐步确认 开源模型启动 plandex -t --no-auto --oss建议组合初次使用时建议--no-auto或默认级别逐步熟悉\apply、\reject、\diff等操作对模型质量和成本有明确需求时再组合模型包 flags。六、REPL 的底层实现原理6.1 子进程执行模型为什么 REPL 不会崩溃REPL 执行命令的核心是 app/cli/lib/repl.go 的ExecPlandexCommand它重新启动同一个二进制exec.Command(os.Args[0], args...)把标准输入输出直接连接到当前终端并通过临时文件捕获命令输出。这样做有两个关键收益隔离性子进程中的任何os.Exit都不会杀死 REPL 主进程命令失败后 prompt 依然存活信号安全REPL 忽略 SIGINT并将中断/终止信号转发给子进程组app/cli/lib/repl.go因此你在 REPL 内执行命令时按 CtrlC 只会中断子命令。REPL 还会通过环境变量向子进程传递终端信息列宽、深/浅色背景、流式前景色、跳过升级检查等确保子命令的渲染与 REPL 一致app/cli/lib/repl.go。6.2 状态持久化模式与历史记录REPL 的模式与输入历史被序列化为 JSON存放在~/.plandex/repl_settings/projectId.jsonapp/cli/lib/repl.go。每次执行输入都会调用WriteHistory追加记录app/cli/cmd/repl.go\multi、\chat、\tell等切换操作都会调用WriteState持久化当前状态——这也是为什么你退出后重新进入模式和提示符状态还能保持一致。6.3 智能补全与容错REPL 的补全器app/cli/cmd/repl.go支持命令模糊补全输入\前缀后基于模糊匹配fuzzy matching和前缀匹配给出命令建议并把内置命令\chat、\tell、\multi、\quit等排在前面路径补全对和\load提供项目内活动路径建议目录会附加/嵌套命令补全\load dir -r、\load dir --map、\load dir --tree、\run file.md等上下文相关的建议。容错方面如果输入了疑似命令但缺少反斜杠如直接输入load、diffREPL 会弹出你是不是想输入这些命令的选择列表若命令拼写相近编辑距离阈值内见 app/cli/cmd/repl.go 的findSimilarCommands也会给出候选找不到命令时还会提供显示可用命令选项。七、实战工作流示例场景一先讨论方案再落地实现# 1. 以 chat 模式启动 plandex -c # 2. 讨论方案纯对话不产生改动 我的服务端 API 响应时间变慢了帮我分析一下可能的原因 # 3. 确认方案后切换到 tell 模式 \t # 4. 描述任务 ⚡️ 基于刚才讨论的方案为 /api/users 增加分页和缓存场景二加载上下文 多行 prompt 一次性实现# 在 tell 模式下输入 \multi 进入多行模式 \multi # 粘贴多行需求末尾用 \send 发送 请重构以下文件的错误处理逻辑 1. 统一错误类型 2. 增加日志记录 3. 补充单元测试 \send场景三一键带配置启动# 全自动 强模型直接进入 tell 模式开工 pdx -t --full --strong八、小结与进一步阅读Plandex REPL 通过对话chat/ 实现tell双模式 全量 CLI 命令透传 启动 flags 预设配置的设计把 AI 编码代理的完整工作流收敛进一个交互式终端界面中。理解其核心命令、模式切换与状态持久化机制能够显著提升你的日常使用效率。如果想继续深入了解可以从以下仓库文件入手app/cli/cmd/repl.goREPL 入口、命令解析、补全与欢迎界面app/cli/lib/repl.go状态管理、历史记录与子进程执行模型app/cli/term/help.goREPL 命令注册表与帮助输出app/cli/cmd/plan_start_helpers.go启动 flags自主级别与模型包定义docs/docs/cli-reference.md全部 CLI 命令的参考文档。【免费下载链接】plandexOpen source AI coding agent. Designed for large projects and real world tasks.项目地址: https://gitcode.com/GitHub_Trending/pl/plandex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考