Struct CommandsRoot 

pub struct CommandsRoot { /* private fields */ }

Root directory of one set of slash command definitions (<root>/<stem>.md). Use Self::user for the user-level root at ~/.claude/commands, Self::project for a project’s <dir>/.claude/commands, or Self::at to point at an arbitrary directory for tests.

Implementations

impl CommandsRoot

pub fn user() -> Result<Self>

Resolve the user-level commands root at ~/.claude/commands. Errors if $HOME cannot be determined.

pub fn project(project_dir: impl Into<PathBuf>) -> Self

Resolve a project-level commands root at <project_dir>/.claude/commands. The project_dir is the project root itself (the .claude/commands suffix is appended internally).

pub fn at(path: impl Into<PathBuf>) -> Self

Use a specific path as the commands root. Useful for tests.

pub fn path(&self) -> &Path

The configured root directory.

pub fn list(&self) -> Result<Vec<CommandSummary>>

List every *.md command at the root, sorted by file stem.

Returns an empty vec if the root directory doesn’t exist (a project or user without custom commands). Files that fail to parse contribute a tracing warning and are skipped.

pub fn get(&self, file_stem: &str) -> Result<Command>

Read one command by file stem. Errors if no such file exists or it fails to parse.

Trait Implementations

impl Clone for CommandsRoot

fn clone(&self) -> CommandsRoot

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CommandsRoot

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.