oh-my-pi：终端里的 AI 编程伙伴

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 方式一：一键脚本（macOS/Linux，最省事）
curl -fsSL https://omp.sh/install | sh

# 方式二：Homebrew（macOS）
brew install can1357/tap/omp

# 方式三：Bun 全局安装（推荐，更新方便）
bun install -g @oh-my-pi/pi-coding-agent

# 方式四：Nix（声明式配置友好）
nix profile install github:can1357/oh-my-pi

# 方式五：mise 版本管理
mise use -g github:can1357/oh-my-pi

1

irm https://omp.sh/install.ps1 | iex

1

apk add libstdc++ libgcc

1
2
3
4

local wezterm = require 'wezterm'
local config = wezterm.config_builder()
config.enable_kitty_keyboard = true
return config

1
2
3
4
5
6
7
8
9

# 在 ~/.config/fish/config.fish 或 ~/.bashrc 中
set -x ANTHROPIC_API_KEY "sk-ant-..."
set -x OPENAI_API_KEY "sk-..."
set -x GEMINI_API_KEY "AIza..."
set -x DEEPSEEK_API_KEY "sk-..."
set -x GROQ_API_KEY "gsk-..."
set -x XAI_API_KEY "xai-..."
set -x MISTRAL_API_KEY "..."
set -x OPENROUTER_API_KEY "sk-or-..."

1
2
3
4
5

set -x PI_DEFAULT_MODEL "anthropic/claude-sonnet-4-6"
set -x PI_SMOL_MODEL "deepseek/deepseek-v4-flash"
set -x PI_SLOW_MODEL "anthropic/claude-opus-4-6"
set -x PI_PLAN_MODEL "anthropic/claude-opus-4-6:high"
set -x PI_ADVISOR_MODEL "openai/gpt-4o-mini"

1
2
3
4
5
6
7
8

# zsh — 添加到 ~/.zshrc
eval "$(omp completions zsh)"

# bash — 添加到 ~/.bashrc
eval "$(omp completions bash)"

# fish — 写到 completions 目录
omp completions fish > ~/.config/fish/completions/omp.fish

1
2
3
4

# 第一个 cell — Python 内核加载 CSV
import pandas as pd
df = pd.read_csv("data.csv")
print(df.describe())

1
2
3
4
5

// 第二个 cell — JS Worker 接着分析
const topScorer = rows.reduce((acc, r) =>
  r.score > acc.score ? r : acc
, rows[0]);
display(`Top scorer: ${topScorer.name}`);

1

omp setup python    # 安装 Jupyter 内核

1
2
3
4
5
6
7
8
9

task:
  concurrency: 32           # 默认并发数
  isolation:
    mode: fuse-overlay      # 隔离后端
    merge: patch            # 合并策略：patch 或 branch

async:
  enabled: true             # 允许后台任务
  maxJobs: 100

1
2
3
4

omp commit              # 标准 commit
omp commit --dry-run    # 预览不执行
omp commit --push       # commit 后自动 push
omp commit --no-changelog   # 跳过 changelog

1
2

# 终端里读 arxiv 论文
> read https://arxiv.org/pdf/2604.10739v1

1
2
3
4
5

# 配置示例
debug:
  enabled: true             # 总开关
  adapter: lldb-dap          # 默认 adapter
  attach: stdio              # stdio / unix / TCP / pid

1
2
3

modelRoles:
  default: anthropic/claude-sonnet-4-6    # 主 doer
  advisor: openai/gpt-4o-mini             # 便宜的 reviewer

1
2
3

/review                # 审查当前工作区
/review main..HEAD     # 审查分支差异
/review HEAD~3..HEAD   # 审查最近 3 个 commit

1
2

/collab                # read-write 协作
/collab view           # 只读链接，旁观者不能操作 agent

1
2
3
4
5

read issue://123                       # 读 issue #123
read pr://456                          # 读 PR #456 元数据
read pr://456/diff/2                   # 读 PR #456 的第 2 个 diff hunk
read pr://456/files/src/api.ts         # 读 PR 修改后的某个文件
read github://owner/repo               # 整个仓库

  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
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109

