没有保留席位,
内置功能也用同一套 API。
工具、斜杠命令、快捷键、TUI 组件、hooks 与 MCP 都是公开原语。你可以从配置改起,也可以直接写 TypeScript 扩展,或把已有工具的规则原样接过来。
一个模块,
装下你的工作流。
扩展是 TypeScript 模块,能注册工具、命令、快捷键、渲染组件与事件钩子。它拿到的 API 与内置功能相同:没有内部特权,也没有“仅官方可用”的接口。
- 同一套 tool / slash / hotkey registry
- TUI 原语与工具卡片可复用
- /reload-plugins 热加载
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;实际签名见官方扩展文档。
把经验写成可复用的技能。
技能是带 SKILL.md 的目录:何时触发、按什么步骤做、附带哪些脚本与资源。它们按需加载,不常驻上下文。
写
用 manage_skill 创建、更新或删除受管技能;也可以直接写目录。任务完成后可让代理把经验固化为技能。
发现
从项目、用户目录与已安装插件中发现;--skills 'git-*,docker' 过滤,--no-skills 全部关闭。
分发
Skillshare 注册表在 skills.omp.sh;omp skill 支持安装、搜索、发布与管理。
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 可以压过任何来源。
{
"mcpServers": {
"drop": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@micropue/drop-mcp"],
"env": {
"DROP_API_KEY": "${DROP_API_KEY}",
"DROP_ALLOWED_ROOTS": "~/Desktop:/private/tmp"
}
}
}
}
规则平时休眠,
越界时现身。
常规规则文件只在需要时参与;TTSR(time-traveling stream rules)用正则监视流式输出,命中即中止、注入规则、从同一点重试。
这让“不要在代码里用 Box::leak”这类约束不必每轮都占上下文,却能在模型真的写出它的那一刻生效。注入内容会跨压实保留,修正不会在长会话里被淡忘。
规则来源包括项目与用户目录,并兼容其他工具的原生格式。
# 规则:禁止生产路径使用 Box::leak
match: /Box::leak/
action: abort stream
inject: "不要在生产代码路径使用 Box::leak"
retry: same point
# 模型随即改用 Arc<str> 并说明原因
示意流程。规则只在流中出现匹配时支付注入成本。
不要求你先迁移。
首次运行就读取磁盘上已有的配置:规则、技能、MCP 服务器,按原格式解释。
| 来源 | 读取内容 | 典型文件 |
|---|---|---|
| Claude Code | MCP、规则、技能 | ~/.claude.json、.claude/ |
| Cursor | 规则(MDC)、MCP | .cursor/rules/、.cursor/mcp.json |
| Codex | AGENTS.md、MCP | AGENTS.md、~/.codex/config.toml |
| Gemini CLI | 设置与 MCP | ~/.gemini/settings.json |
| Cline | 规则 | .clinerules |
| GitHub Copilot | applyTo 规则 | .github/copilot-instructions.md |
| OpenCode | MCP 与设置 | opencode.json |
| Windsurf / VS Code | MCP | mcp_config.json、.vscode/mcp.json |
--no-extensions、--trusted-extension 或关闭项目 MCP。留在本地,还是发到 npm。
omp plugin install <package>
omp plugin link ./my-plugin
omp plugin list
omp plugin uninstall <package>
# 会话内热加载
/reload-plugins
插件可以只在本机 link,也可以进入 marketplace 分发。扩展作者能复用内置工具卡片的渲染、状态行、选择器与对话框,不必自己维护一套终端 UI。
需要某个能力时,也可以直接让 omp 把扩展写出来,再用 /reload-plugins 生效。