Skip to content

agentstack translate

Terminal window
agentstack translate --profile-file <path> --to <tool> [--dry-run]

The current translate command is an inspection step.

It loads the canonical profile, runs the provider adapter, and prints a structured translation result that includes:

  • the target provider
  • the output file paths the adapter would materialize
  • compatibility information
  • a mode flag such as plan or dry-run

It does not write any files.

Use apply when you actually want to write the provider-native config files.

FlagTypeRequiredDescription
--profile-file <path>stringYesPath to the canonical agentstack.yaml
--to <tool>codex|claude|opencode|geminiYesTarget provider
--dry-runbooleanNoMark the translation result as a dry-run inspection

Inspect the Codex translation plan:

Translate to Codex plan
agentstack translate \
--profile-file ~/.agentstack/profiles/main/agentstack.yaml \
--to codex

Inspect a dry-run result for Claude Code:

Dry-run translation plan
agentstack translate \
--profile-file ~/.agentstack/profiles/main/agentstack.yaml \
--to claude \
--dry-run

Pipe the plan JSON into jq:

Inspect translation result
agentstack translate \
--profile-file ~/.agentstack/profiles/main/agentstack.yaml \
--to opencode | jq .