omp²

没有保留席位,
内置功能也用同一套 API。

工具、斜杠命令、快捷键、TUI 组件、hooks 与 MCP 都是公开原语。你可以从配置改起,也可以直接写 TypeScript 扩展,或把已有工具的规则原样接过来。

Extensions

一个模块,
装下你的工作流。

扩展是 TypeScript 模块,能注册工具、命令、快捷键、渲染组件与事件钩子。它拿到的 API 与内置功能相同:没有内部特权,也没有“仅官方可用”的接口。

  • 同一套 tool / slash / hotkey registry
  • TUI 原语与工具卡片可复用
  • /reload-plugins 热加载
my-extension.ts — 形状示意
export default function extension(ctx) {
  ctx.registerTool({
    name: "deploy_preview",
    description: "Deploy current branch to preview",
    schema: { branch: "string" },
    async run({ branch }) {
      const out = await ctx.bash(`git push origin ${branch}`);
      return { url: out.trim() };
    },
  });

  ctx.registerCommand("preview", async () => {
    // 斜杠命令与内置命令同权重
  });
}

示意代码,展示注册面而非逐字 API;实际签名见官方扩展文档。

Skills

把经验写成可复用的技能。

技能是带 SKILL.md 的目录:何时触发、按什么步骤做、附带哪些脚本与资源。它们按需加载,不常驻上下文。

AUTHOR

写

用 manage_skill 创建、更新或删除受管技能;也可以直接写目录。任务完成后可让代理把经验固化为技能。

DISCOVER

发现

从项目、用户目录与已安装插件中发现;--skills 'git-*,docker' 过滤,--no-skills 全部关闭。

SHARE

分发

Skillshare 注册表在 skills.omp.sh;omp skill 支持安装、搜索、发布与管理。

MCP

MCP 是原生输入,
不是补丁。

支持 stdio、Streamable HTTP 与 SSE;项目级与用户级配置分层,凭据按 profile 隔离。还能直接读取其他客户端的 MCP 配置。

位置范围
.omp/mcp.json项目
~/.omp/agent/mcp.json用户(默认 profile)
~/.omp/profiles/<name>/agent/mcp.json命名 profile
mcp.json / .mcp.json项目根回退文件
Claude / Cursor / Codex / Gemini / OpenCode / Windsurf / VS Code自动继承

同一名称以更高优先级来源为准;用户级 disabledServers 可以压过任何来源。

~/.omp/agent/mcp.json — 本站使用的配置
{
  "mcpServers": {
    "drop": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@micropue/drop-mcp"],
      "env": {
        "DROP_API_KEY": "${DROP_API_KEY}",
        "DROP_ALLOWED_ROOTS": "~/Desktop:/private/tmp"
      }
    }
  }
}
✓本站就是由 omp 生成,并通过上面的 DROP MCP 发布:检查 Key、创建项目、返回公开 URL,全程在会话内完成。
Rules

规则平时休眠,
越界时现身。

常规规则文件只在需要时参与;TTSR(time-traveling stream rules)用正则监视流式输出,命中即中止、注入规则、从同一点重试。

这让“不要在代码里用 Box::leak”这类约束不必每轮都占上下文,却能在模型真的写出它的那一刻生效。注入内容会跨压实保留,修正不会在长会话里被淡忘。

规则来源包括项目与用户目录,并兼容其他工具的原生格式。

触发 → 注入 → 重试TTSR
# 规则:禁止生产路径使用 Box::leak
match: /Box::leak/
action: abort stream
inject: "不要在生产代码路径使用 Box::leak"
retry: same point

# 模型随即改用 Arc<str> 并说明原因

示意流程。规则只在流中出现匹配时支付注入成本。

Inheritance

不要求你先迁移。

首次运行就读取磁盘上已有的配置:规则、技能、MCP 服务器,按原格式解释。

来源读取内容典型文件
Claude CodeMCP、规则、技能~/.claude.json、.claude/
Cursor规则(MDC)、MCP.cursor/rules/、.cursor/mcp.json
CodexAGENTS.md、MCPAGENTS.md、~/.codex/config.toml
Gemini CLI设置与 MCP~/.gemini/settings.json
Cline规则.clinerules
GitHub CopilotapplyTo 规则.github/copilot-instructions.md
OpenCodeMCP 与设置opencode.json
Windsurf / VS CodeMCPmcp_config.json、.vscode/mcp.json
!继承是便利,也是信任边界:打开仓库会加载它的扩展、hooks 与 MCP。对不信任的检出使用 --no-extensions、--trusted-extension 或关闭项目 MCP。
Plugins

留在本地,还是发到 npm。

plugin lifecycle
omp plugin install <package>
omp plugin link ./my-plugin
omp plugin list
omp plugin uninstall <package>

# 会话内热加载
/reload-plugins

插件可以只在本机 link,也可以进入 marketplace 分发。扩展作者能复用内置工具卡片的渲染、状态行、选择器与对话框,不必自己维护一套终端 UI。

需要某个能力时,也可以直接让 omp 把扩展写出来,再用 /reload-plugins 生效。

扩展源码与示例