DeveloperHA / AI agents / GitHub Copilot CLI
Terminal coding agent · CLI agents

GitHub Copilot CLI

Learn how Copilot CLI differs from older shell-command suggestion tools: it can work in a trusted directory, use agents and manage context while you retain the GitHub account and repository policy boundary.

Made by GitHubSeparate agent guideReviewed 2026-09-26Model ≠ harness ≠ orchestrator
Scope note This is an independent guide to a third-party project or a developer concept. Installation commands, feature boundaries, plans, model availability and security defaults change. Follow the official source links before using it with private code, credentials or automation.

What it is and who makes it

GitHub's command-line Copilot surface for conversational assistance, coding tasks, custom agents and delegated workflows.

Maker or project: GitHub. Classification: Terminal coding agent; this page treats the surrounding context, tools, permissions and verification as the relevant harness boundary.

1
Start Copilot in a trusted project directory and authenticate.

Start Copilot in a trusted project directory and authenticate.

2
Ask questions or delegate a bounded task.

Ask questions or delegate a bounded task.

3
The CLI can read, modify or execute within the permitted directory and agent policy.

The CLI can read, modify or execute within the permitted directory and agent policy.

4
Review changes and use GitHub's normal branch, pull-request and CI controls.

Review changes and use GitHub's normal branch, pull-request and CI controls.

Who it may fit

Pick an agent by its control surface and trust boundary, not only by its model label.

Useful scenarios

  • GitHub-centered development teams
  • Terminal assistance with repository context
  • Custom agents and handoff into GitHub workflows

Trade-offs and checks

  • The CLI can read, modify and execute files below the trusted directory; choose that directory carefully.
  • Organization policy, plan availability and model behavior can change.
  • Delegating a task to a hosted coding agent is a different data and execution path from a local CLI session.

Interactive vs headless and CI

These modes change the approval, identity and observability boundary.

The CLI is primarily an interactive terminal surface. Prompt, custom-agent and delegation flows can drive automation or hosted background work, but account, organization policy, trusted directories and GitHub-side permissions remain separate boundaries.

Request-to-verification workflow

Use this mental model when debugging a surprising edit, tool call or cost.

Input

Intent + context

Your prompt, repository instructions, selected files, history and environment become model context.

Action

Tool + permission

The harness proposes a read, edit, shell, web, MCP or other action; policy decides whether it can run.

Feedback

Result + verification

Command output, compiler errors, tests and your review return to the loop before acceptance.

Setup outline

Start with the smallest safe experiment, then follow the current official documentation for the real installation.

1
Follow the current GitHub Copilot CLI documentation and account policy.
2
Start in a non-production repository or worktree.
3
Review trusted-directory, custom-agent and delegation settings.
4
Keep repository secrets, CI tokens and deployment permissions scoped separately.
Illustrative workflow
cd your-project
copilot

# Start with analysis
> Map the test projects and suggest the smallest change. Do not edit files.

# Continue an approved session later
copilot --continue

Instructions, skills, MCP and hooks

These surfaces can shape context or add actions; they are part of the trust boundary.

Copilot CLI supports repository and user-level instructions, custom agents and MCP-related configuration documented by GitHub. Custom agents can change prompts and tool choices; review repository, organization and user precedence, and do not treat a checked-in agent file as trusted policy by default.

Security and isolation checklist Use a disposable branch or worktree; keep secrets outside the readable path; require approval for writes, shell, network and deployment actions; inspect commands before allowing them; constrain server bindings; review MCP servers, plugins, skills, hooks and instruction files; and run tests independently of the agent's own summary.

Official sources

Use these sources for current installation, capabilities, plans, releases and security notices.

Reviewed 2026-09-26. This date is a change-tracking note, not a promise that the product remains unchanged.

Related learning

Related agent guides

Want the foundations behind the workflow?

Study AI fundamentals, prompt design, AI-assisted development, agents and MCP without a forced linear course.

Open AI learningAI tools