{"_id":"@agnes-ai/agnes-cli","_rev":"4-90989fe20b43772fe39315bf33d0652c","name":"@agnes-ai/agnes-cli","dist-tags":{"latest":"0.0.4"},"versions":{"0.0.1":{"name":"@agnes-ai/agnes-cli","version":"0.0.1","license":"MIT","_id":"@agnes-ai/agnes-cli@0.0.1","maintainers":[{"name":"constantine1916","email":"constantine1916z98@gmail.com"}],"homepage":"https://github.com/Constantine1916/agnes-cli#readme","bugs":{"url":"https://github.com/Constantine1916/agnes-cli/issues"},"bin":{"agnes":"scripts/agnes.js","agnes-cli":"scripts/agnes.js"},"dist":{"shasum":"adb5ecf3875c56c1740cd645673423bbeb2ca7cb","tarball":"https://registry.npmjs.org/@agnes-ai/agnes-cli/-/agnes-cli-0.0.1.tgz","fileCount":10,"integrity":"sha512-7GIj49+VKtMu5G7S6R1RIItB6uiVyKndcVZMiz9D93M1QUqTAOMH9K5QOszBQPQ4O/bfpa2PNyHoYWrkr42NRg==","signatures":[{"sig":"MEYCIQDjcDLzVpQL+3x7wpwwlw4rys/SDAlFA/49E+8zRKX/WAIhAIRAqP/OhiNr4L5FJ8rNygVAkKtniy+pnOwNr747FUbD","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15080836},"agnes":{"projectName":"agnes","bundledAssetsDir":"npm-bundles","releaseBaseUrlTemplate":"https://github.com/Constantine1916/agnes-cli/releases/download/v{version}"},"engines":{"node":">=18"},"gitHead":"1adafcbd97530b41b79fdd820f0933b0df7e1a23","scripts":{"test":"go test ./...","build":"go build -o bin/agnes .","postinstall":"node ./scripts/postinstall.js","prepare:npm-bundles":"scripts/prepare-npm-bundles.sh"},"_npmUser":{"name":"constantine1916","email":"constantine1916z98@gmail.com"},"repository":{"url":"git+https://github.com/Constantine1916/agnes-cli.git","type":"git"},"_npmVersion":"10.9.3","description":"Agent-friendly CLI for Agnes image and video generation.","directories":{},"_nodeVersion":"22.18.0","dependencies":{"tar":"^7.4.3","adm-zip":"^0.5.16"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agnes-cli_0.0.1_1781200519699_0.7426028580488613","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@agnes-ai/agnes-cli","version":"0.0.2","license":"MIT","_id":"@agnes-ai/agnes-cli@0.0.2","maintainers":[{"name":"constantine1916","email":"constantine1916z98@gmail.com"}],"homepage":"https://github.com/Constantine1916/agnes-cli#readme","bugs":{"url":"https://github.com/Constantine1916/agnes-cli/issues"},"bin":{"agnes":"scripts/agnes.js","agnes-cli":"scripts/agnes.js"},"dist":{"shasum":"033465b39e6969a96e4d6c25d5e700912ed45060","tarball":"https://registry.npmjs.org/@agnes-ai/agnes-cli/-/agnes-cli-0.0.2.tgz","fileCount":10,"integrity":"sha512-s2MwdVVMeUU1BmcH+RC8hmDt952vPt8zTunBkfdkP+hVIXWRbjbzPwHJon2V52oVrU2OvwFAWxhLMjMUCGwsJg==","signatures":[{"sig":"MEUCIQDod8ON/NC7YX0u2T7nukfAXpmNgUfXIxCvHMfRpTUozAIgSGW94RYIW0SizBhN+LGzZ/ZPQLQAF6NmAPS56fcU3U8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agnes-ai%2fagnes-cli@0.0.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":15082870},"agnes":{"projectName":"agnes","bundledAssetsDir":"npm-bundles","releaseBaseUrlTemplate":"https://github.com/Constantine1916/agnes-cli/releases/download/v{version}"},"engines":{"node":">=18"},"gitHead":"79bafa01932d13d44172555af53df3f8f8b306cb","scripts":{"test":"go test ./...","build":"go build -o bin/agnes .","postinstall":"node ./scripts/postinstall.js","prepare:npm-bundles":"scripts/prepare-npm-bundles.sh"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:27b649bc-bcc8-4bf0-9562-920ed441bdad"}},"repository":{"url":"git+https://github.com/Constantine1916/agnes-cli.git","type":"git"},"_npmVersion":"11.16.0","description":"Agent-friendly CLI for Agnes image and video generation.","directories":{},"_nodeVersion":"24.16.0","dependencies":{"tar":"^7.4.3","adm-zip":"^0.5.16"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agnes-cli_0.0.2_1781200911776_0.19149133530850593","host":"s3://npm-registry-packages-npm-production"}},"0.0.3":{"name":"@agnes-ai/agnes-cli","version":"0.0.3","license":"MIT","_id":"@agnes-ai/agnes-cli@0.0.3","maintainers":[{"name":"constantine1916","email":"constantine1916z98@gmail.com"}],"homepage":"https://github.com/Constantine1916/agnes-cli#readme","bugs":{"url":"https://github.com/Constantine1916/agnes-cli/issues"},"bin":{"agnes":"scripts/agnes.js","agnes-cli":"scripts/agnes.js"},"dist":{"shasum":"2a6d764d4432cd6fa4d18f92565a0418ad50cf3c","tarball":"https://registry.npmjs.org/@agnes-ai/agnes-cli/-/agnes-cli-0.0.3.tgz","fileCount":11,"integrity":"sha512-zlUgEDp1V4FRoe0hbG5FqzWJoLhjy5qzrWuW8VnVrMuvqOdDWgtvipsRqN3uFNXi6aG8H3Pfbgap5pMJgp4Asw==","signatures":[{"sig":"MEUCIHqTXwfzHS4AFon5r1+jKgrepu8ZamniyBsSG4m93CbpAiEA/RJKGRlt23ZGFbWc0e4i7qA7la81JggZUmjlr9N8LS8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agnes-ai%2fagnes-cli@0.0.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":15094219},"agnes":{"projectName":"agnes","bundledAssetsDir":"npm-bundles","releaseBaseUrlTemplate":"https://github.com/Constantine1916/agnes-cli/releases/download/v{version}"},"engines":{"node":">=18"},"gitHead":"ba60dbbcb8bd372c10d67cb5f8d74be60c2018f2","scripts":{"test":"go test ./...","build":"go build -o bin/agnes .","postinstall":"node ./scripts/postinstall.js","prepare:npm-bundles":"scripts/prepare-npm-bundles.sh"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:27b649bc-bcc8-4bf0-9562-920ed441bdad"}},"repository":{"url":"git+https://github.com/Constantine1916/agnes-cli.git","type":"git"},"_npmVersion":"11.16.0","description":"Agent-friendly CLI for Agnes image and video generation.","directories":{},"_nodeVersion":"24.16.0","dependencies":{"tar":"^7.4.3","adm-zip":"^0.5.16"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agnes-cli_0.0.3_1781201581032_0.4462861606704338","host":"s3://npm-registry-packages-npm-production"}},"0.0.4":{"name":"@agnes-ai/agnes-cli","version":"0.0.4","description":"Agent-friendly CLI for Agnes image and video generation.","license":"MIT","publishConfig":{"access":"public"},"bin":{"agnes":"scripts/agnes.js","agnes-cli":"scripts/agnes.js"},"scripts":{"build":"go build -o bin/agnes .","test":"go test ./...","prepare:npm-bundles":"scripts/prepare-npm-bundles.sh","postinstall":"node ./scripts/postinstall.js"},"engines":{"node":">=18"},"dependencies":{"adm-zip":"^0.5.16","tar":"^7.4.3"},"repository":{"type":"git","url":"git+https://github.com/Constantine1916/agnes-cli.git"},"homepage":"https://github.com/Constantine1916/agnes-cli#readme","bugs":{"url":"https://github.com/Constantine1916/agnes-cli/issues"},"agnes":{"bundledAssetsDir":"npm-bundles","projectName":"agnes","releaseBaseUrlTemplate":"https://github.com/Constantine1916/agnes-cli/releases/download/v{version}"},"gitHead":"7c49ec03caa16267f7df7c8fb05d12de45eee902","_id":"@agnes-ai/agnes-cli@0.0.4","_nodeVersion":"24.16.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-Qg/NvBVFv2ubAHCFE9Hj1MelpPbJZx4BZ8ouDKOeYN87YFFn9mctyuhH0eOXRAnp6inEcBFmRlbp7+wF+dGduw==","shasum":"010462258c3508059353d9a9e27fc8f5833c14f0","tarball":"https://registry.npmjs.org/@agnes-ai/agnes-cli/-/agnes-cli-0.0.4.tgz","fileCount":11,"unpackedSize":15104328,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agnes-ai%2fagnes-cli@0.0.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHIIcPczY0PnrucHqlSm3YUTQwhrp4DPeEbI2YdHk4RmAiAtRsugTblwNQibXqcr3/bRESZ/YbRi6fQOzGQeh+MGsA=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:27b649bc-bcc8-4bf0-9562-920ed441bdad"}},"directories":{},"maintainers":[{"name":"constantine1916","email":"constantine1916z98@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agnes-cli_0.0.4_1781235014923_0.12364914385839842"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-11T17:55:19.520Z","modified":"2026-06-12T03:30:15.567Z","0.0.1":"2026-06-11T17:55:20.055Z","0.0.2":"2026-06-11T18:01:52.320Z","0.0.3":"2026-06-11T18:13:01.412Z","0.0.4":"2026-06-12T03:30:15.279Z"},"bugs":{"url":"https://github.com/Constantine1916/agnes-cli/issues"},"license":"MIT","homepage":"https://github.com/Constantine1916/agnes-cli#readme","repository":{"type":"git","url":"git+https://github.com/Constantine1916/agnes-cli.git"},"description":"Agent-friendly CLI for Agnes image and video generation.","maintainers":[{"name":"constantine1916","email":"constantine1916z98@gmail.com"}],"readme":"# agnes-cli\n\n**中文** | [English](https://github.com/Constantine1916/agnes-cli/blob/main/README.en.md)\n\n面向 Agent 的 Agnes 多模态 CLI，用于通过 API Key 调用 Agnes 的图片生成和视频生成能力。\n\n这个 CLI 的设计目标是让人类和 AI Agent 都容易调用：命令稳定、无需登录、支持环境变量/API Key 注入，成功结果只输出 URL 到 stdout，进度和诊断信息输出到 stderr。\n\n## 安装\n\n```bash\nnpm install -g @agnes-ai/agnes-cli\nagnes --version\nagnes doctor --offline\n```\n\n也可以从源码构建：\n\n```bash\ngo build -o bin/agnes .\n./bin/agnes doctor --offline\n```\n\n## 配置 API Key\n\nAgnes CLI 不需要登录。API Key 的优先级如下：\n\n1. `--api-key`\n2. `AGNES_API_KEY`\n3. `agnes key set` 保存的 key\n\n保存 API Key：\n\n```bash\nagnes key set \"$AGNES_API_KEY\"\nagnes key status\n```\n\n还没有 API Key 时，可以打开 Agnes 平台申请：\n\n```bash\nagnes key register\n```\n\n临时注入 API Key：\n\n```bash\nAGNES_API_KEY=\"你的_API_KEY\" agnes image generate \\\n  --prompt \"A clean product photo of a glass cube\" \\\n  --size 1024x768\n```\n\n清除本地保存的 key：\n\n```bash\nagnes key clear\n```\n\n## 生成图片\n\n```bash\nagnes image generate \\\n  --prompt \"A clean product photo of a glass cube\" \\\n  --size 1024x768\n```\n\n使用图片输入：\n\n```bash\nagnes image generate \\\n  --prompt \"Make it cinematic\" \\\n  --image ./input.png \\\n  --model agnes-image-2.1-flash\n```\n\n支持的图片模型：\n\n- `agnes-image-2.1-flash`，默认值\n- `agnes-image-2.0-flash`\n\n本地图片路径会在请求前自动转成 Data URI。\n\n## 生成视频\n\n```bash\nagnes video generate \\\n  --prompt \"A cat walking on the beach at sunset\" \\\n  --num-frames 121 \\\n  --frame-rate 24\n```\n\n关键帧模式：\n\n```bash\nagnes video generate \\\n  --prompt \"Smooth transition between keyframes\" \\\n  --image ./start.png \\\n  --image ./end.png \\\n  --mode keyframes\n```\n\n查询任务状态：\n\n```bash\nagnes video status <video_id_or_task_id>\n```\n\n## Agent 友好输出约定\n\n生成类命令成功时，stdout 只输出最终结果 URL，方便 Agent 直接解析：\n\n```text\nhttps://example.com/result.png\n```\n\n进度、任务 ID、诊断信息会输出到 stderr。错误会以稳定 JSON envelope 输出到 stderr，包含 `type`、`subtype`、`message` 和 `hint` 字段。\n\n## Dry Run\n\n使用 `--dry-run` 查看请求 payload，不会发起网络请求：\n\n```bash\nagnes --dry-run image generate \\\n  --prompt \"A futuristic city\" \\\n  --size 1024x768\n```\n\n## Schema\n\n给 Agent 读取命令 schema：\n\n```bash\nagnes schema image.generate\nagnes schema video.generate\n```\n\n## 常用命令\n\n```bash\nagnes key set <api-key>\nagnes key status\nagnes key clear\nagnes key register\n\nagnes image generate --prompt \"...\" --size 1024x768\nagnes video generate --prompt \"...\" --num-frames 121 --frame-rate 24\nagnes video status <video_id_or_task_id>\nagnes doctor\n```\n\n## npm 包内容\n\n发布到 npm 的包名是 `@agnes-ai/agnes-cli`。npm 包只包含 README、最小安装脚本和 `npm-bundles/` 下的预编译二进制压缩包；Go 源码只开源在 GitHub 仓库中。\n\n## 发布\n\n发版由 Git tag 触发。推送 `v0.1.0` 这样的 tag 后，GitHub Actions 会：\n\n1. 校验版本和测试\n2. 用 GoReleaser 构建 macOS、Linux、Windows 二进制\n3. 上传 GitHub Release 资产和 `SHA256SUMS`\n4. 将 release 资产打入 npm 包\n5. 通过 npm Trusted Publishing 发布到 npm\n\n```bash\nnpm version patch --no-git-tag-version\ngit add package.json package-lock.json internal/buildinfo/buildinfo.go\ngit commit -m \"Release v0.1.1\"\ngit tag v0.1.1\ngit push origin main --tags\n```\n","readmeFilename":"README.md"}