component, component-set, style
Three families with identical shapes. Whatever holds for component holds for component-set
and style, with the noun swapped; styles carry one extra field, style_type.
| Command | Scope required |
|---|---|
<resource> team-list [team] |
team_library_content:read |
<resource> file-list <file> |
library_content:read |
<resource> get <key> |
library_assets:read |
All nine commands are rate limit tier 3, the cheapest.
team-list
Section titled “team-list”cyber-figma component team-list [team]cyber-figma component-set team-list [team]cyber-figma style team-list [team]A team’s published library content, as key, name, file_key, node_id, updated_at —
plus style_type for styles. The team argument takes a team id or a team URL and falls back to
--team, then FIGMA_TEAM_ID.
| Option | Description |
|---|---|
--page-size <number> |
Results per page (default: 30; components documents a maximum of 1000, above which values are capped) |
--before <id> / --after <id> |
Where to resume; mutually exclusive |
--all |
Fetch every page, up to --max-pages |
--max-pages <number> |
Ceiling on --all (default: 10) |
cyber-figma component team-list --page-size 100cyber-figma style team-list --all --max-pages 5cyber-figma component-set team-list 1234567890 --after 30These three advance with --after (or --before), not --cursor: the cursor here is an
opaque integer bound Figma tracks internally, not a real id and not a page number. The next
steps printed after a page name the exact --after to use.
file-list
Section titled “file-list”cyber-figma component file-list <file>cyber-figma component-set file-list <file>cyber-figma style file-list <file>What one file publishes. Not paginated — the whole set comes back at once.
cyber-figma component get <key>cyber-figma component-set get <key>cyber-figma style get <key>One published item by its library key — the key column from either list command, not a
node id. Returns the name, description, the file key and node id it lives at, when it was
created and last updated, who updated it, and a thumbnail URL. Styles also report
style_type.
The file_key and node_id in the result are the bridge back into the file: pass them to
file nodes to read the actual geometry — remembering
that is a tier-1 call.