omni-dev 是一个以 Git 提交消息智能化为核心的开发者工具，使用 Rust 编写并以单一二进制文件分发。
一、用途与定位 根据资料，omni-dev 主要面向两类场景：AI 提交消息工具链，以及 Atlassian / 开发工作流相关的 MCP 服务器。它借助 Claude AI 分析代码变更，给出有意义的提交消息与 PR 描述建议，并理解项目结构、约定与工作模式。
二、主要能力
- AI 提交改进（twiddle）：分析代码变更并改写提交消息，支持单条或多条提交的安全修订，自动检测并格式化 Conventional Commits，对较大提交范围进行自动分批处理。具备安全机制，包括工作目录校验、防止修改已存在于远程主分支的提交，以及错误恢复。
- PR 创建：基于 AI 生成描述，创建专业 Pull Request。
- 分析命令：资料提及提供对提交、分支与文件变更的深入分析能力。
- Atlassian 集成：可从命令行读取、写入与管理 JIRA 问题与 Confluence 页面；支持自带实例的 PAT 认证（atlassian auth login --auth-mode bearer，无需邮箱），多数服务操作仍面向 Cloud API。其 Markdown/ADF 转换经过 schema 校验，遇到内容模型违规时会报错而非静默丢弃节点。
- Datadog 集成（只读）：查询指标、监控项、仪表盘、日志、事件、SLO、主机与停机时间。DATADOG_SITE 默认为 datadoghq.com，也识别 datadoghq.eu、us3.datadoghq.com、us5.datadoghq.com、ap1.datadoghq.com、ddog-gov.com；可用环境变量 DATADOG_API_KEY、DATADOG_APP_KEY、DATADOG_SITE 覆盖本地设置，自建或代理部署可用 DATADOG_API_URL 覆盖。所有 Datadog 子命令也以 MCP 工具（datadog_*）形式暴露。
- 浏览器桥接：通过已认证的浏览器标签页发起 HTTP 请求，用于访问 Grafana、Loki 等受 SSO 保护的内网面板，不导出 cookie 或令牌；支持二进制与流式响应体、多标签路由、按请求的凭据与来源覆盖，以及面向纯 HTTP 工具的透明代理。
- 受监管守护进程：以单一受监管进程承载长期服务，通过每用户私有 Unix 域控制套接字管理；浏览器桥接是首个迁移到该守护进程的服务，Snowflake 与 worktrees 注册表随后加入。macOS 上可选菜单栏应用。daemon start 会安装 launchd LaunchAgent 以实现登录自启。守护进程仅支持 Unix 系统。
- Snowflake SQL 服务：一次外部浏览器 SSO 认证后，可在任意账户并发执行任意 SQL，无需每次查询都弹出 SSO；守护进程在内存中持有会话并复用有界连接池，每次查询仍可设置自己的 warehouse/role/database/schema。账户/用户/上下文默认来自 SNOWFLAKE_* 环境变量，其次为 ~/.omni-dev/settings.json。
- 本地请求日志：每次调用及其 HTTP 请求都记录到本地只追加日志，可搜索与跟踪；默认开启、尽力而为，不写入任何机密（认证头脱敏，请求体需显式开启）。可用 OMNI_DEV_LOG_DISABLE=1 关闭，或 OMNI_DEV_LOG_BODIES=1 / OMNI_DEV_LOG_HEADERS=1 选择捕获请求体/头。
- Worktrees 视图：在一个实时视图中查看所有 VS Code 窗口中打开的仓库与 git worktree；因扩展宿主按窗口沙箱化，需配套的小型一方扩展向守护进程注册各窗口，再聚合为单一注册表。该注册表仅存于内存，未注销即崩溃的窗口会自动超龄淘汰。
- Agent 会话跟踪：跟踪遍布终端与 VS Code 窗口的 Claude Code、Codex 与 pi.dev 会话，显示粗略的实时状态（工作中、空闲、等待用户输入）。通过可选钩子、claude-wrap / codex-wrap 包装器、pi.dev 扩展与转录监视器向守护进程喂送数据。
- Jev 判断：omni-dev ai jev 是 TypeSafe AI 的 Jev API 客户端，返回带类型的概率判断而非生成文本；除 choice / score / noul / ask 原语外，可路由判断每个 GitHub issue 需要哪个模型层级来设计、实现与评审，并通过 verify-decision 核对决策评论中的每条主张与其引用来源。
- Claude Code 斜杠命令：可向项目的 .claude/commands/ 目录生成即用型斜杠命令模板，每个模板是自包含工作流，在 Claude Code 会话中驱动多步 omni-dev 操作，如 /commit-twiddle、/pr-create、/pr-update。
- Claude 对话历史导出：将 Claude Code 聊天历史导出为 .jsonl 文件目录，重复运行是幂等同步。导出内容被定位为行为转录而非忠实归档，顶层会话 jsonl 捕获全部提示、响应、思考块、工具调用与工具结果元数据；子代理内部轮次、大型工具输出附属文件、PDF 页面栅格与 Claude 自动记忆被有意排除。--output-format markdown 会额外生成带 YAML frontmatter 的 .md 文件。
- 转录获取：从外部媒体平台拉取字幕与转录文本，YouTube 是首个支持来源，CLI 命名空间与库设计允许后续加入 Vimeo、播客 RSS、通用 VTT/SRT URL 等来源。--format 接受 srt、vtt、txt 或 json。
- Shell 补全：omni-dev completions <shell> 可输出 bash、zsh、fish、powershell、elvish 的补全脚本。
三、使用方式 项目提供预编译二进制文件并附于每个 release 中。Linux 版（omni-dev-linux.tar.gz、omni-dev-linux-arm64.tar.gz）为动态链接，需要 glibc 2.35 或更新版本（Ubuntu 22.04 与 Debian 12 满足）；在较旧主机如 RHEL 9 或 Amazon Linux 2023（glibc 2.34）上会因 GLIBC_2.xx not found 在加载器阶段失败，此时可用 cargo install omni-dev 从源码构建。资料提供了名为 Getting Started 的约 10 分钟入门走查，涵盖从认证到首次 AI 改进提交；仅需 API 密钥参考可查看 Authentication 文档。
四、适用场景 适合需要把零散提交整理为规范历史的个人或团队开发者，也适合在受 SSO 保护的内网面板、Snowflake 数据仓库、Jira/Confluence 与 Datadog 之间进行命令行与 MCP 集成的开发与运维工作流。
五、限制与说明 部分服务（守护进程、Snowflake 服务、worktrees 注册表、Agent 会话）仅支持 Unix 系统，因为其控制面基于 Unix 域套接字。Gmail 与 Drive 命令树（含 Docs、Sheets、Slides）、其 23 个 MCP 工具及 omni_dev::{gmail,drive} 库模块已迁移至独立项目 gwi；在一个版本内 omni-dev gmail ... 与 omni-dev drive ... 仍作为隐藏存根保留，接受任意参数并以非零状态退出，提示指向 gwi，下一小版本将删除。Jev 行情的实测状态、各竞品对比表的最后验证时间（2026-06-23）等细节属于资料记载。文档中未提供的内容本文未作补充。
