{"id":51552821,"url":"https://github.com/akesson/figma-explorer","last_synced_at":"2026-07-10T01:01:39.121Z","repository":{"id":360233815,"uuid":"1235437516","full_name":"akesson/figma-explorer","owner":"akesson","description":null,"archived":false,"fork":false,"pushed_at":"2026-07-03T09:01:00.000Z","size":1002,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-03T10:29:14.158Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/akesson.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE-MIT","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-11T10:21:40.000Z","updated_at":"2026-07-03T09:01:03.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/akesson/figma-explorer","commit_stats":null,"previous_names":["akesson/figma-explorer"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/akesson/figma-explorer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akesson%2Ffigma-explorer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akesson%2Ffigma-explorer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akesson%2Ffigma-explorer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akesson%2Ffigma-explorer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/akesson","download_url":"https://codeload.github.com/akesson/figma-explorer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akesson%2Ffigma-explorer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35316840,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-09T02:00:07.329Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-07-10T01:01:36.394Z","updated_at":"2026-07-10T01:01:39.114Z","avatar_url":"https://github.com/akesson.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"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 without copy-pasting node ids.\n- **`node-info`** — single-target view with layout, fills, strokes, effects, text, bound variables, and comments. Designed to be pasted into an agent prompt.\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`** — pre-warm a local cache so subsequent commands are offline-fast.\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 project ids; 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# ...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). Pass `--json` for full pretty 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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakesson%2Ffigma-explorer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fakesson%2Ffigma-explorer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakesson%2Ffigma-explorer/lists"}