Skip to content

Document engine.command field for custom executable paths #16768

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pelikhan merged 3 commits into from
Feb 19, 2026
+14 −0
Merged

Document engine.command field for custom executable paths #16768

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
909a6fe
Initial plan
Copilot Feb 19, 2026
42032fa
Document engine.command field in engines.md
Copilot Feb 19, 2026
2171d64
Make engine.command documentation more concise
Copilot Feb 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions docs/src/content/docs/reference/engines.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -86,6 +86,7 @@ engine:
id: copilot
version: latest # defaults to latest
model: gpt-5 # defaults to claude-sonnet-4
command: /usr/local/bin/copilot # custom executable path
args: ["--add-dir", "/workspace"] # custom CLI arguments
agent: agent-id # custom agent file identifier
```
Expand Down Expand Up @@ -131,6 +132,19 @@ engine:

Arguments are added in order and placed before the `--prompt` flag. Common uses include adding directories (`--add-dir`), enabling verbose logging (`--verbose`, `--debug`), and passing engine-specific flags. Consult the specific engine's CLI documentation for available flags.

### Custom Engine Command

Override the default engine executable using the `command` field. Useful for testing pre-release versions, custom builds, or non-standard installations. Installation steps are automatically skipped.

```yaml wrap
engine:
id: copilot
command: /usr/local/bin/copilot-dev # absolute path
args: ["--verbose"]
```

The command supports absolute paths (`/usr/local/bin/copilot`), relative paths (`./bin/claude`), environment variables (`$HOME/.local/bin/codex`), or commands in PATH.

## Related Documentation

- [Frontmatter](/gh-aw/reference/frontmatter/) - Complete configuration reference
Expand Down