docs · adapters
GitHub Copilot CLI#
Unreleased: after 0.11.0. This page is on Hekma's main branch and ships in the next release; Hekma 0.11.0 does not have it.
GitHub's Copilot CLI ships an ACP server mode, so it runs under Hekma's built-in acp kind with no adapter work of its own. The mode is in public preview upstream; this entry is characterized from upstream documentation and has not been run-verified here.
Register#
hekma agent config set my-copilot acp.command "copilot"
hekma agent config set my-copilot acp.args "--acp --stdio"
hekma agent register my-copilot --kind acp
hekma agent start my-copilotHonesty table#
The pause and interaction levels are the acp kind's own capability declaration — identical for every ACP agent and proven by the conformance kit against a scripted stand-in; they are not per-agent promises. The metering rows are characterized from upstream documentation, not run-verified here.
| Surface | Value | Evidence class |
|---|---|---|
pause | guaranteed (Linux), guaranteed (macOS), best-effort (Windows) | contract-validated |
interaction | guaranteed (all OSes) | contract-validated |
| Metering source | self-reported | contract-validated |
| Billing-grade tokens | — — no billing-grade usage in the ledger — tiers attempted: observed: not-configured; sentinel: no-lines-seen; no context usage reported (ACP usage_update is context-grain, never billed). No sentinel emission and no base-URL override is documented upstream | characterized |
| Context usage | an agent-reported usage_update would surface under acp_context_usage — context-grain, never billed; whether this agent reports one is unverified here | characterized |
Validation status. Upstream: preview (the ACP server mode is in public preview upstream since 2026-01-28). Evidence: characterized — upstream documentation, dated 2026-10-23, NOT run-verified here. Nothing pinned.
PATH requirement#
The launch command is the bare word copilot, resolved through the PATH of the environment hekma runs in. Hekma does not bundle, install or pin the Copilot CLI binary — install it yourself, keep it on the PATH, or give an absolute path. A start whose copilot cannot resolve fails with the engine's launch-failure diagnostic naming the executable.
Re-validation duty#
The ACP server mode is a preview surface and can change or disappear in any upstream release; every characterization here is a snapshot by design. Re-validate against the version you install before relying on agent-specific behaviour — Re-validation states the full duty, including the contract duties that no automated kit can prove.
Read next#
- Adapter Gallery: the index this entry belongs to.
- Run an ACP agent: registration, configuration and prompts for ACP agents.
- Meter token usage: what each metering tier counts, and what stays
—.