Tutoriel de prise en main d'Oh My Pi (omp)

Oh My Pi (abréviation en ligne de commande omp) est un agent de codage IA open source qui s'exécute dans le terminal, dérivé de Pi de Mario Zechner par Can Bölük et considérablement étendu.

La philosophie centrale d'Oh My Pi est :Les outils ne devraient pas simplement "se connecter" ; ils devraient être perfectionnés—Chaque outil est optimisé par benchmark, avec un taux de réussite d'édition, une vitesse de recherche et une intégration LSP qui visent toutes à être les meilleures de leur catégorie.


Qu'est-ce que omp ?

omp est un agent de codage IApensé pour le terminal. Il ne dépend d'aucun IDE ; il s'exécute comme une TUI complète dans votre terminal, intégrant LSP, le débogueur DAP, des noyaux d'exécution doubles Python/JavaScript, le parallélisme de sous-agents, la mémoire inter-sessions et un ensemble de 32 outils optimisés pour les benchmarks.

Différences avec les autres outils de codage IA

DimensionClaude Code / outils similairesomp
Format d'éditionstr_replace (sujet aux erreurs)Hashline (ancres de hachage de contenu, résistant aux différences d'espaces blancs)
Lecture de fichiersVidage de texte intégralRésumé de structure + expansion à la demande
LSPAucun ou limité14 opérations LSP complètes (y compris renommage, saut, actions de code)
DébogueurAucuneDAP complet : lldb, dlv, debugpy
Sous-agentsAucun ou limitéSous-agents parallèles, espaces de travail isolés, valeurs de retour typées
Rechercherripgrep invoqué par le shellripgrep in-process, sans fork/exec
Correction de comportementRepose sur le promptRègles de flux : correspondance regex → injection en milieu de token → nouvelle tentative
Mémoire inter-sessionsAucuneBanque de mémoire Hindsight (niveau projet)
Exécution de codeBac à sable PythonNoyaux doubles persistants Python + Bun, peuvent appeler les outils Agent de l'autre
Stack techniqueJS/Python pur~55,000 lignes de noyau Rust + TypeScript

Installation

Cette section couvre les différentes façons d'installer omp sur macOS, Linux et Windows.

macOS / Linux (Recommandé)

$ curl -fsSL https://omp.sh/install | sh

Le script d'installation détecte automatiquement si Bun est disponible : si Bun (≥ 1.3.14) est présent, il installe via Bun en premier ; sinon, il télécharge un binaire précompilé.

Homebrew(macOS / Linux)

$ brew install can1357/tap/omp

Bun (Recommandé, obtenez la dernière version)

$ bun install -g @oh-my-pi/pi-coding-agent

Windows(PowerShell)

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

Windows prend en charge l'exécution native sans WSL.

Épinglage de version (mise)

$ mise use -g github:can1357/oh-my-pi

Vérifier l'installation

$ omp --version

Auto-complétion du shell

omp génère dynamiquement des scripts de complétion à partir des métadonnées de la CLI, afin que les sous-commandes, les options et les valeurs d'énumération ne divergent jamais de la CLI réelle :

# zsh(加入 ~/.zshrc)
eval "$(omp completions zsh)"

# bash(加入 ~/.bashrc)
eval "$(omp completions bash)"

# fish
omp completions fish > ~/.config/fish/completions/omp.fish

Compiler depuis les sources

$ git clone https://github.com/can1357/oh-my-pi
$ cd oh-my-pi
$ bun setup    # 安装 Bun 工作区依赖并构建 Rust N-API 插件
$ bun dev      # 启动开发版 CLI

# 修改 Rust 代码后,重新构建原生插件
$ bun run build:native

Configuration initiale : Connexion au fournisseur de modèle

Après avoir exécuté omp pour la première fois, utilisez /login ou /model pour configurer votre fournisseur d'IA.

Méthode 1 : Connexion OAuth en un clic (aucune clé API nécessaire)

omp prend en charge la connexion à plusieurs fournisseurs via OAuth — la méthode la plus simple :

/login                  # 打开交互式提供商选择器

