Struct DependencySpec 

pub struct DependencySpec {
    pub spec: String,
    pub name: Option<String>,
    pub tool: Option<String>,
    pub target: Option<String>,
    pub filename: Option<String>,
    pub force: bool,
    pub no_install: bool,
}

Common dependency specification used across commands

Fields

spec: String

Dependency specification string

Format: source:path[@version] for Git sources or path for local files

GIT DEPENDENCIES (from a repository source defined in [sources]): source:path@version - Specific version (tag/branch/commit) source:path - Defaults to “main” branch

Examples: official:agents/code-reviewer.md@v1.0.0 - Specific version tag community:snippets/python-utils.md@main - Branch name myrepo:commands/deploy.md@abc123f - Commit SHA community:hooks/pre-commit.json - Defaults to “main”

LOCAL FILE DEPENDENCIES: ./path/file.md - Relative to current directory ../path/file.md - Parent directory /absolute/path/file.md - Absolute path (Unix/macOS) C:\path\file.md - Absolute path (Windows)

Examples: ./agents/my-agent.md - Project agent ../shared-resources/common-snippet.md - Shared resource /usr/local/share/agpm/hooks/lint.json - System-wide hook

PATTERN DEPENDENCIES (glob patterns for multiple files): source:dir/.md@version - All .md files in directory source:dir/**/.md - All .md files recursively

Examples: community:agents/ai/.md@v2.0.0 - All AI agents official:agents/**/review.md@v1.5.0 - All review agents (recursive) ./local-agents/*.md - All local agents

Notes:

• Version is optional for Git sources (defaults to “main”)
• Version is not applicable for local file paths
• Use –name to specify a custom dependency name
• Patterns require –name to provide a meaningful dependency name

name: Option<String>

Custom name for the dependency

If not provided, the name will be derived from the file path. This allows for more descriptive or shorter names in the manifest.

tool: Option<String>

Target tool for the dependency

Specifies which AI coding tool this resource is for. Supported values: claude-code, opencode, agpm

Examples: –tool claude-code - Install to .claude/ (default for agents, commands, scripts, hooks) –tool opencode - Install to .opencode/ –tool agpm - Install to .agpm/ (default for snippets)

target: Option<String>

Custom installation target path (relative to resource directory)

Override the default installation path. The path is relative to the resource type’s default directory (e.g., .claude/agents/).

IMPORTANT: Since v0.3.18+, custom targets are relative to the resource directory, not the project root.

Examples: –target custom/special.md - Install to .claude/agents/custom/special.md –target experimental/test.md - Install to .claude/commands/experimental/test.md

filename: Option<String>

Custom filename for the installed resource

Override the default filename derived from the source path. Use this to rename resources during installation.

Examples: –filename my-reviewer.md - Install as my-reviewer.md instead of original name –filename helper.json - Rename JSON file during installation

force: bool

Force overwrite if dependency exists

By default, adding a duplicate dependency will fail. Use this flag to replace existing dependencies.

no_install: bool

Skip automatic installation after adding dependency

By default, the dependency is automatically installed after being added to the manifest. Use this flag to only update the manifest without installing the dependency files.

Examples: –no-install - Add to manifest only, skip installation

Trait Implementations

impl Args for DependencySpec

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl Clone for DependencySpec

fn clone(&self) -> DependencySpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DependencySpec

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

Formats the value using the given formatter.

impl FromArgMatches for DependencySpec

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.