Struct Profile 

pub struct Profile {
    pub name: String,
    pub path: PathBuf,
    /* private fields */
}

A profile containing configuration files for Claude Code

Profile aggregates related metadata with lazy loading:

• PluginManifest from .claude-plugin/plugin.json
• ProfileMetadata from .dot-agent.toml
• FilterConfig from .dot-agent.toml filter section

Fields

name: String

path: PathBuf

Implementations

impl Profile

pub fn new(name: String, path: PathBuf) -> Self

pub fn manifest(&self) -> Result<Option<&PluginManifest>>

Get plugin manifest (lazy loaded from .claude-plugin/plugin.json)

pub fn metadata(&self) -> Result<Option<&ProfileMetadata>>

Get profile metadata (lazy loaded from .dot-agent.toml)

pub fn filter_config(&self) -> Result<Option<&FilterConfig>>

Get filter config (lazy loaded from .dot-agent.toml)

pub fn source(&self) -> Result<ProfileSource>

Get profile source (Local, Git, or Marketplace)

pub fn version(&self) -> Result<Option<String>>

Get profile version

pub fn description(&self) -> Result<Option<String>>

Get profile description

pub fn category_store(&self) -> Result<CategoryStore>

Get category store (builtin + profile overrides)

Returns a CategoryStore with builtin categories, optionally overridden by categories defined in .dot-agent.toml.

pub fn has_plugin_features(&self) -> bool

Check if profile has plugin features (hooks, MCP, LSP)

pub fn plugin_scope(&self) -> Result<PluginScope>

Get plugin scope (User, Project, or Local)

pub fn plugin_enabled(&self) -> Result<bool>

Check if plugin is enabled

pub fn list_files(&self) -> Result<Vec<PathBuf>>

List all files in the profile directory (relative paths) with default ignore config

pub fn list_files_with_config( &self, config: &IgnoreConfig, ) -> Result<Vec<PathBuf>>

List all files in the profile directory (relative paths) with custom ignore config

File collection logic:

1. Build allowed filter: (DEFAULT_DIRS or plugin paths) + CLAUDE.md + include - exclude
2. Walk all files and collect only those matching the filter

pub fn contents_summary(&self) -> String

Get contents summary (e.g., “skills (5), commands (3)”)

pub fn contents_summary_with_config(&self, config: &IgnoreConfig) -> String

Get contents summary with custom ignore config