Module Creator
Module CLI command reference
Exact commands, accepted options, environment variables, and process exit codes for @fabledgg/module-cli 0.1.x.
Commands
| Command | Purpose |
|---|---|
| fabled module init [directory] | Create a new Dice & Chat scaffold; default directory fabled-dice-chat |
| fabled module validate [directory] | Validate a source project; default current directory |
| fabled module pack [directory] | Validate and create a deterministic ZIP |
| fabled module inspect <archive.zip> | Safely validate and report an existing archive |
| fabled module login | Read a pairing URI/code from a hidden prompt or stdin; save an opaque session valid for 8 hours without renewal |
| fabled module logout | Revoke the live CLI session, then remove its local credential; retain the file for retry if revocation fails |
| fabled module publisher claim [directory] | Claim the publisher namespace in the manifest |
| fabled module publisher status | Show current namespace authority |
| fabled module publish [archive.zip|directory] | Pack if needed and submit a release for review |
| fabled module submissions | List creator-owned submissions |
| fabled module status $SUBMISSION_ID | Show one submission or wait for a decision |
Options
| Option | Applies to / bounds |
|---|---|
| --json | Every command; one machine-readable result |
| --token-stdin | Publisher, publish, submissions, status; token from stdin |
| -h, --help | Root or module command help |
| --publisher-id, --publisher-name, --module-id, --name | init scaffold identity/display fields |
| --output <path> | pack output; default dist/<id>-<version>.zip |
| --channel prerelease|stable | publish; default prerelease |
| --request-id <id> | publisher claim and publish; 1–128 safe identifier characters |
| --status <status> | submissions; case-insensitive PENDING, CHANGES_REQUESTED, REJECTED, APPROVED, WITHDRAWN |
| --package <publisher.module> | submissions package filter |
| --page <number> | submissions; zero-based, default 0 |
| --size <number> | submissions; 1–100, default 25 |
| --wait | status; poll until review reaches a terminal decision |
| --timeout <seconds> | status --wait; 1–1800, default 600 |
| --interval <seconds> | status --wait; 1–30, default 5 |
Environment variables
| Variable | Behavior |
|---|---|
| FABLED_API_URL | Publishing API root; default https://api.fabled.gg; HTTPS except loopback HTTP |
| FABLED_WEB_URL | Browser origin for login; HTTPS or loopback HTTP; set for custom API origins |
| FABLED_CREDENTIALS_PATH | Absolute override for the saved credential file |
| FABLED_ACCESS_TOKEN | Automation access token; overrides saved login |
Exit codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 2 | Command usage error |
| 3 | Module validation error |
| 4 | Filesystem I/O error |
| 5 | Unsafe or malformed archive |
| 6 | Authentication failure |
| 7 | Network failure |
| 8 | Publishing service failure or conflict |
| 10 | Unexpected internal error |