GitHub Copilot¶

Two components: CLI for shell command help, and agent config for VS Code Copilot Chat.

Agent Configuration (iron/.copilot/)¶

Config managed with stow for VS Code Copilot Chat agents/skills.

cd ~/dotfiles
stow iron

Symlinks .copilot/ to project directories.

Structure¶

iron/.copilot/
├── agents/            # Agent definitions (matches opencode)
├── skills/            # Reusable skills (matches opencode)
├── mcp-config.json    # MCP server configuration
└── drawio-only.json   # Specialized drawio MCP config

Agents (same as OpenCode)¶

Agent	Model	Use Case
`builder`	GPT-5.2-Codex	Multi-file implementations
`quick-fix`	Claude Haiku 4.5	Small edits
`tester`	GPT-5.2-Codex	Test writing
`reasoning`	Claude Sonnet 4.5	Complex analysis
`summarizer`	Claude Sonnet 4.5	Summarization
`reviewer`	default	Code review
`ideation`	default	Brainstorming (read-only)
`task-orchestrator`	Claude Opus 4.5	Multi-step delegation

Skills (same as OpenCode)¶

All skills from OpenCode are mirrored, plus: - spawn-subagents - Copilot CLI-specific subagent spawning

Differences from OpenCode¶

Aspect	OpenCode	Copilot
Tool names	`bash`, `edit`, `write`	`execute`, `terminal`, `vscode`
Permissions	Explicit permission block	Not supported
Commands	`command/` directory	Not supported
drawio skill	Full MCP skill	Delegated via `drawio-delegate`

Copilot CLI (gh copilot)¶

Command-line AI assistant for shell commands. Uses gh copilot extension.

Installation¶

gh extension install github/gh-copilot

Commands¶

Command	Purpose
`gh copilot suggest`	Generate a command from natural language
`gh copilot explain`	Explain what a command does
`gh copilot config`	Configure preferences
`gh copilot alias`	Generate shell aliases

Usage¶

Suggest Commands¶

# Get command suggestions
gh copilot suggest "find large files in current directory"
gh copilot suggest "compress all jpg files"
gh copilot suggest "list all running docker containers"

# Optionally specify target shell
gh copilot suggest -t bash "restart nginx"
gh copilot suggest -t zsh "find files modified today"

Explain Commands¶

# Understand unfamiliar commands
gh copilot explain "find . -name '*.py' -exec grep -l 'import os' {} +"
gh copilot explain "awk '{sum+=$1} END {print sum}'"
gh copilot explain "tar -czvf archive.tar.gz --exclude='*.log' ."

Shell Aliases¶

Add to your shell config for quick access:

# Zsh (~/.zshrc)
eval "$(gh copilot alias -- zsh)"

# Bash (~/.bashrc)
eval "$(gh copilot alias -- bash)"

This provides shorthand commands: - ghcs - copilot suggest - ghce - copilot explain

Tips¶

Be specific in your suggestions - include context like "on macOS" or "using ripgrep"
Use explain before running unfamiliar commands from the internet
Suggest can execute commands directly after confirmation
Works best for shell/CLI tasks, not code generation (use OpenCode for that)