Les fournisseurs prenant en charge OAuth incluent : Anthropic, OpenAI Codex, Google Antigravity (Gemini), Perplexity, Cursor, GitHub Copilot, GitLab Duo, et plus encore.

Méthode 2 : Clé API (connexion directe au fournisseur)

# 在环境变量里设置(推荐写入 ~/.zshrc 或 ~/.bashrc)
export ANTHROPIC_API_KEY="sk-ant-xxxx"
export OPENAI_API_KEY="sk-xxxx"
export GOOGLE_API_KEY="xxxx"

Ou configurez directement dans omp :

/model      # 打开模型选择器,可以在这里配置 Key

Méthode 3 : Abonnement Coding Plan

Si vous êtes déjà abonné à Cursor, GitHub Copilot, Kilo, Kimi Code, MiniMax Coding Plan, etc., vous pouvez router directement vers votre abonnement :

/login     # 选择对应的 Coding Plan 提供商,OAuth 授权

Méthode 4 : Modèles locaux (Ollama / LM Studio)

# 先启动 Ollama
$ ollama serve

# 在 omp 里选择 Ollama 提供商(key 可选)
/model     # 选择 Ollama,指向 http://localhost:11434

Chemin de configuration

Toute la configuration est stockée dans le répertoire ~/.omp/ :

~/.omp/
  agent/
    settings.yml      # 主配置文件
    models.yml        # 自定义模型/提供商
    keybindings.yml   # 快捷键绑定
    rules/            # 流规则(stream rules)
    skills/           # 技能文档

Première conversation : bases de la TUI

Cette section présente l'interface TUI plein écran d'omp et les méthodes d'interaction de base.

Lancer omp

# 在项目目录下启动
$ cd ~/your-project
$ omp

Une fois omp démarré, il passe en TUI plein écran (interface utilisateur de terminal). Les appels d'outils sont affichés sous forme de cartes, et les opérations d'édition affichent un aperçu avant d'être écrites sur le disque.

Remarque : omp utilise le protocole de clavier Kitty. Il est recommandé de l'exécuter dans des terminaux qui prennent en charge ce protocole (Kitty, Ghostty, WezTerm, iTerm2) pour une meilleure expérience.

Interaction de base

Saisissez votre tâche et appuyez sur Entrée pour l'envoyer :

> Analyze the directory structure of this project and tell me what the main modules are.

omp appelle automatiquement des outils tels que read et search pour analyser la base de code et renvoie un résumé structuré.

Raccourcis clavier courants

