pai-profiles

Claude Code plugin for managing capability profiles. Toggle skills, agents, hooks, and plugins on/off for different workflows.

Install

# Clone and link
git clone https://github.com/dalepike-VT/pai-profiles.git ~/dev/pai-profiles
cd ~/dev/pai-profiles
bun link

# Or run directly
bun run ~/dev/pai-profiles/bin/pai-profiles.ts

Quick Start

# Show catalog of all components
pai-profiles

# Switch to a profile
pai-profiles development

# Enable/disable individual components
pai-profiles enable Research
pai-profiles disable Browser

Works with zero configuration. All paths default to ~/.claude/.

Configuration

Create ~/.claude/pai-profiles.json (user-level) or .claude/pai-profiles.json (project-level):

{
  "profilesDir": "~/.claude/profiles",
  "protectedSkills": ["CORE", "Profiles"],
  "pluginTokenEstimates": {},
  "provenanceFile": null,
  "packsSourceDir": null,
  "stateDir": "~/.claude/profiles-state",
  "cliCommandName": "pai-profiles"
}

All fields are optional. Unset fields use defaults.

Config Fields

Field	Default	Description
profilesDir	~/.claude/profiles	Directory containing profile JSON files
protectedSkills	["CORE", "Profiles"]	Skills that cannot be disabled
pluginTokenEstimates	{}	Token estimates for installed plugins
provenanceFile	null	Path to group registry (enables groups/packs)
packsSourceDir	null	Path to upstream pack source (enables pack status)
stateDir	~/.claude/profiles-state	Where state files are stored
cliCommandName	pai-profiles	Command name shown in help text

Groups

Groups are collections of related components (skills, hooks, agents) defined in a provenance registry. Set provenanceFile to enable.

pai-profiles group list
pai-profiles group enable security-tools
pai-profiles group disable management-skills

Profiles

Profiles are named configurations that activate specific groups and components.

{
  "version": "2.0",
  "name": "development",
  "description": "Software development focus",
  "groups": ["core-system", "dev-tools"],
  "components": ["Research"],
  "agents": {
    "mode": "allowlist",
    "enabled": ["engineer", "researcher"]
  }
}

Place profile files in your configured profilesDir.

Commands

pai-profiles                     Full catalog display
pai-profiles status              Same as above
pai-profiles <profile>           Apply a named profile
pai-profiles profile             Show active profile and list
pai-profiles profile <name>      Apply a named profile
pai-profiles enable <name>       Enable a skill, agent, or plugin
pai-profiles disable <name>      Disable a skill, agent, or plugin
pai-profiles enable-all skills   Enable all skills
pai-profiles disable-all agents  Disable all agents
pai-profiles hooks               Show hook registry
pai-profiles packs               Show pack install status
pai-profiles group list          List all groups with status
pai-profiles group enable <name> Enable all in group
pai-profiles group disable <name> Disable all in group
pai-profiles index               Regenerate component index

In-Session Usage

The plugin provides a /profiles slash command and a Profiles skill for in-session reporting and command building. The skill cannot toggle components directly but generates CLI commands and copies them to clipboard.

License

MIT