framer-agent-apilisted
Install: claude install-skill translational-vestment612/framer-import
# Editing Framer sites through the agent API
A field-tested playbook for driving real edits into an existing Framer project
with `npx @framer/agent@latest`. It ships **alongside the base `framer` skill**
(bundled in the same package): the base skill provides the foundation —
`session new`, `exec`, `apply-changes`, `docs`, and the generated project
inventory — and this companion skill layers on **the practical mechanics and the
bugs you only learn by hitting them**, none of which are spelled out in the base
docs. Load the base skill for setup/session basics; reach here the moment you're
actually mutating nodes.
## Prerequisite: connect the agent to Framer (one-time)
Before any edit, the base `framer` skill must be installed and a project
connected:
1. `npx @framer/agent@latest setup` (needs Node ≥ 24). This is the **same
universal setup for every agent** — Claude Code, Codex, Cursor, Antigravity —
the CLI auto-detects the tool and installs to `~/.agents/skills`
(+ `~/.claude/skills` for Claude Code). Ref: https://www.framer.com/agents/external/
2. Connect the project: `npx @framer/agent session new "<project url or id>"`, or
copy the project link (browser address bar, or right-click the project tab →
"Copy Project Link").
If setup hasn't run, `framer.agent.*` calls won't work — do this first.
## Mental model
A Framer project is a tree of **nodes**, each with a stable **id**. You edit by:
1. **Reading** the tree with `framer.agent.getNode` / `getDescendan