Skip to content

docs(generate): default to built-in generation (CLI 0.10.0), OpenRouter as Path B — plugin 1.10.0 - #18

Merged
facundofarias merged 1 commit into
mainfrom
feat/generate-native
Oct 30, 2026
Merged

facundofarias merged 1 commit into
mainfrom
feat/generate-native

Conversation

@facundofarias

Copy link
Copy Markdown
Member

Summary

pixelvault-generate used to need OPENROUTER_API_KEY + curl/jq/base64 + the CLI. PixelVault now generates natively (POST /v1/images/generate, live since 2026-10-30), so the default path is one command: pixelvault generate "<prompt>", which needs only the PixelVault key. OpenRouter stays as Path B, unchanged, for provider models (Gemini / Nano Banana, etc.) and text-in-image work.

  • "Pick a path" comparison table, Path A steps + preflight (CLI >= 0.10.0), models/credits table, and an error table for the generation codes (402 credits / paid-plan model, 403, 422, 429, 5xx refunded).
  • Plain about what the open Cloudflare models are good at, and that each has its own license (no commercial-use claim).
  • README row updated; plugin 1.10.0.

DO NOT MERGE YET

This documents pixelvault generate, which ships in pixelvault-cli 0.10.0 (pixelvault-dev/cli#23, merged but not yet published to npm). Per the repo's rule, a skill doc must not go live before the CLI release it mentions (merging = live for agents immediately). Marked draft until npm view pixelvault-cli version reports 0.10.0.

After merging

In the monorepo, re-pin apps/web/public/.well-known/agent-skills/index.json to the new skill commit (digests + the generate entry's description), and regenerate the Hermes catalog (node scripts/gen-well-known-skills.mjs), per CLAUDE.md.

🤖 Generated with Claude Code

https://claude.ai/code/session_019sMZVurbKqZ6zsbUYCsLJn

….0), keep OpenRouter as Path B, plugin 1.10.0

pixelvault-generate previously needed OPENROUTER_API_KEY plus curl/jq/base64 and
the CLI. PixelVault now generates natively (POST /v1/images/generate), so the
default path is one command: `pixelvault generate "<prompt>"`, which needs only
the PixelVault key. OpenRouter stays as Path B for provider models (Gemini /
Nano Banana, etc.) and for text-in-image work.

- Adds a "Pick a path" comparison, the Path A steps and preflight (CLI >= 0.10.0),
  the models/credits table, and an error table for the generation codes.
- States plainly what the open Cloudflare models are good at and that each model
  has its own license; no commercial-use claim.
- Path B is unchanged.

Do not merge before pixelvault-cli 0.10.0 is on npm: this documents
`pixelvault generate`.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019sMZVurbKqZ6zsbUYCsLJn
@facundofarias
facundofarias marked this pull request as ready for review October 30, 2026 22:03
@facundofarias
facundofarias merged commit ede38c5 into main Oct 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant