OfflineCreator CLI task directory
Route users by models, balance, generation, status, download, cancel, and top-up tasks.
The published package is a thin command-line layer over OfflineCreator Studio. Run it with `npx @offlinecreator/mcp`, and provide `OFFLINECREATOR_API_KEY` through the environment for a CLI subcommand. The current registry package requires Node.js 20 or newer.
Use this directory to separate the commands that the published CLI actually parses from similarly named MCP tools. The CLI covers model discovery, balance checks, top-up discovery and checkout-link creation, and generation. Status, download, cancellation, upload, and generation-history actions appear in the MCP tool surface, but they are not standalone CLI subcommands in the current published parser.
Current published CLI command map
The `0.1.1` package parser recognizes the command families below. Successful read commands serialize their API response as formatted JSON, which makes them suitable for inspection or downstream parsing. Treat the output schema as current-package behavior rather than a promise that every field is permanently stable.
- `models`
- List the launch model catalog and its current API data.Use this before generation so the model identifier comes from the service response.
- `balance` or `credits`
- Read the current credit response.Both names call the same credit client method in the published parser.
- `topups`
- List available top-up choices.This is discovery only; it does not itself create a checkout.
- `topup --id …`
- Create a checkout response for an accepted top-up ID.The published parser accepts `topup-1000` or `topup-3000`; completion remains a human browser action.
- `generate`
- Start a generation with a model and prompt.Add `--wait` only when the job does not require a separate upload step.
- `help`, `--help`, or `-h`
- Print the package's own command summary.Use this as the final authority for the version actually installed.
Generation command decision path
Start with `npx @offlinecreator/mcp models`, select a returned model ID, and then run `npx @offlinecreator/mcp generate --model <id> --prompt "<text>"`. The parser rejects generation when either the model or prompt is missing.
The optional ratio flag may be written as `--aspect` or `--aspectRatio`; the parser forwards only `16:9`, `9:16`, or `1:1`. With `--wait`, the client polls after submission unless the response says an upload is required.
Route unsupported CLI tasks to the right surface
Do not guess a standalone command for job status, waiting, downloads, cancellation, uploads, or recent generations. Those actions are documented as MCP tools, while the current published CLI switch does not expose matching subcommands. Continue through the focused task pages below, and verify the access surface before scripting.
Freshness and failure boundaries
Run `npx @offlinecreator/mcp --help` before copying an automation example. On August 8, 2026, the npm registry exposed `0.1.1` while the public repository README declared `0.1.2`, so repository and installed-package documentation were not yet on the same visible release.
An unknown command prints help and returns exit code 1. The same nonzero result is used when `generate` lacks a model or prompt, or when `topup` receives an unsupported ID.
CLI and MCP requests use the cloud Studio service rather than local generation. The official product page says those access surfaces share the Studio credit balance and published per-model costs. This page owns command routing only; install, authentication, and individual task pages own their narrower procedures.
The complete evidence refresh retained 54 item-level records: 16 Digg clusters, one general-web result, 14 Reddit threads, 13 TikTok videos, and 10 YouTube videos. Review classified nine as marginal, 27 as irrelevant, 10 as promotional, three as unsafe, and five as unverifiable. No record directly documented or tested OfflineCreator's published command parser, accepted flags, output shape, authentication, or exit behavior, so no community source, claim, or citation was added.
Coverage remains degraded rather than silent. Reddit returned 14 records before HTTP 429, Instagram failed with HTTP 404, the jobs lane was unreachable, and the arXiv command timed out. X was unavailable because optional credentials were not configured. All 10 YouTube records lacked a publication date in the raw export and reported zero captured views, likes, and comments, so their generic CLI and local-AI tutorials were not treated as current product evidence.
The successful lanes mainly surfaced other products, broad terminal advice, promotional local-AI tutorials, and unrelated generated-media posts. Three records promoted bypassing safeguards or supplied risky security guidance, while five lacked enough verifiable context for their claims. The published package tarball, public parser, README, registry metadata, and first-party product page remain the stronger evidence for this command directory; no authenticated runtime acceptance test was performed.