figmacode

CLI to run eval code inside the CodeConvert Figma plugin from the terminal. A request is posted as a realtime record, the open plugin executes it in the Figma sandbox and writes the result back, and the CLI prints it as JSON.

Requires the CodeConvert plugin to be open in Figma while the command runs.

Install / Run

# one-off (no install)
npx -y figmacode --eval "figma.currentPage.name"

# or install globally (bins: figmacode, cc, fc)
npm i -g figmacode
figmacode --eval "figma.currentPage.selection[0].name"

Token

Get the token from the plugin's account menu (avatar, top-right) — it shows your short cct_… access token plus a copy-paste call example. A JWT from POST /auth/signin works too.

# powershell
$env:ACCESS_TOKEN="cct_..."; npx -y figmacode --eval "figma.currentPage.name"

# bash
ACCESS_TOKEN="cct_..." npx -y figmacode --eval "figma.root.children.length"

Rotate the short token at any time: POST /api/token/rotate (Bearer auth). The old token stops working immediately.

Flags

• --eval "<js>" | --code "<js>" — JS to run (may return a promise). Required.
• --args '{...}' — JSON args passed through to the executed code.
• --timeout ms — how long to wait for the plugin (default 60000).
• --url wss://... — origin WS url (default wss://codeconvert.cc).
• --delete — delete the request record right after reading the result.
• --user <uid> — target a different user's queue (admins only).

Examples

npx -y figmacode --eval "figma.currentPage.name"
npx -y figmacode --eval "figma.currentPage.selection.map(n => n.name)"
npx -y figmacode --eval "figma.root.children.length" --delete

Notes

• Done records self-delete 30s after completion, so the queue never fills.
• No --user needed normally: the target queue is derived from your token.
• The plugin panel (header button) shows each request live: pending → done.