v0.12.1

figlens 0.12.1 reads a Figma copy straight from the clipboard, so turning a copied screen into a .fig is one command, and <command> --help now shows only that command.

Read the clipboard directly (#220)

In 0.12.0, converting a copied selection meant saving the clipboard's HTML first with a long osascript pipeline. Pasting the copy into a text field gives only the layers' text, so it was hard to tell what to save. Now clipboard reads the system clipboard itself:

# In Figma: select the frame or layers, then right-click > Copy (or Cmd/Ctrl+C)
figlens clipboard screen.fig
figlens bundle screen.fig <node> frame.zip

You can also ask your agent to build "the screen I just copied"; it runs the same command. A saved HTML file still works as before: figlens clipboard copied.html screen.fig.

If the clipboard holds no Figma layers (for example, text copied from a web page), the error says to copy layers in Figma. If a clipboard reader is missing, the error names it.

When you have a saved .fig, a Figma link is still the better route: the agent guidance now looks for the project's .fig first and confirms the link's node in it, because a saved file keeps the image fills and vector outlines that a copy lacks. The user guide has a new Copy a selection section comparing the two.

Limitations:

• Reading the clipboard is a CLI command. MCP, Pi, OpenCode and OMP read the converted .fig; an agent with no shell asks you to run the command.
• macOS is checked against real copies. Windows (PowerShell 5.1) and Linux (wl-paste or xclip) are covered by tests with stand-in programs only.

Help for one command (#221)

figlens --help is 373 lines. figlens <command> --help (or -h) now prints only that command's entries, then a pointer to figlens --help. A usage error, such as figlens diff with no files, prints the same short section instead of the whole text. figlens --help itself is unchanged.

Update

figlens update            # or: brew upgrade figlens
npx @runkids/figlens@0.12.1 --version