Operations Pulse

一个本地优先、有用且可解释的运维循环编排器。

Operations Pulse 将周期性检查转化为证据，将证据转化为持久的工单， 并将工单转化为可审查的运维记忆。默认情况下，它无需付费服务即可运行： Node.js、SQLite、Git、本地文件和本地日志足以生成一个有用的 Pulse。

这是一个 Openly Useful 项目：有用的东西， 公开地打造出来。

请使用实时、凭据安全的设置指南： https://operations-pulse-five.vercel.app。

v0.1 将发布的内容

• 一个 SQLite 工单与 Pulse 分类账本。

• 针对仓库状态、文档和已配置日志的只读检查。

• 一个基于 MCP 的服务器，带有自描述的工具和结构化输出。

• 一个可移植的 operations-pulse 技能，适用于 Codex 及兼容代理。

• 可选的运维、信号审查、分诊和集成角色定义。

• 连接目录与引导式设置，能够区分免费/本地、订阅、宿主的 OAuth、自托管 和自带凭据等不同路径。

• 一份完整的迁移分类账：已导入、已重写、已引用或已排除。

Related MCP server: Project Telos

免费优选的快速入门

要求：Node.js 24 或更新版本。默认工作流无需 API 密钥。

npm install
npm run build
node packages/core/dist/cli.js init
node packages/core/dist/cli.js pulse run --root .
node packages/core/dist/cli.js tickets list

配置可选的只读适配器，无需在仓库、SQLite 数据库、MCP 参数或聊天记录中 放置任何凭据：

export OPERATIONS_PULSE_GITHUB_TOKEN='stored by your shell or secret manager'
node packages/core/dist/cli.js connections configure \
  --id github --mode env-token \
  --credential-env OPERATIONS_PULSE_GITHUB_TOKEN
node packages/core/dist/cli.js connections test --id github
node packages/core/dist/cli.js pulse run --root . --connections github

在已通过 GitHub CLI 认证的本地机器上，零拷贝的替代方案只会使用该会话， 仅用于只读检查；其令牌永远不会被存储或打印：

gh auth login
node packages/core/dist/cli.js connections configure --id github --mode github-cli
node packages/core/dist/cli.js connections test --id github

位于 apps/site 的基于浏览器的选择器可生成这些安全的设置步骤。它从不 收集凭据。宿主的 OAuth 保持在其自己的用户同意界面中。

通过 stdio 运行 MCP 服务器：

npm run mcp

数据库默认位置为 .operations-pulse/pulse.sqlite。可通过 OPERATIONS_PULSE_DB 覆盖。

安全模型

除非某个工具或命令明确指出会写入，否则 Operations Pulse 向外部检测都不写入。 Pulse 运行不会创建工单，除非显式启用 --create-tickets（或相应的 MCP 参数）。 连接在未配置前处于禁用状态，凭据从不存储在目录中，对外可见或付费操作 必须经过单独的人工审批边界。

连接记录仅保留 ID、非机密设置、端点和环境变量引用。connections disconnect 会在本地分类账中移除该引用。初始适配器均为只读：IMAP 未读数量信息、GitHub 身份、Linear 查看者身份、Sentry 项目访问和 PostHog 项目访问。v0.1 中不 提供任何远程变更适配器。

可选的心跳

可在任何运行 Node 的环境中运行一个限定范围的前台心跳：

node packages/core/dist/cli.js heartbeat serve --interval-minutes 30 --root .

在 macOS 上，先检查，再提前安装用户级 LaunchAgent：

node packages/core/dist/cli.js schedule plan --interval-minutes 30 --root .
node packages/core/dist/cli.js schedule install --confirm-install --interval-minutes 30 --root .

调度器永远不会由 MCP 工具、模型回复或页面加载来安装。移除需执行 schedule uninstall --confirm-uninstall。

仓库结构

• packages/core — SQLite 分类账与确定性检查。

• packages/mcp — MCP stdio 服务器。

• skill/operations-pulse — 可移植的代理技能。

• plugins/openai/operations-pulse — 生成的 Codex 技能和 MCP 包装器。

• plugins/claude/operations-pulse — 生成的 Claude Code 技能和 MCP 包装器。

• .MCP/plugins/marketplace.json — 仓库本地的 Codex 市场。

• .MCP/plugins/marketplace.json — 仓库本地的 Claude 市场。

• mcp-registry/operations-pulse/server.json — 分阶段发布的官方 MCP Registry 元数据。

• mcp-registry/publisher/publisher.json — 公共发布者实体的仓库消费镜像。

• mcp-registry/publishers（位于 publisher/publisher.json）— 仓库本地镜像了公共发布者 权威。提供者清单从该记录中派生公开名称、联系信息、命名空间和政策 URL。

• agents — 可选的角色定义。

• catalog — 启动时显示的工具与连接说明。

• docs — 架构、工作流程方式、连接指南和发布检查列表。

• migrations — 应用迁移定义。

• vendor — 已归属的第三方技能包，绝不静默合并。

• apps/site — 无依赖的项目站点。

状态

此仓库正在为首次公开发布做准备。受支持的基线是本地优先的核心。 IMAP、GitHub、Linear、Sentry 和 PostHog 均已具备只读适配器测试；宿主 OAuth 需要 兼容宿主的本地同意流程，且默认不启用任何远程写入适配器。

发布者与注册模型

Openly Useful 是发布者和开发者品牌。openlyuseful.org 是开源、发布者、策略、安全 和支持部分；openlyuseful.com 是 Studio/商业部分。Openly Useful LLC 是计划中的 法律实体，尚未积极构建或运营。目前，Openly Useful 由创始人直接运营，创办人所有者 已授权外部源代码和注册表发布。

位于 publisher/publisher.json 的仓库消费镜像了公开的发布者权威端点 https://openlyuseful.org/publisher/manifest.json。提供者清单从该记录中提取 公开名称、联系信息、命名空间和策略 URL。阶段性提供商元数据中的仓库 URL 是 计划中的公开源代码，位于 https://github.com/Openly-Useful/operations-pulse。

标准技能仍然是 skill/operations-pulse。提供系统包装器副本是生成的产物，并不是 独立编辑的源：

npm run registration:sync
npm run registration:check

这些包装器注册了可移植技能以及不可变 stdio 命令 npx --yes @openly-useful/operations-pulse-mcp@0.1.0。它们不会认证账户、 不会安装调度程序、不会配置适配器或收集凭据。对应的 MCP Registry 标识为 org.openlyuseful/operations-pulse。安装或升级插件后，启动新的 Codex 任务或重启 Claude Code，以便宿主刷新其 MCP 工具。默认情况下，MCP 数据库位于宿主进程工作目录 下的 .operations-pulse/pulse.sqlite；在宿主环境中设置 OPERATIONS_PULSE_DB 以指定路径。

允许本地生成和验证。公开仓库创建、包发布、MCP Registry 提交、市场提交、成功安装、 认证和部署属于外部执行操作。两个可发布的工作区在 prepublishOnly 之前始终处于 失败关闭状态，除非发布者身份、命名空间来源、政策来源、重定向仓库和发布者 授权与公共权威完全匹配。LLC 组建待定的本身并不阻塞 npm 制品，因为 Openly Useful 是由创始者运营的，且在主体成立过程中，根据明确的授权而有效。命名空间验证、 提供者授权认证和提供者验证，仍然随相关注册中心或提供者的流程而分别要求。