Share an agent: Export and Import
1 min · 4 steps
Save any agent to a single .nxragent.json file and re-create it on another machine in one click — no re-prompting the planner.
Every agent on the grid has a `⋯` menu in its top-right corner. Click it, choose 'Export…', and the desktop writes a `.nxragent.json` file via your normal browser download. Hand the file to a teammate (Slack, email, Drive — it's plain JSON). They open the Agents page, click 'Import', pick the file, and the agent appears in their grid with a fresh id.
What's in the file: the agent's name, tagline, trigger, every node + edge, guardrails, and a small provenance header recording the desktop + service versions and the WebSocket endpoint that produced the export. The recipient's nxrd validates the header before persisting — files from a future schema version are refused with a clear error.
What's NOT in the file: OAuth tokens, BYOK secrets, KB indices, run history. Those stay on the originating machine. The imported agent starts in 'draft' status; the recipient re-binds connectors via the agent's Connectors tab and refills any secrets via Settings → AI before activating.
Use this whenever you want to: move an agent between machines, share a working prototype with a teammate, version-control an agent in Git, or stage a 'gold copy' of an agent that you can re-import after experimentation.
Steps
- Open the kebab menu on the agent card.
Top-right corner of the card — the three dots icon. Click it; the menu shows 'Export…'.
- Choose Export….
Your browser's normal save dialog appears with a sensible filename ('email-orchestrator-2026-05-12.nxragent.json'). Save it anywhere.
- On the receiving machine, click 'Import'.
Top of the Agents page, next to 'New Agent'. Pick the file. The agent appears at the top of the grid in 'draft' status.
- Re-bind connectors + secrets.
Open the imported agent → Connectors tab. Any unbound slot shows a 'Connect…' button. The setup checklist on the Overview tab also surfaces anything that needs attention before you flip the agent to 'active'.
Live recipes need the desktop
This article is a static preview. The in-app Help sidecar inside Avery NXR can fire each step against your live project — install the desktop to use it interactively.