ToucheFonction
EntréeEnvoyer le message
Ctrl+J / Shift+EnterSaut de ligne dans le message (n'envoie pas)
Ctrl+PFaire défiler les modèles disponibles pour le rôle actuel
Shift+Ctrl+PFaire défiler en sens inverse
Ctrl+TDévelopper/réduire le panneau Todo
Ctrl+CInterrompre la tâche en cours
EscAnnuler la confirmation en attente
↑ / ↓Parcourir les messages historiques / les options
?Insérer ? lorsque la saisie est vide ; utilisez /hotkeys pour afficher la liste des raccourcis

Exécution unique (mode non interactif)

# 一次性执行任务并退出
$ omp -p "列出所有 .ts 文件里未使用的 export"

# 管道输入
$ git diff HEAD~1 | omp -p "给这个 diff 写一个精简的 commit message"

Reprendre des sessions historiques

$ omp --resume          # 打开会话选择器(Tab 补全可用)
$ omp --resume <id>     # 直接恢复指定会话

Les outils essentiels expliqués en détail

Les 32 outils d'omp sont unifiés sous un seul espace de noms ; read, search et bash sont les trois les plus fréquemment utilisés au quotidien.

read : interface de lecture unifiée

read est l'un des outils phares d'omp. Il ne se contente pas de lire des fichiers : il comprend la structure du contenu :

# 读文件(返回结构化摘要,而非全文 dump)
read src/auth/login.ts

# 读目录(返回树形结构概览)
read src/

# 读 URL(返回结构化 Markdown,锚点保留)
read https://docs.anthropic.com/en/api/messages

# 读 arxiv 论文 PDF
read https://arxiv.org/pdf/2604.10739v1

# 读 SQLite 数据库
read data/app.db

# 读 GitHub PR(统一路径接口)
read pr://can1357/oh-my-pi/1428

# 读 PR 的 diff
read pr://can1357/oh-my-pi/1428/diff/1

# 读 GitHub Issue
read issue://can1357/oh-my-pi/142

Principe clé : pour les fichiers, read renvoie unrésumé structurégénéré par Tree-sitter (noms de fonctions, noms de classes, commentaires importants) au lieu de déverser tout le fichier dans le contexte. Cela économise considérablement de tokens tout en conservant les informations clés. Lorsqu'un contenu détaillé est nécessaire, l'Agent rappelle read pour développer des sections spécifiques.

search : ripgrep intra-processus

# 正则搜索(无 fork/exec,直接在进程内跑)
search "useState\(" src/

# 带文件类型过滤
search "TODO:" --type ts

# 在内部 URL 上搜索(如 PR diff)
search "loginUser" pr://can1357/oh-my-pi/1063/diff

edit : édition précise Hashline

Voir la section suivante pour plus de détails. C'est l'un des outils les plus sophistiqués sur le plan technique d'omp.

bash : session shell persistante

# 执行命令(bash 会话在调用间保持存活)
bash: npm test
bash: git log --oneline -10
bash: cargo build --release

L'outil bash d'omp intègre le shell brush complet (une implémentation Rust de bash). Au lieu de créer un nouveau processus à chaque fois, il maintient une session persistante où les variables d'environnement et le répertoire de travail sont préservés entre les appels.

eval : noyaux persistants Python + JavaScript

Voir les sections ultérieures pour plus de détails.

lsp : opérations LSP complètes

Voir les sections ultérieures pour plus de détails.

todo : gestion des tâches

omp dispose d'une liste de tâches structurée intégrée prenant en charge les phases et le suivi de l'état des tâches. Ctrl+T bascule la visibilité du panneau Todo.

ask : questions structurées

Lorsque l'Agent a besoin d'une décision de l'utilisateur, il appelle ask pour faire apparaître un sélecteur interactif avec des options recommandées, plutôt que de mélanger les questions dans la sortie.


Hashline : édition de fichiers plus précise

Il s'agit de l'une des innovations techniques les plus importantes d'omp. Cette section présente le fonctionnement de Hashline et ses résultats de benchmark.

Problèmes avec le str_replace traditionnel

La plupart des autres agents utilisent le format str_replace pour que le modèle produise des paires « ancien contenu » + « nouveau contenu ». Le problème est :

  • Le modèle a tendance à se tromper sur les espaces, les retours à la ligne et les guillemets dans l'ancien contenu
  • Une fois le fichier modifié après l'opération de l'Agent, l'ancre devient invalide
  • Les erreurs entraînent de nombreuses nouvelles tentatives, ce qui consomme davantage de tokens

La solution de Hashline

Hashline amène le modèleà utiliser un hash du contenu pour identifier les lignes à modifierau lieu de retaper ce contenu :

# Hashline patch 示例(Agent 内部生成,你不需要手写)
@@{a3f2}
-  const result = compute(x)
+  const result = compute(x, options)
@@{b7c1}
-  return null
+  return undefined

{a3f2} est le préfixe de hash du contenu de la ligne cible. Si les modifications du fichier entraînent une non-concordance du hash, le patch serarejetéau lieu d'être appliqué silencieusement au mauvais endroit.

Résultats de benchmark

Données mesurées issues du README :

ModèleMétriqueEffet
Grok Code Fast 1Taux de réussite des modifications6.7% → 68.3% (amélioration de 10x)
Gemini 3 Flashpar rapport à str_replace+5 points de pourcentage, surpassant la meilleure implémentation de Google
Grok 4 FastConsommation de jetons en sortieRéduction de 61%
MiniMaxTaux de réussiteAmélioré de 2.1x (poids et prompt complètement inchangés)

ast_edit : Réécriture structurée de code

Un outil d'édition de niveau supérieur à Hashline ; il utilise la correspondance de motifs ast-grep suivie d'une réécriture structurée :

# 把所有 console.log(...) 替换掉
ast_edit: console.log($X) → logger.debug($X)

ast_edit renvoie d'abord unecarte proposée (aperçu); ce n'est qu'après que l'Agent confirme et appelle resolve qu'il écrit réellement sur le disque—une opération atomique qui soit réussit complètement, soit ne change rien.

ast_grep : Recherche de code structurée

Prend en charge la correspondance syntaxique Tree-sitter pour plus de 50 langages :

# 找出所有没有 await 的 async 函数调用
ast_grep: "promise.then($X)"

Intégration LSP : ce que l'IDE sait, l'Agent le sait aussi

omp intègre un client LSP (Language Server Protocol) complet, prenant en charge 14 opérations.

Configurer le serveur LSP

Configurez dans le répertoire .omp/ du projet, ou via l'assistant de configuration d'omp :

Exemples

# ~/.omp/agent/settings.yml (extrait d'exemple)
lsp
:
  servers
:
    typescript
:
      command
: typescript-language-server
      args
: ["--stdio"]
    rust-analyzer
:
      command
: rust-analyzer
    python
:
      command
: pylsp

14 opérations LSP

OpérationDescription
diagnosticsObtenir les erreurs de diagnostic pour un fichier/espace de travail (comme les soulignements rouges de l'IDE)
hoverObtenir les informations de type et les commentaires de documentation pour un symbole
définitionAller à la définition
référencesRechercher toutes les références
renameRenommer le symbole (via workspace/willRenameFiles, en veillant à ce que les réexportations et les fichiers barrel soient mis à jour de manière synchrone)
code_actionObtenir et exécuter des actions de code (par ex., import automatique, corriger les erreurs de lint)
completionObtenir la liste de complétion
signature_helpObtenir l'aide sur la signature de fonction
document_symbolsObtenir tous les symboles d'un fichier
workspace_symbolsRechercher des symboles dans tout l'espace de travail
formatFormater le fichier
range_formatFormater la plage sélectionnée
implementationAller à l'implémentation de l'interface
type_definitionAller à la définition du type

La bonne façon de renommer

Les agents ordinaires renomment en recherchant des chaînes et en les remplaçant une par une, ce qui est susceptible d'oublier ou de mal remplacer. omp le fait via le protocole LSP :

> 把 formatBytes 函数重命名为 humanizeFileSize

# omp 内部执行:
lsp.references("formatBytes")   → 找到 5 处引用,分布在 3 个文件
lsp.rename("formatBytes", "humanizeFileSize")  → 通过 LSP workspace/willRenameFiles
search "formatBytes"            → 0 matches  ✓ 完成

Les réexportations, les fichiers barrel (index.ts) et les imports avec alias sont tous correctement mis à jour, car le renommage passe par le protocole LSP plutôt que par le remplacement de texte.


Intégration du débogueur (DAP)

omp implémente un client DAP (Debug Adapter Protocol) complet, prenant en charge 28 opérations de débogage.

Débogueurs pris en charge

LangageDébogueur
C / C++ / Rustlldb-dap / codelldb
Godlv(Delve)
Pythondebugpy
Node.js / TypeScriptInspecteur intégré de Node.js
GénéralTout débogueur compatible DAP

Scénario typique : localiser un plantage d'un programme C

> 这个 C 程序一直 segfault,帮我找原因

# omp 内部执行:
debug.launch("lldb-dap", "./build/demo")
debug.continue()         # 运行到崩溃
debug.pause()
debug.stackTrace()       # 查看调用栈
debug.scopes(frameId)    # 查看局部变量
debug.evaluate("*ptr")   # 评估表达式

Scénario typique : analyser les interblocages d'un service Go

> Go 服务挂住了,帮我看看

# omp 内部执行:
debug.attach("dlv", pid)
debug.threads()          # 列出所有 goroutine
debug.stackTrace(threadId)  # 查看挂住的 goroutine 调用栈

Fini de parsemer fmt.Println ou console.log dans tout le code—omp pilote directement un vrai débogueur.


Sous-agents : traitement parallèle

Lorsqu'une tâche peut être scindée en sous-tâches mutuellement indépendantes, omp utilise l'outil task pour lancer des sous-agents parallèles, chacun s'exécutant dans un espace de travail isolé et renvoyant un objet résultat typé.

Mécanisme d'isolation des espaces de travail

omp utilise les instantanés du système de fichiers natifs de la plateforme pour isoler les espaces de travail des sous-agents :

Système d'exploitation / système de fichiersMécanisme d'isolation
macOS(APFS)clone APFS (instantané, zéro copy-on-write)
Linux(btrfs/zfs)reflink
Linux(overlayfs)montage overlay
Windowsprojfs / rcopy

Chaque sous-agent obtient une copie d'espace de travail indépendante, sans interférence et sans conflits de fusion.

Exemples d’utilisation

> 我有三个微服务:auth-service、api-service、worker-service。
  请同时检查它们的依赖有没有已知的安全漏洞,分别出报告。

# omp 内部执行:
task(workers=[
  {name: "auth", workdir: "services/auth"},
  {name: "api",  workdir: "services/api"},
  {name: "worker", workdir: "services/worker"}
])

# 三个子 Agent 并行跑,各自输出结构化 JSON:
# { findings: [...], severity: "high", affected: ["lodash@4.17.15"] }

# 父 Agent 合并结果,汇总报告

Communication entre sous-agents (IRC)

Les sous-agents parallèles peuvent communiquer via l'outil irc avec des messages courts pour coordonner le travail :

# 子 Agent A:
irc.send("ComponentsExports", {exports: ["Button", "Input"]})

# 子 Agent B 收到消息后调整自己的分析范围

Récupération des résultats des sous-agents

L'Agent parent peut accéder directement à la sortie structurée d'un sous-agent en utilisant la syntaxe de chemin :

# 读取子 Agent findings 的第一条记录的 path 字段
read agent://<subagent-id>/findings.0.path

Hindsight : mémoire inter-sessions

Hindsight est le système de mémoire au niveau projet d'omp qui permet à l'Agent de conserver une compréhension de la base de code entre les sessions.

Fonctionnement

  • retainLorsque l'Agent découvre des informations précieuses pendant son fonctionnement, il appelle proactivement retain pour écrire dans la banque de mémoire
  • recallRechercher dans la banque de mémoire par mots-clés
  • reflectDemander à Hindsight de synthétiser les informations de la banque de mémoire pour générer une réponse synthétique
  • À la fin de chaque session, omp compresse automatiquement la session en un « modèle mental », chargé lors du premier tour de la session suivante

Portée

Hindsight estau niveau du projet—ce que vous apprenez dans le projet A ne fuite pas dans le projet B. La mémoire est stockée dans le répertoire .omp/ (ou partitionnée par projet dans ~/.omp/).

Effets réels

La première fois que vous utilisez omp dans un projet, vous devez expliquer la structure du projet. Après l'avoir utilisé quelque temps, omp le sait de lui-même :

  • Quelle pile technologique ce projet utilise
  • Répartition des responsabilités des principaux modules
  • Quels refactorings ont été effectués auparavant
  • Quels fichiers sont des "champs de mines" (endroits qui causent souvent des problèmes)

Exécution de code : noyaux doubles Python + JavaScript

La plupart des outils Agent ne fournissent qu'un bac à sable Python. omp exécute deux noyaux persistants, et les deux peuvent rappeler les propres outils de l'Agent.

Noyau Python (eval)

Exemples

# Dans l'outil eval, Python peut appeler tool.* d'omp
import pandas as pd

df = pd.read_csv(tool.read("data/sales.csv"))  # Utilisez l'outil read de l'Agent pour charger des fichiers
print(df.describe())

result = tool.search("revenue", "src/")  # Rechercher dans la base de code

Noyau JavaScript (Bun) (eval)

Exemples

// Dans la même session eval, vous pouvez basculer vers le noyau JS
const data = tool.read("data/sales.csv")  // Peut aussi appeler les outils de l'Agent
const top = data.split('\n').slice(1)
  .map(line => line.split(','))
  .trier((a, b) => +b[2] - +a[2])
  .slice(0, 5)

console.table(top)

Les deux noyaux partagent Prelude

Les deux noyaux partagent un prélude (contexte préchargé). Vous pouvez traiter des données en Python, puis générer des graphiques en JS—tout le processus est une session d'évaluation continue sans quitter l'interface de l'outil.


Règles de flux : correction du comportement en temps réel

Il s'agit du mécanisme unique de correction du comportement en temps réel d'omp, qui résout le problème du « modèle qui n'obéit pas ».

Problèmes des approches traditionnelles

Écrire toutes les règles dans le prompt système coûte la totalité des tokens dans chaque conversation, et le modèle peut malgré tout les ignorer.

Comment fonctionnent les règles de flux

Les règles sontinactivesjusqu'à ce que la condition de déclenchement apparaisse :

  1. Les expressions régulières surveillent la sortie en streaming du modèle
  2. Dès qu'une correspondance est trouvée (au niveau intra-token), interrompez immédiatement le flux actuel
  3. Injecter le contenu de la règle dans le contexte en tant que rappel système
  4. Régénérer à partir de la même position
  5. Les règles injectées survivent à la compression du contexte

Exemples

# Exemple : interdire l'utilisation de Box::leak
# ~/.omp/agent/rules/no-box-leak.yml

name
: box-leak
pattern
: "Box::leak"
reminder
: |
Ne pas utiliser Box::leak dans les chemins de code de production.
Les fuites de mémoire provoqueront un OOM du service sous forte charge.
Utilisez plutôt Arc<str> ou d'autres approches à comptage de références.

Effet : lorsque le modèle écrit Box::leak, le flux est interrompu, la règle est injectée, et le modèle se corrige automatiquement vers Arc, sans intervention de l'utilisateur.

Créez rapidement des règles avec /omfg

omp fournit une commande d’assistance qui vous permet de décrire des règles en langage naturel, et elle génère l’expression régulière et le fichier de règles :

/omfg 不要在任何地方用 any 类型,要求用具体的类型定义或 unknown

omp génère, valide et enregistre la règle ; elle prend effet la prochaine fois.


Routage des modèles : 40+ fournisseurs, quatre rôles

omp utilise des rôles plutôt que des noms de modèles pour répartir le travail, atteignant « le bon modèle pour la bonne tâche ».

Quatre rôles de modèle

RôleObjectifOption CLIVariable d'environnement
defaultConversation générale et génération de codeDefault—
smolExploration de sous-agent à faible coût--smolPI_SMOL_MODEL
slowTâches de raisonnement approfondi--slowPI_SLOW_MODEL
planMode planification--planPI_PLAN_MODEL
# 启动时指定角色覆盖
$ omp --smol    # 整个会话使用 smol 模型(低成本)
$ omp --slow    # 使用慢速推理模型(高质量)
$ omp --plan    # 使用计划专用模型

Changement de modèles dans une session

/model                     # 打开交互式模型选择器
/model claude-sonnet-4.6   # 切换到指定模型
Ctrl+P                     # 循环切换当前角色的可用模型

Fournisseurs personnalisés (~/.omp/agent/models.yml)

Exemples

span style="color: #0053A6;">
providers:
  my-company-llm
:
    type
: openai-completions
    baseUrl
: https://llm.internal.company.com/v1
    apiKey
: "${MY_LLM_KEY}"
    models
:
      - id
: gpt-4o
        name
: GPT-4o interne

Chaînes de basculement

Exemples

# Lorsque Claude atteint une limite de débit 429, basculer automatiquement vers GPT
retry
:
  fallbackChains
:
    default
:
     - anthropic/claude-sonnet-4.6
      - openai/gpt-4o
      - google/gemini-2.0-flash

Liaison de modèle au niveau du chemin

Exemples

# Ce dépôt spécifique force deepseek (coût faible), sans affecter la configuration globale
models
:
  enabledModels
:
    - path
: ~/projects/side-project
      models
: ["deepseek/deepseek-coder"]

Rotation de clés (équilibrage de charge multi-clés)

Exemples

span style="color: #0053A6;">
providers:
  anthropic
:
    apiKeys
:
     - "${ANTHROPIC_KEY_1}"
      - "${ANTHROPIC_KEY_2}"
      - "${ANTHROPIC_KEY_3}"
    # Rotation automatique ; passer à la clé suivante après qu'une seule clé dépasse la limite

Référence rapide des commandes slash courantes

Tapez / dans la zone de saisie du chat pour déclencher l'autocomplétion des commandes.

CommandeFonction
/modelOuvrir le sélecteur de modèle
/loginSe connecter au fournisseur (OAuth)
/resumeReprendre une session historique
/reviewRevue de code pour la branche actuelle / le commit spécifié / les modifications non validées
/commitFractionnement intelligent des commits
/omfgCréer des règles de flux en langage naturel
/debugOuvrir les outils de débogage/rapport/profilage
/hotkeysAfficher tous les raccourcis clavier
/reload-pluginsRecharger les plugins à chaud
/compactCompresser manuellement le contexte (économiser des jetons)
/?Afficher l'aide

/review: Revue de code avec priorités

# 审查当前分支 vs main
/review

# 审查指定 commit
/review abc1234

# 审查未提交的改动
/review --unstaged

omp lance des sous-agents de revue dédiés pour analyser en parallèle. Chaque problème est trié par priorité P0-P3 avec un score de confiance. P0 = bloque la publication, P3 = amélioration facultative.

/commit: Fractionnement atomique des commits

$ omp commit

omp lit l'intégralité de l'arbre de travail (git_overview + git_file_diff + git_hunk), en fractionnant les modifications non liées en commits atomiques indépendants, ordonnés par dépendance :

  • Les commits de code source viennent avant les tests, la documentation et la configuration
  • Les modifications avec dépendances ne sont pas regroupées de manière incorrecte
  • Les dépendances circulaires sont rejetées ; rien n'est écrit
  • Les fichiers de verrouillage tels que package-lock.json et Cargo.lock sont exclus de l'analyse

Plugins et extensions

Les plugins omp sont des modules TypeScript utilisant exactement la même API que les outils intégrés, sans interfaces réservées.

Installer des plugins

$ omp install &lt;plugin-name&gt;          # 从 npm 安装
$ omp install github:user/repo       # 从 GitHub 安装
$ omp install ./path/to/plugin       # 从本地路径安装

Créer des plugins

Vous pouvez simplement demander à omp de l'écrire pour vous :

> 给我创建一个插件,添加 /deploy 命令,
  自动运行测试、构建、然后 SSH 上传到生产服务器

omp génère le code du plugin ; il prend effet immédiatement après votre exécution de /reload-plugins.

Rechargement à chaud

Pas besoin de redémarrer omp après avoir modifié le code du plugin :

/reload-plugins

ACP : Utiliser omp dans l'éditeur Zed

$ omp acp

Connectez omp à l'éditeur Zed via l'Agent Client Protocol. omp lit le tampon que vous êtes en train de modifier, écrit les fichiers via le chemin de sauvegarde de l'éditeur, lance un shell dans le terminal de l'éditeur, et les opérations destructrices déclenchent une boîte de dialogue d'autorisation.


Migration depuis d'autres outils

Un avantage majeur d'omp estla lecture prête à l'emploiLes fichiers de configuration déjà créés par d'autres outils sont lus directement, aucun script de migration nécessaire :

OutilFichier de configurationComment omp le lit
Cursor.cursor/rules/*.mdcHérité automatiquement
Claude Code.claude/settings.json、CLAUDE.mdHérité automatiquement
Cline.clinerulesHérité automatiquement
GitHub Copilot.github/copilot/instructions.md(applyTo)Hérité automatiquement
CodexAGENTS.mdHérité automatiquement
Windsurf.windsurfrulesHérité automatiquement
Gemini CLI.gemini/ configurationHérité automatiquement

Lors du premier lancement, omp analyse le répertoire de travail et charge automatiquement tous les formats détectés.


Ressources et communauté

Autres extensions