# ═══════════════════════════════════════
# 主题与外观
# ═══════════════════════════════════════
theme:
  dark: titanium              # 暗色主题（65+ 内置可选：catppuccin, dracula, nord, tokyo-night...）
  light: light                # 亮色主题
  # omp 支持自动检测终端外观（Mode 2031 / macOS CoreFoundation / COLORFGBG）

display:
  tabWidth: 4                 # Tab 渲染宽度（支持 .editorconfig 集成）

terminal:
  showImages: true            # 在 Kitty/iTerm2/Ghostty 中内联显示图片（含 SIXEL）

# ═══════════════════════════════════════
# 模型与 Provider
# ═══════════════════════════════════════
enabledModels:                  # 白名单
  - "anthropic/*"
  - "gpt-5.5*"
  - "gemini-3.7-flash*"

modelRoles:                     # 角色到模型的路由
  default: claude-sonnet-4-6    # 日常实现
  plan: claude-opus-4-6:high    # /plan 模式
  smol: deepseek/deepseek-v4-flash  # 快速探索
  commit: claude-sonnet-4-6     # commit 生成
  advisor: openai/gpt-4o-mini   # v17 第二审阅

modelProviderOrder:              # 同模型多 Provider 优先级
  - github-copilot
  - openai

defaultThinkingLevel: high      # off/minimal/low/medium/high/xhigh

# ═══════════════════════════════════════
# 采样控制
# ═══════════════════════════════════════
topP: -1
topK: -1
minP: -1

# ═══════════════════════════════════════
# 重试与容错
# ═══════════════════════════════════════
retry:
  enabled: true
  maxRetries: 3
  baseDelayMs: 2000
  fallbackChains:               # 角色级 fallback
    default:
      - "openai/gpt-4o-mini"
      - "openai/gpt-4o"
    plan:
      - "anthropic/claude-sonnet-4-6:high"
      - "openai/o3:high"
  fallbackRevertPolicy: cooldown-expiry

# ═══════════════════════════════════════
# 上下文管理
# ═══════════════════════════════════════
compaction:
  enabled: true
  reserveTokens: 16384
  keepRecentTokens: 20000
  autoContinue: true

# ═══════════════════════════════════════
# 自动记忆（v17 mnemopi）
# ═══════════════════════════════════════
memory:
  backend: mnemopi              # v17 新后端
  scope: per-project            # global / per-project / tagged

# ═══════════════════════════════════════
# Skills 与扩展
# ═══════════════════════════════════════
skills:
  enabled: true
  enableSkillCommands: true

# ═══════════════════════════════════════
# Task / Subagent
# ═══════════════════════════════════════
task:
  concurrency: 32               # v17 默认
  isolation:
    mode: fuse-overlay          # none / worktree / fuse-overlay / fuse-projfs
    merge: patch

async:
  enabled: true
  maxJobs: 100

# ═══════════════════════════════════════
# 交互模式
# ═══════════════════════════════════════
steeringMode: one-at-a-time
followUpMode: one-at-a-time
interruptMode: immediate

# ═══════════════════════════════════════
# Shell 与 Bash
# ═══════════════════════════════════════
shellPath: /bin/bash
hideThinkingBlock: false

todo:
  reminders: true

 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

providers:
  # 本地 Ollama
  ollama:
    baseUrl: http://localhost:11434/v1
    apiKey: ***       # 引用环境变量
    api: openai-completions
    models:
      - id: llama-3.1-8b
        name: Llama 3.1 8B (Local)
        reasoning: false
        input: [text]
        cost: {input: 0, output: 0, cacheRead: 0, cacheWrite: 0}
        contextWindow: 128000
        maxTokens: 32000

  # vLLM / llama.cpp 本地推理
  llama.cpp:
    baseUrl: http://127.0.0.1:8080
    api: openai-responses
    auth: none

# 模型等价映射
equivalence:
  overrides:
    my-relay/claude-sonnet-4-6: claude-sonnet-4-6

1
2
3
4
5
6
7
8
9

