figma-files

figma — File & Project Commands

Quick start

# Verify token
figma me

# Get file structure
figma files get <file-key> --depth 1

# Get specific nodes
figma files nodes <file-key> --ids 1:2,3:4

# List frames
figma files frames <file-key>

# Export images
figma images export <file-key> --ids 1:2,3:4 --format png

# List comments
figma comments list <file-key>

---

figma me

Show current user info (verify token works).

figma me [--json]

JSON output:

{
  "id": "123456",
  "handle": "John Doe",
  "email": "[email protected]",
  "img_url": "https://..."
}

---

figma files get <file-key>

Get file structure and metadata.

figma files get <file-key> [--depth N] [--version ID] [--geometry paths] [--json]

Options:

• --depth N — depth of node tree (use 1-2 for large files)
• --version ID — get a specific version
• --geometry paths — include vector path data

JSON output: Full Figma file JSON (name, document tree, lastModified, version).

---

figma files nodes <file-key>

Get specific nodes by ID.

figma files nodes <file-key> --ids 1:2,3:4 [--json]

JSON output:

{
  "name": "File Name",
  "nodes": {
    "1:2": { "document": { "id": "1:2", "name": "Node", "type": "FRAME", ... } }
  }
}

---

figma files frames <file-key>

List all frames in a file.

figma files frames <file-key> [--json]

JSON output: Array of FigmaNode objects with type "FRAME".

---

figma images export <file-key>

Export nodes as images (PNG, SVG, JPG, PDF).

figma images export <file-key> --ids 1:2,3:4 [--format png] [--scale 2] [--output-dir ./exports] [--json]

Options:

• --ids — (required) comma-separated node IDs
• --format — png, svg, jpg, pdf (default: png)
• --scale — 0.01 to 4 (default: 2)
• --output-dir — output directory (default: current directory)

JSON output:

{
  "fileKey": "abc123",
  "outputDir": "./exports",
  "format": "png",
  "exported": [{ "nodeId": "1:2", "filename": "1-2.png", "path": "./exports/1-2.png" }],
  "failed": []
}