Skip to content

agentstack profile

Terminal window
agentstack profile install <repo-spec> --profile <name> [--target-profile <name>] [--ref <branch|tag>]

The profile command lets you install shared profile templates from git or GitHub repositories.

This is useful when a team maintains a standard AgentStack setup (MCP servers, skills, providers) and you want to bootstrap your local profile from that source.

Install a shared profile template.

FlagTypeRequiredDescription
--profile <name>stringYesName of the source profile inside the repository
--target-profile <name>stringNoLocal destination profile name (defaults to source profile name)
--ref <branch|tag>stringNoGit ref to install from (branch or tag)

Install from GitHub URL spec:

Install profile from GitHub
agentstack profile install \
url:https://github.com/acme/agentstack-profiles \
--profile mobile-default

Install using a specific branch/tag:

Install profile from a specific ref
agentstack profile install \
url:https://github.com/acme/agentstack-profiles \
--profile backend-team \
--ref main

Install and rename locally:

Install into a custom local profile name
agentstack profile install \
url:https://github.com/acme/agentstack-profiles \
--profile mobile-default \
--target-profile my-mobile