What is TalkToFigmaDesktop CLAUDE.md?

A project instruction file for TalkToFigma Desktop, an Electron application that connects Figma with AI tools through the Model Context Protocol, a structured way for software tools to communicate.

Use it when developing, packaging, linting, or understanding the structure of the TalkToFigma Desktop project.

It gives coding agents the project’s background, migration history, architecture, and development commands so they can work consistently in the repository.

TalkToFigmaDesktop CLAUDE.md — Instructions file for Claude Code by grab: A project instruction file for TalkToFigma Desktop, an Electron…

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add instructions/grab/talktofigmadesktop/claude-md

Clone the repo

git clone --depth 1 https://github.com/grab/TalkToFigmaDesktop

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/grab/talktofigmadesktop/claude-md.svg)](https://agentmods.dev/instructions/grab/talktofigmadesktop/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/grab/talktofigmadesktop/claude-md"><img src="https://agentmods.dev/badge/instructions/grab/talktofigmadesktop/claude-md.svg" alt="Measured on agentmods" height="20"></a>

Per session 2,880 This file is loaded in full into every session.

When invoked 2,880 The same file — it is already loaded in full.

Security scan C 1 finding. Scan, not verified.

Origin 97% copy Near-identical to another mod in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.02880	$0.02880
Opus 5	$0.01440	$0.01440
Sonnet 5	$0.00576	$0.00576
Haiku 4.5	$0.00288	$0.00288

Measured 6d ago against content hash 3dfc163faa16, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade C, and why

TalkToFigmaDesktop CLAUDE.md scanned grade C with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

- Clear Vite cache: `rm -rf .vite`

Origin

This is a copy

97% identical to TalkToFigmaDesktop AGENTS.md — 12 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

CLAUDE.md · 303 lines

How it starts

The opening of the file, as written. The whole thing — 303 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

TalkToFigma Desktop is an Electron-based desktop application that bridges Figma with AI tools (Cursor, Claude Code, VS Code) using the Model Context Protocol (MCP). It enables AI assistants to read and manipulate Figma designs through a structured protocol.

Current Version: 2.0.0 Bundle ID: com.grabtaxi.klever Architecture: Electron + React + TypeScript

Migration History

This project was migrated from Kotlin Compose Desktop to Electron in January 2026 (v2.0.0). The Electron version maintains feature parity while adding cross-platform support (macOS, Windows, Linux) and better developer experience with modern JavaScript tooling.

Development Commands

Start Development Server

npm start
# Launches Electron app with hot reload
# Main process: src/main.ts
# Renderer process: src/renderer.tsx

Build & Package

npm run package  # Package for current platform
npm run make     # Create distributable installers

Linting

npm run lint     # Run ESLint on TypeScript files

Building Individual Components

The project uses Vite with multiple entry points configured in forge.config.ts:

Main process: src/main.ts → vite.main.config.ts
Preload script: src/preload.ts → vite.preload.config.ts
Renderer: React app → vite.renderer.config.ts
MCP stdio server: src/main/server/mcp-stdio-server.ts → vite.stdio.config.ts

Architecture

High-Level Overview

MCP Clients (Cursor, Claude Code, etc.)
    │ spawn independent process per client
    ▼
stdio MCP Servers (one per client)
    │ WebSocket connection (ws://127.0.0.1:3055)
    ▼
WebSocket Server (Electron App - Port 3055)
    │ Channel-based routing
    ▼
Figma Plugin

Core Architectural Concepts

1. Multi-Process Architecture

Each MCP client (Cursor, Claude Code) spawns its own independent stdio server process
stdio servers are NOT managed by the Electron app - they're spawned by the MCP clients themselves
All stdio servers connect to the same WebSocket server (port 3055) in the Electron app
This allows multiple AI tools to work with Figma simultaneously

Read the full file on GitHub · 303 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

6d ago First seen · 303 lines · 2,880 tokens per session scan C 3dfc163faa16

Subscribe to this mod's changes

TalkToFigmaDesktop CLAUDE.md is an instructions file published in the GitHub repository grab/TalkToFigmaDesktop (51 stars, last pushed 4mo ago), licensed MIT. It adds 2,880 tokens to every session, about $0.0144 per session on Opus 5. A static security scan graded it C with 1 finding (recursive force delete). It is 97% identical to TalkToFigmaDesktop AGENTS.md, differing in 12 lines, and is treated as a copy.

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

TalkToFigmaDesktop CLAUDE.md