agentstack translate
Synopsis
Section titled “Synopsis”agentstack translate --profile-file <path> --to <tool> [--dry-run]Description
Section titled “Description”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
planordry-run
It does not write any files.
Use apply when you actually want to write the provider-native config files.
Options
Section titled “Options”| Flag | Type | Required | Description |
|---|---|---|---|
--profile-file <path> | string | Yes | Path to the canonical agentstack.yaml |
--to <tool> | codex|claude|opencode|gemini | Yes | Target provider |
--dry-run | boolean | No | Mark the translation result as a dry-run inspection |
Examples
Section titled “Examples”Inspect the Codex translation plan:
agentstack translate \ --profile-file ~/.agentstack/profiles/main/agentstack.yaml \ --to codexInspect a dry-run result for Claude Code:
agentstack translate \ --profile-file ~/.agentstack/profiles/main/agentstack.yaml \ --to claude \ --dry-runPipe the plan JSON into jq:
agentstack translate \ --profile-file ~/.agentstack/profiles/main/agentstack.yaml \ --to opencode | jq .