Skip to main content

GitHub Copilot

Adapter for GitHub Copilot CLI (gh copilot).

Install​

amux install copilot

Supported on macOS, Linux and Windows. The adapter spawns gh copilot suggest ..., so the gh CLI must be on PATH.

Auth​

  • GitHub token — set GITHUB_TOKEN.
  • OAuth device flow — gh auth login handles this.

Settings: ~/.config/github-copilot/settings.json.

Minimal run​

amux run copilot --prompt "How do I rebase onto main?"

Notable flags​

The adapter runs:

gh copilot suggest "<prompt>"

It does not currently forward --model or approval modes — Copilot CLI selects the model server-side. Default bundled model is gpt-4o.

Session files​

  • Location: ~/.config/github-copilot/sessions/*.jsonl
  • Output is parsed line-by-line; non-JSON lines are treated as plain text deltas.

Plugins​

Plugin support: yes — GitHub Copilot CLI plugin marketplace with agents/skills/hooks/MCP packages.

Plugin Management​

amux plugin install copilot <plugin>
amux plugin list copilot
amux plugin update copilot <plugin>
amux plugin uninstall copilot <plugin>

MCP Servers​

amux mcp install copilot <mcp-server>
amux mcp list copilot

Capabilities​

Text streaming only. No native tool calling, no parallel tool calls, no JSON mode, no image input.

Known limitations​

  • Cannot resume or fork sessions server-side — Copilot CLI is stateless per invocation.
  • --model is ignored (Copilot picks the model).
  • Requires gh CLI and an authenticated GitHub user.
  • Project-level config not supported.