pi 进程
管理来自 Pi 的背景进程而不阻碍对话 .
这个扩展让Pi在对话持续期间保持了长期运行的命令活性. 它对dev服务器,测试监视器,本地API,构建,和日志尾巴都有用.
让皮在进程运行时继续工作
当任务需要长期运行的指令时,Pi可以自己在背景中启动,并不断帮助其他工作.
也就是说Pi可以:
- 启动 dev 服务器并保持编码
- 在测试监视器修正失败时保持运行
- 在检查日志时运行本地 API
- 在不屏蔽对话的情况下监视构建输出
然后,您可以检查, 钉住,停止, 或从UI清除这些过程.
安装
从 npm :
pi install npm:@aliou/pi-processes
从 gi:
pi install git:github.com/aliou/pi-processes
皮如何保持循环
Pi 不等待背景进程 。 在它开始之后,它继续帮助 其余的工作, 并被自动带回来 当一些事情发生:
- 在日志中显示准备状态标记( 服务器打印“ 准备” )
- 在日志中出现错误(构建打印出类型错误)
- 进程退出,无论是成功还是失败,还是被杀死
这样,Pi就可以启动dev服务器,然后继续编码,或者运行一个测试监视器,并在测试失败时作出反应,而不睡觉或投票. 如果一只表起火太频繁,皮可以不重启过程而安静.
打开进程面板
使用 /ps 打开主进程面板。 它显示运行和完成的进程,并有最新的输出预览. 预览会在最新的一页上打开,这样就可以在不滚动的情况下看到活的活动.
从那里你可以:
- 查看运行和完成的进程
- 检查最近的产出
- 将进程刻入码头
- 杀死正在运行的进程
- 清除已完成的条目
检查日志
使用 /ps:logs [id] 打开一个进程的日志覆盖。 查看器是每个进程缓存的,因此切换分页保留了滚动位置并遵循模式.
当 Pi 启动服务器、 监视器或本地 API 时, 这是有用的, 您想要更详细地跟踪它正在做的事情 .
控制码头
使用 /ps:dock [expand|collapse|close] 来控制码头的能见度,或者单击码头在倒塌和被扩展之间切换.
码头给你一个紧凑的现场视野 而不离开对话.
Pin 1 进程
使用 /ps:pin [id] 使码头专注于一个过程.
当一个进程比其他进程更重要时,例如dev服务器或测试监视器时,这样做是有用的.
没有争吵,皮会显示一个拾取者.
停止和明确程序
使用 /ps:kill [id] 停止运行过程,以及 /ps:clear 从面板中删除已完成的条目,并释放日志存储.
/ps:kill 等待进程实际退出(或超时),所以它报告的结果反映了所发生的情况. 没有争吵,皮会显示一个拾取者.
/ps:clear 从不接触活的过程.
保持状态行查看
启用状态部件 /ps:settings 以显示编辑器下方的紧凑行。 Live 进程显示为状态点加名称; 完成进程折叠为 ✓ N done, (中文(简体) ), ! N failed,以及 ■ N killed 摘要(在下一个进程开始之前,最近的失败按名称显示). +N more 当线不合适时会出现溢出.
默认已禁用 。 当进程列表为空时, 部件会重排大小并清除它 .
向进程发送输入
使用 process 工具为 action: "write" 将字节发送给运行中进程的 stdin。 这就是您如何驱动交互服务器,REPLs,以及期望在启动后输入的CLI.
过 input 用于编写字节并设定 end: true 以关闭 stdin(例如将 EOF 信号给等待进程).
调整设置
使用 /ps:settings 以配置扩展名。 项目设置
.pi/extensions/processes.json 只在 Pi 信任工程后应用 .
未信任的项目文件保持不变, 本地标签显示
“ 项目不可信”而不是可编辑设置 。 使用 /trust 并重新启动
Pi 用于应用工程设置 。 全球和记忆设置仍然可用.
可用的设置包括:
- shell 路径覆盖
- 屏蔽外壳背景图案( e)
&, (中文(简体) ),nohup, (中文(简体) ),disown, (中文(简体) ),setsid)在bash calls中,将Pi重定向到进程工具上 - 状态部件切换
- 进程面板大小
- 日志覆盖大小、历史限制、跟踪模式和自动隐藏
- 站点默认状态和行数
- 工具曝光( e)
direct, (中文(简体) ),model-only, (中文(简体) ),codemode, (中文(简体) ),deferred,或hidden; 全局标签, 在下次会话开始时应用)
平台支持
- macOS: 已支持
- Linux: 已支持
- 视窗: 不支持
类似但不同
Pi拥有多个进程,终端,和背景任务扩展. pi-进程侧重于明确的LLM管理背景流程,日志检查,能唤醒毒剂的手表,Pi UI表面用于 /ps,日志,码头,和状态.
见 pi. dev/包装 用于完整注册 Pi 扩展.
背景命令管理器
这些软件包最接近当您想要 shell 命令, Dev 服务器, 监视器, 或日志在 Pi 继续对话时继续运行时.
- pi 背景任务: 耐用背景外壳任务外加授权的儿童 Pi工作流程.
- @ 99%的人/皮-背地任务:背景命令和可附加的PTY/TUI会话,有SSH远程集成.
- @richardgill/皮-后地-bash: 替换
bash与会场所属的本地流程组并添加bash_process名单 偷看 杀人. - p-bash-bg页:1
&支持 Pi 的 bash 工具, 解析背景进程并让输出远离上下文窗口 . - 皮-天-背-地-地-地: 将 Pi 的内置 Bash 替换为自动背景生成、 完成通知和 a
/ps观者. - 更好的背景任务:耐用背景外壳任务,监视器,日志,以及状态检查.
- pi -patty -bg -任务: Claude Code 风格的背景任务,具有自动背景,附加,文件后置输出,以及合作引导等功能.
- @ mjakl/ pi- 进程: 剥去的 pi- processes 叉
process工具,单个/ps重叠,一个紧凑状态行,并减少命令/设置. - @haemmid/ pi- 进程: pi-web-聚焦 pi-processes for dev-server 自动化的分叉,带有
ensure, (中文(简体) ),restart,以及waitastro/Vite类工作流程的动作. - pi- processes- git- bash (英语):通过Git Bash为Windows用户提供pi-processes分叉.
终端和外壳替换
这些软件包在您需要不同的 shell 底盘, PTY 行为, 或平台特定终端支持时更适合使用.
- pi 统一执行: Codex风格的长寿命 shell会话,包含stdin,PTY,REPL,SSH,dev-server,和磁盘-log支持.
- 活-死: tmux 后置命令跑取器,带有活的终端部件.
- @aliaksei-raketski/pi-tmux-bash (英语): 在管理的 tmux 窗口中运行模型化 shell 命令 .
- @ 4fu/ pi- pwsh (英语):持续为 Pi 在Windows 上的PowerShell任务,包含 ConPTY会话和用户请求.
- pi-pwsh- 通知( i): PowerShell shell 有背景任务和完成/服务器准备通知.
监测器、调度器和能见度
这些软件包更多的是观察,唤醒,或者表面过程状态,而不是直接替换pi过程.
- pi -事件监测器: 事件驱动 shell 流和文件监视器在进程退出,匹配输出或文件写入时将会话唤醒.
- pi- 监视器- 插件:背景工作,显示器,回路,时刻表,和闲置意识通知.
- 双线线: 代理喷发的本地主机服务器的页脚能见度;而不是进程运行器本身.
- @ cortexkit/ aft- pi: 更广泛的 Agent 文件工具包, 包括背景bash任务, PTY会话, 以及输出压缩和代码分析工具 .
实例
examples/ 有扩展片段可以复制到 ~/.pi/agent/extensions/ 并适应。 见 examples/README.md 为每个人的行为.
特性演示
监视文件备份日志并从错误中恢复
打开日志覆盖并检查输出
停止和明确程序
向运行的进程发送输入
捐款
关于开发、测试、文件生成和扩展内部,见 捐款额。 。 。 .
许可证
麻省理工学院