Skip to main content
Profiles package reusable configuration, hooks, and commands. Teams distribute profiles via providers (git repositories or local folders) and install them per workspace.

​
Quick Start

# Register a provider
codanna profile provider add bartolli/codanna-profiles

# List available profiles
codanna profile list --verbose

# Install to current workspace
codanna profile install claude

# Check status
codanna profile status

​
Providers

Sources of profiles:
TypeExample
GitHub shorthandbartolli/codanna-profiles
Git URLhttps://github.com/org/profiles.git
Local path./my-profiles
# Add provider
codanna profile provider add bartolli/codanna-profiles

# List providers
codanna profile provider list --verbose

# Remove provider
codanna profile provider remove codanna-profiles

​
Managing Profiles

# Install
codanna profile install claude

# Update
codanna profile update claude

# Remove
codanna profile remove claude

# Verify integrity
codanna profile verify claude

​
Team Sync

Commit .codanna/profiles.lock.json to your repository. Teammates run: 
codanna profile sync
This installs all profiles from the lockfile.

​
Storage

LocationPurpose
~/.codanna/providers.jsonGlobal provider registry
~/.codanna/profiles/Cached provider clones
.codanna/profiles.lock.jsonInstalled profiles for workspace

​
Next Steps

Tool Tiers

Which tool to use when.

MCP Persistent

Configure AI assistant integration.