{"_id":"@akesson/figma-explorer","_rev":"4-a0a14c85b15dfa3ed302e6b12b57ddbb","name":"@akesson/figma-explorer","dist-tags":{"latest":"0.2.3"},"versions":{"0.1.0":{"name":"@akesson/figma-explorer","version":"0.1.0","keywords":["command-line-utilities","figma","cli","design","design-tokens"],"license":"MIT","_id":"@akesson/figma-explorer@0.1.0","maintainers":[{"name":"akesson","email":"henrik@akesson.mobi"}],"homepage":"https://github.com/akesson/figma-explorer","bugs":{"url":"https://github.com/akesson/figma-explorer/issues"},"bin":{"figma-explorer":"run-figma-explorer.js"},"dist":{"shasum":"a07456d910e629df0890f98a6ef7363a6b3f325e","tarball":"https://registry.npmjs.org/@akesson/figma-explorer/-/figma-explorer-0.1.0.tgz","fileCount":11,"integrity":"sha512-1EDtXnAsyDoR36OGURnI+bOgduUODwYXcJEBqvGEtXmXiaAzl+piVnMgh8HN/Trbs6fpDbe4P4NVqAs24vfgLQ==","signatures":[{"sig":"MEUCIFztqZkzPgFNk9iv8aQXHS6HVXDWqpb8N8oCFKBVf3ElAiEApTwA1PXb75V3TeLD1zulB5anV746YL/nzS3ep6pZqqc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38046},"_from":"file:npm/figma-explorer-npm-package.tar.gz","volta":{"npm":"9.5.0","node":"18.14.1"},"engines":{"npm":">=6","node":">=14"},"scripts":{"fmt":"prettier --write **/*.js","fmt:check":"prettier --check **/*.js","postinstall":"node ./install.js"},"_npmUser":{"name":"akesson","email":"henrik@akesson.mobi"},"_resolved":"/home/runner/work/figma-explorer/figma-explorer/npm/figma-explorer-npm-package.tar.gz","_integrity":"sha512-1EDtXnAsyDoR36OGURnI+bOgduUODwYXcJEBqvGEtXmXiaAzl+piVnMgh8HN/Trbs6fpDbe4P4NVqAs24vfgLQ==","repository":{"url":"git+https://github.com/akesson/figma-explorer.git","type":"git"},"_npmVersion":"10.8.2","description":"High-level CLI on top of the Figma REST API: name-based navigation, asset extraction, design tokens, and bundled context export.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"axios":"^1.13.5","rimraf":"^6.1.3","detect-libc":"^2.1.2","console.table":"^0.10.0","axios-proxy-builder":"^0.1.2"},"glibcMinimum":{"major":2,"series":35},"_hasShrinkwrap":true,"devDependencies":{"prettier":"^3.8.1"},"preferUnplugged":true,"supportedPlatforms":{"aarch64-apple-darwin":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-aarch64-apple-darwin.tar.xz"},"x86_64-pc-windows-gnu":{"bins":{"figma-explorer":"figma-explorer.exe"},"zipExt":".zip","artifactName":"figma-explorer-x86_64-pc-windows-msvc.zip"},"x86_64-pc-windows-msvc":{"bins":{"figma-explorer":"figma-explorer.exe"},"zipExt":".zip","artifactName":"figma-explorer-x86_64-pc-windows-msvc.zip"},"aarch64-pc-windows-msvc":{"bins":{"figma-explorer":"figma-explorer.exe"},"zipExt":".zip","artifactName":"figma-explorer-x86_64-pc-windows-msvc.zip"},"x86_64-unknown-linux-gnu":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-x86_64-unknown-linux-musl.tar.xz"},"aarch64-unknown-linux-gnu":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-aarch64-unknown-linux-gnu.tar.xz"},"x86_64-unknown-linux-musl-static":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-x86_64-unknown-linux-musl.tar.xz"},"x86_64-unknown-linux-musl-dynamic":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-x86_64-unknown-linux-musl.tar.xz"}},"artifactDownloadUrls":["https://github.com/akesson/figma-explorer/releases/download/v0.1.0"],"_npmOperationalInternal":{"tmp":"tmp/figma-explorer_0.1.0_1779717148470_0.06457518796638184","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@akesson/figma-explorer","version":"0.2.0","keywords":["command-line-utilities","figma","cli","design","design-tokens"],"license":"MIT","_id":"@akesson/figma-explorer@0.2.0","maintainers":[{"name":"akesson","email":"henrik@akesson.mobi"}],"homepage":"https://github.com/akesson/figma-explorer","bugs":{"url":"https://github.com/akesson/figma-explorer/issues"},"bin":{"figma-explorer":"run-figma-explorer.js"},"dist":{"shasum":"7c87c4a4fc5b6b19a22109d0f66fb9d3b48382f7","tarball":"https://registry.npmjs.org/@akesson/figma-explorer/-/figma-explorer-0.2.0.tgz","fileCount":11,"integrity":"sha512-Xf7VfgYTm1a8k/V+JV1SyJZQrwUfsClrqLaxFNP0kPWOT9JRn+qNqRbF0x02wUsIGmiiTcYDOVddPSUMO/+OWQ==","signatures":[{"sig":"MEUCIDBmeGaZaicfdU3pRkUnD2vBTXDDMn/AZWdhM46E+0IXAiEAgY4yhSYxfjyI7ZSu9CrijjxpkKzOobvEfhYq2ZH07N4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48843},"_from":"file:npm/figma-explorer-npm-package.tar.gz","volta":{"npm":"9.5.0","node":"18.14.1"},"engines":{"npm":">=6","node":">=14"},"scripts":{"fmt":"prettier --write **/*.js","fmt:check":"prettier --check **/*.js","postinstall":"node ./install.js"},"_npmUser":{"name":"akesson","email":"henrik@akesson.mobi"},"_resolved":"/home/runner/work/figma-explorer/figma-explorer/npm/figma-explorer-npm-package.tar.gz","_integrity":"sha512-Xf7VfgYTm1a8k/V+JV1SyJZQrwUfsClrqLaxFNP0kPWOT9JRn+qNqRbF0x02wUsIGmiiTcYDOVddPSUMO/+OWQ==","repository":{"url":"git+https://github.com/akesson/figma-explorer.git","type":"git"},"_npmVersion":"10.8.2","description":"High-level CLI on top of the Figma REST API: name-based navigation, asset extraction, design tokens, and bundled context export.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"axios":"^1.13.5","rimraf":"^6.1.3","detect-libc":"^2.1.2","console.table":"^0.10.0","axios-proxy-builder":"^0.1.2"},"glibcMinimum":{"major":2,"series":35},"_hasShrinkwrap":true,"devDependencies":{"prettier":"^3.8.1"},"preferUnplugged":true,"supportedPlatforms":{"aarch64-apple-darwin":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-aarch64-apple-darwin.tar.xz"},"x86_64-pc-windows-gnu":{"bins":{"figma-explorer":"figma-explorer.exe"},"zipExt":".zip","artifactName":"figma-explorer-x86_64-pc-windows-msvc.zip"},"x86_64-pc-windows-msvc":{"bins":{"figma-explorer":"figma-explorer.exe"},"zipExt":".zip","artifactName":"figma-explorer-x86_64-pc-windows-msvc.zip"},"aarch64-pc-windows-msvc":{"bins":{"figma-explorer":"figma-explorer.exe"},"zipExt":".zip","artifactName":"figma-explorer-x86_64-pc-windows-msvc.zip"},"x86_64-unknown-linux-gnu":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-x86_64-unknown-linux-musl.tar.xz"},"aarch64-unknown-linux-gnu":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-aarch64-unknown-linux-gnu.tar.xz"},"x86_64-unknown-linux-musl-static":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-x86_64-unknown-linux-musl.tar.xz"},"x86_64-unknown-linux-musl-dynamic":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-x86_64-unknown-linux-musl.tar.xz"}},"artifactDownloadUrls":["https://github.com/akesson/figma-explorer/releases/download/v0.2.0"],"_npmOperationalInternal":{"tmp":"tmp/figma-explorer_0.2.0_1785349925059_0.1942055960377973","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@akesson/figma-explorer","version":"0.2.2","keywords":["command-line-utilities","figma","cli","design","design-tokens"],"license":"MIT","_id":"@akesson/figma-explorer@0.2.2","maintainers":[{"name":"akesson","email":"henrik@akesson.mobi"}],"homepage":"https://github.com/akesson/figma-explorer","bugs":{"url":"https://github.com/akesson/figma-explorer/issues"},"bin":{"figma-explorer":"run-figma-explorer.js"},"dist":{"shasum":"22ff34e562e0bd736fe0f29312b8e7bccd7ea962","tarball":"https://registry.npmjs.org/@akesson/figma-explorer/-/figma-explorer-0.2.2.tgz","fileCount":11,"integrity":"sha512-shYGEE6m+zSAmiMzK7kFlm7Mp8PwWzc2Ww/Xc3VDlCnsgtD3xBh2BHP4B6+s+cC/PLV5b+VsbvcTSsfUSYgs1A==","signatures":[{"sig":"MEUCIQDN3fk/8YfXnY7tWpvD2yexxo5zY/YrYDC6ssH46/gwegIgclrjxumN2jsFd+GFbIrPrQ/oOAaEgKhDs08f+SocoI4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIDzhjcXU/ssAo8oQacrFDOoJ7/uQ+IqoXYV4JfFmVkwMAiEAp1C3/3kdOo8UPxMMmWJy6YBfJAt3kbHEpWagtj80j0s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@akesson%2ffigma-explorer@0.2.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":34982},"_from":"file:npm/figma-explorer-npm-package.tar.gz","volta":{"npm":"9.5.0","node":"18.14.1"},"engines":{"npm":">=6","node":">=14.14"},"scripts":{"fmt":"prettier --write **/*.js","fmt:check":"prettier --check **/*.js","postinstall":"node ./install.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:aafadf06-bc7c-4e32-bc2d-8ffc3531c98e"}},"_resolved":"/home/runner/work/figma-explorer/figma-explorer/npm/figma-explorer-npm-package.tar.gz","_integrity":"sha512-shYGEE6m+zSAmiMzK7kFlm7Mp8PwWzc2Ww/Xc3VDlCnsgtD3xBh2BHP4B6+s+cC/PLV5b+VsbvcTSsfUSYgs1A==","repository":{"url":"git+https://github.com/akesson/figma-explorer.git","type":"git"},"_npmVersion":"12.0.2","description":"High-level CLI on top of the Figma REST API: name-based navigation, asset extraction, design tokens, and bundled context export.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"detect-libc":"^2.1.2"},"glibcMinimum":{"major":2,"series":35},"_hasShrinkwrap":true,"devDependencies":{"prettier":"^3.8.3"},"preferUnplugged":true,"supportedPlatforms":{"aarch64-apple-darwin":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-aarch64-apple-darwin.tar.xz"},"x86_64-pc-windows-gnu":{"bins":{"figma-explorer":"figma-explorer.exe"},"zipExt":".zip","artifactName":"figma-explorer-x86_64-pc-windows-msvc.zip"},"x86_64-pc-windows-msvc":{"bins":{"figma-explorer":"figma-explorer.exe"},"zipExt":".zip","artifactName":"figma-explorer-x86_64-pc-windows-msvc.zip"},"aarch64-pc-windows-msvc":{"bins":{"figma-explorer":"figma-explorer.exe"},"zipExt":".zip","artifactName":"figma-explorer-x86_64-pc-windows-msvc.zip"},"x86_64-unknown-linux-gnu":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-x86_64-unknown-linux-musl.tar.xz"},"aarch64-unknown-linux-gnu":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-aarch64-unknown-linux-gnu.tar.xz"},"x86_64-unknown-linux-musl-static":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-x86_64-unknown-linux-musl.tar.xz"},"x86_64-unknown-linux-musl-dynamic":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-x86_64-unknown-linux-musl.tar.xz"}},"artifactDownloadUrls":["https://github.com/akesson/figma-explorer/releases/download/v0.2.2"],"_npmOperationalInternal":{"tmp":"tmp/figma-explorer_0.2.2_1787409536476_0.4282146910275453","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"_id":"@akesson/figma-explorer@0.2.3","bin":{"figma-explorer":"run-figma-explorer.js"},"bugs":{"url":"https://github.com/akesson/figma-explorer/issues"},"dist":{"shasum":"4c13203c4a203e9a3a0a73ad881878a119a38334","tarball":"https://registry.npmjs.org/@akesson/figma-explorer/-/figma-explorer-0.2.3.tgz","fileCount":11,"integrity":"sha512-nHzjgy4gQ4LO+yZcYkthX5UvBNt1jGkjqrFBWrN1yrk0ucqDbNRv1gOG8NwyU3y61HENJwnUKqSYnct4ChUofQ==","signatures":[{"sig":"MEUCIEJWPZpop12BQ5muqz6YE0p8BFR5bYbD8PKTbOFJG2jaAiEA4EKkZvjYUtTD+Xo6ju9CJeTi0lT2LT7x6LaJyx6vAYM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDo0yVMxfVFgP5vzC2ylOaG1VkGav7zExkkrD4laQX46gIhALQGxW7wdq/oE5/N24aVqg8LNMIFQbRcgpFMoFeaKnkI"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@akesson%2ffigma-explorer@0.2.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":41925},"name":"@akesson/figma-explorer","_from":"file:npm/figma-explorer-npm-package.tar.gz","volta":{"npm":"9.5.0","node":"18.14.1"},"engines":{"npm":">=6","node":">=14.14"},"license":"MIT","scripts":{"fmt":"prettier --write **/*.js","fmt:check":"prettier --check **/*.js","postinstall":"node ./install.js"},"version":"0.2.3","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:aafadf06-bc7c-4e32-bc2d-8ffc3531c98e"}},"homepage":"https://github.com/akesson/figma-explorer","keywords":["command-line-utilities","figma","cli","design","design-tokens"],"_resolved":"/home/runner/work/figma-explorer/figma-explorer/npm/figma-explorer-npm-package.tar.gz","_integrity":"sha512-nHzjgy4gQ4LO+yZcYkthX5UvBNt1jGkjqrFBWrN1yrk0ucqDbNRv1gOG8NwyU3y61HENJwnUKqSYnct4ChUofQ==","repository":{"url":"git+https://github.com/akesson/figma-explorer.git","type":"git"},"_npmVersion":"12.1.0","description":"High-level CLI on top of the Figma REST API: name-based navigation, asset extraction, design tokens, and bundled context export.","directories":{},"maintainers":[{"name":"akesson","email":"henrik@akesson.mobi"}],"_nodeVersion":"22.23.2","dependencies":{"detect-libc":"^2.1.2"},"glibcMinimum":{"major":2,"series":35},"_hasShrinkwrap":true,"devDependencies":{"prettier":"^3.8.3"},"preferUnplugged":true,"supportedPlatforms":{"aarch64-apple-darwin":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-aarch64-apple-darwin.tar.xz"},"x86_64-pc-windows-gnu":{"bins":{"figma-explorer":"figma-explorer.exe"},"zipExt":".zip","artifactName":"figma-explorer-x86_64-pc-windows-msvc.zip"},"x86_64-pc-windows-msvc":{"bins":{"figma-explorer":"figma-explorer.exe"},"zipExt":".zip","artifactName":"figma-explorer-x86_64-pc-windows-msvc.zip"},"aarch64-pc-windows-msvc":{"bins":{"figma-explorer":"figma-explorer.exe"},"zipExt":".zip","artifactName":"figma-explorer-x86_64-pc-windows-msvc.zip"},"x86_64-unknown-linux-gnu":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-x86_64-unknown-linux-musl.tar.xz"},"aarch64-unknown-linux-gnu":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-aarch64-unknown-linux-gnu.tar.xz"},"x86_64-unknown-linux-musl-static":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-x86_64-unknown-linux-musl.tar.xz"},"x86_64-unknown-linux-musl-dynamic":{"bins":{"figma-explorer":"figma-explorer"},"zipExt":".tar.xz","artifactName":"figma-explorer-x86_64-unknown-linux-musl.tar.xz"}},"artifactDownloadUrls":["https://github.com/akesson/figma-explorer/releases/download/v0.2.3"],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/figma-explorer_0.2.3_1790154012243_0.6349084610784703"}}},"time":{"created":"2026-05-25T13:52:28.309Z","modified":"2026-09-23T09:00:12.721Z","0.1.0":"2026-05-25T13:52:28.644Z","0.2.0":"2026-07-29T18:32:05.193Z","0.2.2":"2026-08-22T14:38:56.587Z","0.2.3":"2026-09-23T09:00:12.334Z"},"bugs":{"url":"https://github.com/akesson/figma-explorer/issues"},"license":"MIT","homepage":"https://github.com/akesson/figma-explorer","keywords":["command-line-utilities","figma","cli","design","design-tokens"],"repository":{"url":"git+https://github.com/akesson/figma-explorer.git","type":"git"},"description":"High-level CLI on top of the Figma REST API: name-based navigation, asset extraction, design tokens, and bundled context export.","maintainers":[{"name":"akesson","email":"henrik@akesson.mobi"}],"readme":"# figma-explorer\n\nA command-line tool for navigating, inspecting, and exporting from Figma files via the REST API. Built for use alongside AI coding agents that need to consume design context as text and assets.\n\n## What it does\n\n- **`ls`** / **`find`** — navigate projects, files, and node trees by name or visible text without copy-pasting node ids. `find` speaks web-search syntax: `\"exact phrases\"`, uppercase `OR`, `-exclusion`.\n- **`node-info`** — single-target view with layout, fills, strokes, effects, text, bound variables, comments, and a ready-made figma.com `url:`. Hidden subtrees are pruned (listed as `hidden_children`), defaults elided, and variables referenced by short handles, so a full screen is a few dozen KB rather than hundreds. Designed to be pasted into an agent prompt.\n- **`comments`** — list a file's comment threads (replies inline, newest first), threads under a node, or a single thread; filter with `--unresolved` / `--since` / `--grep`.\n- **`mark`** — curated keyword→node bookmarks (`mark add key file:N:x:y --alias …`); `find` and `library search` surface matching marks ahead of their own hits, and `mark:key` resolves anywhere an id is accepted.\n- **`library search`** — fuzzy search across a team's published component library (components, component sets, styles).\n- **`screenshot`** — export a node as PNG / JPG / SVG / PDF.\n- **`tokens`** — extract design tokens (colors, fonts, sizes, spacing).\n- **`assets`** — bulk-export every icon/image below a node.\n- **`context`** — aggregate: tree + screenshot + tokens + assets for a node.\n- **`cache prefetch`** / **`cache status`** — pre-warm a local cache so subsequent commands are offline-fast, and report what it holds (per-file age, sidecars, catalog) without touching the network.\n\nAll commands share a tagged-id grammar — `proj:N`, `file:N`, `file:N:x:y`, or a full `figma.com` URL — so you never paste raw node identifiers by hand.\n\n## Install\n\n### macOS (Homebrew)\n\n```sh\nbrew install akesson/tap/figma-explorer\n```\n\n### Linux / macOS (shell installer)\n\n```sh\ncurl --proto '=https' --tlsv1.2 -LsSf https://github.com/akesson/figma-explorer/releases/latest/download/figma-explorer-installer.sh | sh\n```\n\n### Windows (PowerShell)\n\n```powershell\npowershell -ExecutionPolicy Bypass -c \"irm https://github.com/akesson/figma-explorer/releases/latest/download/figma-explorer-installer.ps1 | iex\"\n```\n\n### npm\n\n```sh\nnpm install -g @akesson/figma-explorer\n```\n\n### From source\n\n```sh\ncargo install --git https://github.com/akesson/figma-explorer figma-explorer\n```\n\n## Setup\n\nGet a personal access token at https://www.figma.com/developers/api#access-tokens and export it:\n\n```sh\nexport FIGMA_TOKEN=figd_...\n```\n\nOptional environment variables:\n\n- `FIGMA_PROJECTS_IDS` — comma-separated Figma folder ids (Figma renamed \"projects\" to \"folders\" in August 2026; the numeric ids are unchanged, so existing values keep working); needed by `cache prefetch`.\n- `FIGMA_TEAM_ID` — needed by `library search` and for the catalog warm in `cache prefetch`.\n- `FIGMA_EXPLORER_CACHE_DIR` — override the cache location (default: OS cache dir).\n\nA `.env` file in the current directory (or any ancestor up to root) is auto-loaded, with `~/.config/figma-explorer/.env` as the global fallback — handy for git worktrees and directories with no `.env` in their ancestry. Exported environment variables always win.\n\n## Quickstart\n\n```sh\n# List everything at the root\nfigma-explorer ls\n\n# Drill into a project, then a file\nfigma-explorer ls proj:1\nfigma-explorer ls file:2\n\n# Find a node by name across every cached file\nfigma-explorer find \"Button / Primary\"\n\n# Hunt rendered copy with an exact phrase (single-quote so the shell keeps the double quotes)\nfigma-explorer find '\"Approved by you\"'\n\n# ...or scope the search to one file\nfigma-explorer --in file:2 find \"Button / Primary\"\n\n# Get implementation-ready info for one node\nfigma-explorer node-info file:2:1094:66591\n\n# Search the team component library\nfigma-explorer library search \"icon arrow\"\n\n# Export everything below a node as PNGs\nfigma-explorer assets file:2:1094:66591 ./out/\n\n# Pre-warm the cache so subsequent reads are offline\nfigma-explorer cache prefetch\n```\n\n## Output\n\nYAML by default (terse, agent-friendly: block style for the tree, flow style `{k: v}` for leaf maps and short lists). Pass `--json` for compact JSON suitable for `jq` pipelines.\n\n## Cache\n\nA local rkyv cache lives at `$FIGMA_EXPLORER_CACHE_DIR` or the OS cache dir. It is **per-machine** — rkyv archives are not endianness-portable, so don't sync the cache directory across architectures. `cache clear` removes everything; `cache prefetch` warms it from `FIGMA_PROJECTS_IDS`.\n\n## License\n\nMIT. See `LICENSE-MIT`.\n","readmeFilename":"README.md"}