{
  "modelRoles": {
    "default": "gemini-3.7-flash:high"
  },
  "disabledExtensions": ["cursor"],
  "compaction": {
    "reserveTokens": 32768
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

# 项目规范

## 架构
- 后端：Go 标准库 + SQLite
- 前端：Vue 3 + TypeScript

## 编码规范
- Go 代码用 gofmt 格式化
- 提交消息遵循 Conventional Commits
- 测试用 `_test.go` 后缀

## 常用命令
- `make build`：编译
- `make test`：测试
- `make lint`：lint 检查

## 禁止
- 不要修改 migrations/ 目录下的已有文件
- 不要使用 deprecated API

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

---
name: brave-search
description: Web search via Brave Search API. Use when user asks to search the web.
---

# Brave Search

Use the Brave Search API for web queries. API key is in environment variable BRAVE_API_KEY.

...

1
2
3
4
5
6
7
8
9

---
description: Review staged git changes
---

Review the staged changes (`git diff --cached`). Focus on:

- Bugs and logic errors
- Security issues
- Error handling gaps

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

import type { CustomCommandFactory } from "@oh-my-pi/pi-coding-agent";

const factory: CustomCommandFactory = () => ({
  name: "deploy",
  description: "Deploy to staging",
  async execute(args, ctx) {
    const confirmed = await ctx.ui.confirm("Deploy to staging?", args);
    if (!confirmed) return;
    await ctx.shell("make deploy-staging");
    return "Deployment complete. Run tests to verify.";
  },
});

export default factory;

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

import type { HookAPI } from "@oh-my-pi/pi-coding-agent/hooks";

export default function (omp: HookAPI) {
  omp.on("tool_call", async (event, ctx) => {
    if (event.toolName === "bash" && /sudo/.test(event.input.command as string)) {
      const ok = await ctx.ui.confirm("Allow sudo?", event.input.command as string);
      if (!ok) return { block: true, reason: "Blocked by user" };
    }
    return undefined;
  });
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

import { Type } from "@sinclair/typebox";
import type { CustomToolFactory } from "@oh-my-pi/pi-coding-agent";

const factory: CustomToolFactory = () => ({
  name: "greet",
  label: "Greeting",
  description: "Generate a greeting",
  parameters: Type.Object({
    name: Type.String({ description: "Name to greet" }),
  }),
  async execute(_toolCallId, params) {
    const { name } = params as { name: string };
    return { content: [{ type: "text", text: `Hello, ${name}!` }] };
  },
});

export default factory;

1
2
3
4

retain <fact>               # 写入事实（带 embedding）
recall <query>              # 向量检索 + 图遍历
reflect <topic>             # 综合多个事实，生成结构化结论
memory_edit <id> <new_fact> # 按 id 修订事实

1
2
3

memory:
  backend: mnemopi
  scope: per-project         # global / per-project / tagged

1
2
3
4
5

omp                    # 启动新会话
omp -c                 # 继续最近的会话
omp -r                 # 打开会话选择器
omp -r abc123          # 按 ID 前缀恢复
omp --no-session       # 临时模式（不保存）

1
2

/compact                           # 自动压缩
/compact Focus on the API changes  # 带焦点的压缩

1

/handoff Focus on the database migration

1
2

!git status          # 执行并将输出纳入 LLM 上下文
!!git status         # 执行但排除输出（不影响上下文）

1

omp stats    # 启动本地可观测性 Dashboard

1

/settings    # 交互式选择主题

1
2
3

theme:
  dark: titanium
  light: light

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 1. 交互式 TUI（默认）
omp

# 2. 单次 prompt 后退出
omp -p "list .ts files"

# 3. RPC 模式（NDJSON over stdio）
omp --mode rpc
# 外部进程通过 NDJSON frames 与 omp 通信
# --mode rpc-ui 加 extension_ui_request 支持

# 4. ACP 模式（编辑器协议）
omp acp
# 在 Zed 等支持 ACP 的编辑器里跑同一个 agent

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

import {
  ModelRegistry, SessionManager,
  createAgentSession, discoverAuthStorage,
} from "@oh-my-pi/pi-coding-agent";

const auth = await discoverAuthStorage();
const models = new ModelRegistry(auth);
await models.refresh();

const { session } = await createAgentSession({
  sessionManager: SessionManager.inMemory(),
  authStorage: auth, modelRegistry: models,
});
await session.prompt("list .ts files");