paseo-profiles
Skill3 starsChanged yesterdayMITView on GitHub
Copy paseo agent profiles (Architect, Engineer, Reviewer, Writer…) from one machine to another by merging them into the target's ~/.paseo/config.json, over ssh, idempotently. Use when the user wants to export/import/sync/clone paseo agent profiles between hosts, set up paseo agent profiles on a new or freshly installed machine, or roll the same profile set across a fleet. paseo itself has no profile export/import command — `paseo agent` manages running agents, not profile templates.
In this repository31 other files it gives its agents.
- affix-domainsSkill
- apple-designSkill
- apwcli-pairSkill
- ask-always-on-agentSkill
- asus-esc8000-firmware-upgradeSkill
- asus-esc8000-gpu-bios-tuningSkill
- build-stealth-rustdeskSkill
- chrome-cdp-setupSkill
- cua-macos-lume-sandboxSkill
- deploy-kimi-k26-on-rtx-pro-6000Skill
- deploy-kimi-k3-on-rtx-pro-6000Skill
- deploy-stealth-rustdeskSkill
- ghostty-terminfoSkill
- herdr-rename-hookSkill
- imsg-permissionsSkill
- llm-inference-benchmarkSkill
- lxd-docker-firewall-conflictSkill
- mac-mini-as-headless-serverSkill
- macos-app-multi-instancesSkill
- macos-smb-serverSkill
- mac-smb-automountSkill
- openclaw-diagnoseSkill
- private-fork-syncSkill
- refresh-claude-accountSkill
- ssh-claude-authSkill
- sync-claude-accountsSkill
- to-featuresSkill
- trusted-publishSkill
- ubuntu-lxd-gpu-serverSkill
- ubuntu-nvidia-gpu-enablementSkill
- ubuntu-zfs-mirror-installSkill
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 1 is distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 36
Always offer --dry-run first when the target already has profiles of its own.
- Distinctive: line 57
Every other key in the target is read, left alone, and written back verbatim.
- Very specific: line 87
After writing, it reads paseo daemon reload --json and reports honestly — including when the edit will be ignored because a launch-time …
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
paseo-profiles
Move agent profiles — the templates that pair a name, provider, model, mode, and thinking level (“Software Engineer” = claude / claude-opus-5 / bypassPermissions / xhigh) — between machines.
paseo has no command for this. The profiles are a JSON array at daemon.agentProfiles in
~/.paseo/config.json, authored by hand in a paseo client UI (desktop, mobile, or the daemon's
own web UI) and reachable from no CLI.
Why not just scp config.json
That same file holds host-specific settings: daemon.listen, daemon.relay.enabled,
daemon.cors, and any password hash written by paseo daemon set-password. Copying the file
wholesale flips those on the target. ~/.paseo/server-id, cli-client-id and daemon-keypair.json
are per-host identity and must never be copied either. So this is a key-scoped merge, not a file copy.
Usage
One command does the whole round trip:
~/.claude/skills/paseo-profiles/scripts/paseo-profiles.py push dev-server-frank-lumeMultiple hosts are just more arguments; one host failing doesn't abort the rest.
paseo-profiles.py push host-a host-b host-c --dry-run # report only, write nothingAlways offer --dry-run first when the target already has profiles of its own.
The halves are also usable separately, for an air-gapped or reviewed transfer:
paseo-profiles.py export -o profiles.json # on the source
paseo-profiles.py import profiles.json # on the target (also reads stdin)Other flags: --config PATH (default ~/.paseo/config.json), --no-reload.
paseo-profiles.py selftest checks the merge logic.
What it carries
| Key path | How |
daemon.agentProfiles | merged element-wise |
daemon.mcp.injectIntoAgents | scalar overwrite |
daemon.browserTools.enabled | scalar overwrite |
agents.providers.omp.enabled | scalar overwrite |
Every other key in the target is read, left alone, and written back verbatim.
Merge rules
Per incoming profile: id match → replace in place; else name match under a different id →
replace that slot, incoming id wins (importing “Software Engineer” must not leave two of them); else
append. Profiles only the target has are never deleted. Re-running is a no-op — it prints
no changes and skips the write and reload entirely.
Reference
references/config-and-merge.md covers the profile fields on
disk, the export envelope and its versioning, how each incoming profile resolves, the atomic write,
and how the reload report is read. Reach for it when a merge did something unexpected, when adding
a key to the synced set, when changing the envelope version, or when a reload reports a path back.
Safety
Backs up to config.json.bak-<UTC> before the first write, writes via a temp file at mode 0600
then os.replace (atomic; the file holds secrets on some hosts). A missing target config is created
rather than treated as an error.
Gotchas
paseois not on the non-interactive ssh PATH on every host.ssh host 'paseo …'can fail with not found whilessh host 'zsh -lc paseo'works. Use an absolute path —~/.local/share/mise/shims/paseoon hosts running the npm CLI,/opt/homebrew/bin/paseoon any still on Paseo.app. The script resolves this itself, in that order.- A stopped daemon is fine. Reload is best-effort; a stopped daemon reads the config at next start, and the script says so instead of failing.
- After writing, it reads
paseo daemon reload --jsonand reports honestly — including when the edit will be ignored because a launch-time flag outranks the file. See the reference. - Profiles land regardless of whether the target has that provider installed. A Codex profile on a host without Codex shows as unavailable — a gap on that host, not a transfer failure.
pushstages the script at/tmp/paseo-profiles-$(id -u).pyon the remote and runs it withpython3, so the target needs python3 on its ssh PATH (macOS with CLT or mise: yes).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

