profile

profile is a command for coding agents from rolecraft-sh/rolecraft. It costs 0 tokens per session (1,063 once invoked), scanned A, original, MIT.

A command for saving, applying, comparing, editing, and sharing named snapshots of agent configurations. A profile can include configuration files, MCP servers, skills, and instructions.

In plain words
What is it for?
Use it to save development environments, apply them later, compare profiles, or export and import configurations.
Why use it?
It helps you switch between repeatable setups for different projects or share the same setup with a team.

Command

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 commands/rolecraft-sh/rolecraft/profile
Clone the repo
git clone --depth 1 https://github.com/rolecraft-sh/rolecraft

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.

agentmods badge for profile

README.md
[![agentmods](https://agentmods.dev/badge/commands/rolecraft-sh/rolecraft/profile.svg)](https://agentmods.dev/commands/rolecraft-sh/rolecraft/profile)
Your own site
<a href="https://agentmods.dev/commands/rolecraft-sh/rolecraft/profile"><img src="https://agentmods.dev/badge/commands/rolecraft-sh/rolecraft/profile.svg" alt="Measured on agentmods" height="20"></a>
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,063 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found 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.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.01063
Opus 5 $0.00000 $0.00531
Sonnet 5 $0.00000 $0.00213
Haiku 4.5 $0.00000 $0.00106

Measured 3d ago against content hash e0f3dfb4bf57, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

profile scanned grade A with 0 findings 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 3d 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

docs/commands/profile.md · 187 lines

How it starts

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

rolecraft profile — Profile Management

Save, apply, and share multi-agent configuration profiles.

📖 For the concept guide and team workflows, see Profile Management.

Profiles capture your agent settings (config files, MCP servers, skills, and instructions) as named snapshots that can be applied later or shared across projects.

Usage

rolecraft profile save <name> [options]
rolecraft profile apply <name> [options]
rolecraft profile diff <name>
rolecraft profile edit <name>
rolecraft profile list
rolecraft profile show <name>
rolecraft profile delete <name> [options]
rolecraft profile export <name> [options]
rolecraft profile import <path>
rolecraft profile link [<name>] [options]

Subcommands

save

Capture current agent configurations into a named profile.

rolecraft profile save frontend-dev --cursor --claude
rolecraft profile save full-setup --all
rolecraft profile save minimal --dry-run

Options:

  • --agents, --cursor, --claude, etc. — Target specific agents
  • --all — Save all detected agents
  • --dry-run — Preview what would be saved without writing

Profiles are stored as JSON in ~/.agents/profiles/<name>.json.

apply

Apply a profile's settings to your agents.

rolecraft profile apply frontend-dev
rolecraft profile apply frontend-dev --dry-run
rolecraft profile apply frontend-dev --skip-mcp
rolecraft profile apply frontend-dev --skip-skills

Options:

  • --agents, --cursor, --claude, etc. — Apply to specific agents only
  • --dry-run — Preview changes without applying
  • --yes, -y — Skip confirmation prompts
  • --skip-mcp — Skip MCP server configuration
  • --skip-skills — Skip skill installation

Apply creates backups of existing configs in ~/.agents/backups/ before making changes.

diff

Compare a profile against your current configuration.

rolecraft profile diff frontend-dev

Shows which aspects (config, MCP servers, skills, instructions) differ for each agent.

Read the full file on GitHub · 187 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.

  1. 3d ago First seen · 187 lines · 0 tokens per session scan A e0f3dfb4bf57

Subscribe to this mod's changes

profile is a command published in the GitHub repository rolecraft-sh/rolecraft (75 stars, last pushed 6d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,063 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.