oxygen-workflows

Beta — 面向 workflow 自动化实例的终端客户端。管理 workflow、execution、credential 等。

轻量、仅依赖 @oclif/core，通过浏览器 SSO 登录后调用实例 REST API（/rest），面向人类、脚本与 AI Agent。

安装

# 零安装直接运行
npx oxygen-workflows workflow list

# 或全局安装
npm install -g oxygen-workflows
pnpm add -g oxygen-workflows

登录

首次调用 API 前，通过浏览器 SSO 登录一次：

oxygen-workflows login

登录凭证保存在 ~/.oxygen-workflows/config.json（权限 0600）。若存在旧版 ~/.workflow-cli/config.json，会自动回退读取。

实例地址默认为 https://oxygenflow.jd.com，无需配置。仅在连接其他环境时，可通过 WORKFLOW_URL 环境变量覆盖。

常用命令

| Topic | 说明 | |-------|------| | workflow | 创建、更新、激活 workflow | | execution | 查看、重试、停止执行 | | credential | 管理凭证 | | project | 查询项目/空间 |

完整列表：oxygen-workflows --help

Agent 集成

SKILL 位于 skills/oxygen-workflows/SKILL.md。

也可通过 oxygen-cli 安装与管理：

oxygen-cli install oxygen-workflows
oxygen-cli skill show oxygen-workflows

开发

pnpm install
pnpm verify    # typecheck + lint + test + build

说明

本包通过 SSO Cookie 调用 workflow 自动化平台 REST API（/rest）。