agentleFS
soulmachinesoulmachine/skills/paseo-profiles/SKILL.md

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.

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
  1. Very specific:

    Always offer --dry-run first when the target already has profiles of its own.

    line 36
  2. Distinctive:

    Every other key in the target is read, left alone, and written back verbatim.

    line 57
  3. Very specific:

    After writing, it reads paseo daemon reload --json and reports honestly — including when the edit will be ignored because a launch-time …

    line 87

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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-lume

Multiple 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 nothing

Always 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 pathHow
daemon.agentProfilesmerged element-wise
daemon.mcp.injectIntoAgentsscalar overwrite
daemon.browserTools.enabledscalar overwrite
agents.providers.omp.enabledscalar 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

  • paseo is not on the non-interactive ssh PATH on every host. ssh host 'paseo …' can fail with not found while ssh host 'zsh -lc paseo' works. Use an absolute path — ~/.local/share/mise/shims/paseo on hosts running the npm CLI, /opt/homebrew/bin/paseo on 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 --json and 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.
  • push stages the script at /tmp/paseo-profiles-$(id -u).py on the remote and runs it with python3, so the target needs python3 on its ssh PATH (macOS with CLT or mise: yes).

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.