BAIZE AI RESOURCE

内置嵌入式 Shell 与编辑引擎的终端 AI 编程 Agent

oh-my-pi

内置嵌入式 Shell 与编辑引擎的终端 AI 编程 Agent

oh-my-pi

资源介绍

oh-my-pi(命令行名 omp)是一个以 Rust 为主、Bazel 构建的终端 AI 编程 Agent。它的核心特点是把 Shell 与常用命令行工具直接嵌入进程:pi-builtins 提供两层内置命令——一层是 cd、echo、test、printf、read、export、trap、wait 等 Shell 内建命令(基于 brush-builtins 的本地分支),另一层是 cat、grep/rg、sed、ls、find、sort、jq、fd、diff、xargs、ps、top、kill 等约 50 个 coreutils 风格工具,使长驻 Shell 在任何平台上都能自行解析这些命令名,无需依赖宿主是否安装真实二进制。

围绕编码任务,仓库还提供 pi-ast(基于 tree-sitter 的 AST 解析与摘要)、pi-edit(支持 apply_patch、hashline、sloppy 等多种补丁语法的编辑引擎,含模糊匹配与差异生成)、pi-diff 等 crate,以及 .omp/skills 下的语义压缩、系统提示词编写、工具提示词优化等技能文档。发布物为各平台单文件可执行程序(macOS、Linux glibc/musl、Windows,x64 与 arm64),并附带浏览器中继扩展包。适合希望在终端内获得可定制、可离线自足编码 Agent 的开发者。

Agent 能力

嵌入式 Shell 与内置命令

pi-builtins 把 Shell 内建命令与约 50 个 coreutils 风格工具(cat、grep/rg、sed、ls、find、sort、jq、fd、diff、xargs、ps、top、kill 等)编译进进程,长驻 Shell 自行解析命令名,不依赖宿主是否安装真实二进制,也无需 fork。

多语法补丁编辑引擎

pi-edit 支持 apply_patch、hashline、sloppy 等多种补丁语法,各自配有 Lark 语法文件与提示词,并提供模糊匹配、差异字符串生成与文件操作模块,用于让模型以结构化补丁方式修改代码。

AST 解析与代码摘要

pi-ast 基于 tree-sitter 提供多语言解析、块提取、操作与解析缓存,并生成代码摘要,供 Agent 做结构化代码检索与理解。

提示词与技能工程文档

.omp/skills 下提供 semantic-compression(把冗长散文重编码为高密度电报体)、system-prompts(RFC 2119 关键词与标签约定的系统提示词写法)、tool-prompt-optimization(用探针脚本测量提示词与 JSON schema 的重叠以裁剪冗余)三套技能。

资源配置

运行平台

本地运行

Agent框架

自研框架

配置方式

配置文件环境变量API Key

依赖资源

内置 Shell 与约 50 个进程内命令工具(pi-builtins),无需系统预装 coreutils;工具提示词优化脚本依赖 Bun 与 @oh-my-pi/pi-ai,并需要 FIREWORKS_API_KEY / ANTHROPIC_API_KEY / OPENAI_API_KEY 之一;源码构建使用 Bazel 与 Cargo。

运行与使用

  1. 安装适合当前系统的 oh-my-pi 命令行程序,并配置要使用的模型服务。

  2. 在目标项目目录启动 omp,向 Agent 说明任务、文件范围和不可执行的操作。

  3. 让它使用内置文件、搜索、Shell 和编辑能力完成分析或修改,长任务可按阶段确认。

  4. 检查执行记录、代码差异与测试结果后再提交;对高风险命令仍需人工批准。

使用案例

终端内代码检索与修改

使用场景开发编程

在项目目录运行 omp,让 Agent 用内置的 grep/rg、find、fd 检索代码,再通过 pi-edit 的补丁语法修改文件,全程不依赖系统是否安装这些命令行工具。

压缩系统提示词与工具描述

使用场景AI开发

使用 semantic-compression 技能,把冗长的工具描述或系统提示词重编码为标签框架、无动词断言等高密度写法,在保留 MUST/NEVER 等规范性约束的前提下降低 token 占用。

审计工具提示词冗余

使用场景开发编程

用 tool-prompt-optimization 的 probe-builtin.ts 实例化真实工具,取得 wire schema 与提示词,判断哪些行可由参数 schema 推断、哪些属于必须保留的默认值、输出形状与路由规则。

包含内容

oh-my-pi-source.zip
README-中文安装说明.md
LICENSE-MIT.txt
THIRD-PARTY-NOTICES.md
SHA256.txt