makefx.app
CLI

Command line

Sign in, inspect a space and work with assets from a terminal.

The repository ships a makefx CLI that calls the same hosted MCP tools as an MCP client. It is useful for local files, shell scripts and JSON output. The package is not published to npm; run it from this repository.

pnpm install
pnpm run cli login --env production
pnpm run cli spaces --json

Every public MCP tool has a dedicated shell command unless the reviewed CLI mapping records a product-approved exception. The generic mcp bridge does not count as command coverage. download and open are conveniences that compose the dedicated read commands.

Run pnpm run cli --help for the current command list and pnpm run cli help create for one command's exact arguments. Local commands read the repository's .env file.

A small generation loop

pnpm run cli models --kind image --json
pnpm run cli estimate --kind image --model MODEL --prompt "PROMPT" --json
pnpm run cli create --space ACCOUNT/SPACE --kind image \
  --model MODEL --prompt "PROMPT" --request-id REQUEST --wait --json

Read the model id from models; do not copy one from an old script. Quote the configured request before creating it. Reuse the same request id when recovering an uncertain result. The create command re-reads the live catalog for the paying Space, applies its defaults and refuses invalid model settings or an unavailable current model before it calls create_asset. Exact replay leaves availability to the recorded route.

Filter the catalog with models --family provider|internal|browser. Repeated create --ref ASSET:SLOT options keep their left-to-right order. Creation also accepts --seed INTEGER, JSON --position, JSON string-array --tags, and --note TEXT.

Credits, profile and health

pnpm run cli purchase create --account ACCOUNT --product eur20 \
  --request-id topup-01 --billing @./billing.json --json
pnpm run cli purchase get --purchase PURCHASE --json
pnpm run cli profile get --json
pnpm run cli profile update --name "Ada Example" --json
pnpm run cli health --json

--billing accepts one inline JSON object or @FILE. It is only the existing billing identity contract and does not accept card data or payment tokens.

Files and handoff

upload streams a local file through the signed upload URL without putting its bytes in MCP. download saves ready media. export writes the space record, and open prints and opens the canonical web URL for a space or asset.

pnpm run cli upload --space ACCOUNT/SPACE --kind image --file ./reference.png
pnpm run cli export --space ACCOUNT/SPACE --out ./space.json
MAKEFX_NO_OPEN=1 pnpm run cli open ACCOUNT/SPACE

Add --json when a script needs the unchanged structured result. Use MCP directly when the agent host already supports remote servers.