Skip to content

agentstack import

Synopsis

agentstack import --from <tool> --source <path> [--profile-file <path>]

Description

The import command reads an existing AI tool’s native configuration and converts it to a canonical agentstack.yaml profile. Use this to migrate from manually maintained configs to AgentStack.

Supported source tools: codex, claude, opencode.

Options

Flag	Type	Required	Description
`--from <tool>`	`codex\|claude\|opencode`	Yes	Source tool to import from
`--source <path>`	string	Yes	Path to the tool’s native config file
`--profile-file <path>`	string	No	Output path for the canonical profile (default: `~/.agentstack/profiles/main/agentstack.yaml`)

Examples

Import from Codex:

agentstack import \
  --from codex \
  --source ~/.codex/config.yaml

Import from Claude Code to a custom profile path:

agentstack import \
  --from claude \
  --source ~/.claude/settings.json \
  --profile-file ~/.agentstack/profiles/work/agentstack.yaml

Import from OpenCode:

agentstack import \
  --from opencode \
  --source ~/.config/opencode/config.json

Notes