Skip to content

[bot] Add /pr command, new hook types, agent invocation options, and SDK session APIs (CLI v1.0.5–v1.0.7) #14

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

Draft
github-actions wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

[bot] Add /pr command, new hook types, agent invocation options, and SDK session APIs (CLI v1.0.5–v1.0.7) #14

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
61 changes: 60 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ For detailed documentation, see the [Further Reading](#further-reading) section
│ Prompt files Reusable recipes for repeated tasks │
│ Skills Packaged expertise, auto-loaded on demand │
│ MCP Servers Connect to external tools, databases, APIs │
│ Hooks Automate lifecycle events (format, lint, startup) │
│ Hooks Lifecycle events (format, lint, startup, agents) │
│ Custom Agents Named specialists with personas │
│ Plugins Bundle all of the above into one package │
│ │
Expand All @@ -47,6 +47,7 @@ For detailed documentation, see the [Further Reading](#further-reading) section
│ Running Parallel Auto-delegates work; /fleet for explicit │
│ Tasks & /fleet parallel execution via subagents │
│ Autopilot Mode Hands-off autonomous task completion (CLI) │
│ /pr Command Create, fix CI, and address PR reviews (CLI) │
│ Coding Agent Autonomous cloud agent — issues in, PRs out │
│ Agentic Workflows Automate repo tasks via GitHub Actions + AI │
│ Mission Control Dashboard to manage coding agents at scale │
Expand Down Expand Up @@ -94,6 +95,7 @@ For detailed documentation, see the [Further Reading](#further-reading) section
- [Agentic Features](#agentic-features)
- [Running Parallel Tasks](#running-parallel-tasks)
- [Autopilot Mode](#autopilot-mode)
- [The /pr Command](#the-pr-command)
- [Copilot Coding Agent](#copilot-coding-agent)
- [Agentic Workflows](#agentic-workflows)
- [Mission Control](#mission-control)
Expand Down Expand Up @@ -332,6 +334,12 @@ Custom scripts that run automatically at specific lifecycle events — like pre-
},
"startup": {
"prompt": "/compact Summarize recent changes in RecipeShare"
},
"preCompact": {
"command": "npm run export-session-notes"
},
"subagentStart": {
"prompt": "You are working inside the RecipeShare project. Always check .github/copilot-instructions.md before starting."
}
}
}
Expand All @@ -346,6 +354,8 @@ Custom scripts that run automatically at specific lifecycle events — like pre-
| `post-edit` | After Copilot edits a file |
| `pre-commit` | Before a git commit |
| `startup` | When a CLI session starts — auto-submits a prompt or slash command |
| `preCompact` | Before context compaction starts — run cleanup or export state |
| `subagentStart` | When a subagent is spawned — inject additional context into the subagent's prompt |

**Config notes:**

Expand Down Expand Up @@ -376,6 +386,7 @@ A named agent with a persona, specific tools, and specialized behavior.
---
name: Security Reviewer
description: Reviews code for security vulnerabilities
user-invocable: true
---
You are a security-focused code reviewer for RecipeShare.

Expand All @@ -397,6 +408,7 @@ Output format: list findings as HIGH/MEDIUM/LOW with file:line references.
| | |
|---|---|
| **Scope** | Explicitly selected by the user — not auto-loaded |
| **Invocation options** | `user-invocable: true` (default) — agent appears in `/agents` for manual selection; `disable-model-invocation: true` — prevents the model from auto-invoking the agent |
| **Difference from instructions** | Agents are interactive personas; instructions are passive context |

---
Expand Down Expand Up @@ -603,6 +615,36 @@ Autopilot and `/fleet` are independent features that combine well. A common work

---

### The /pr Command

A CLI slash command that autonomously manages pull requests — create PRs from your current branch, fix failing CI checks, address reviewer comments, and resolve merge conflicts without leaving the terminal.

> **When you need it:** You want to go from local commits to a PR — or fix CI failures and respond to reviewer feedback — without switching to GitHub.com.

```
# Create a PR from the current branch
> /pr

# Fix a failing CI check on the open PR
> /pr The deploy job is failing with a missing env var

# Address reviewer feedback
> /pr The reviewer wants better error handling in the auth route

# Resolve a merge conflict
> /pr Resolve the merge conflict in src/server/routes/recipes.ts
```

Copilot reads the current branch, open PR, CI logs, and reviewer comments — then makes changes autonomously and pushes to the PR branch.

| | |
|---|---|
| **Where** | Copilot CLI only (added in v1.0.5) |
| **What it does** | Create PR, fix CI, address review comments, resolve merge conflicts |
| **Docs** | [CLI releases v1.0.5](https://github.com/github/copilot-cli/releases/tag/v1.0.5) |

---

### Copilot Coding Agent

GitHub's autonomous agent that picks up issues, creates branches, and opens PRs — **without a chat session**. It runs on GitHub's cloud infrastructure, not your machine.
Expand Down Expand Up @@ -797,10 +839,26 @@ Programmatic access to Copilot's capabilities in **Node.js**, **Python**, **Go**
npm install @github/copilot-sdk
```

Experimental session APIs (v1.0.7+) allow you to introspect and manage the CLI session programmatically:

```typescript
import { getSession } from "@github/copilot-sdk";

const session = await getSession();

// Discover available skills, MCP servers, and plugins
const skills = await session.listSkills();
const mcpServers = await session.listMcpServers();
const plugins = await session.listPlugins();
```

The session APIs support optional **config auto-discovery** from the working directory, so they pick up `.github/skills/`, `.vscode/mcp.json`, and installed plugins automatically.

| | |
|---|---|
| **Status** | Technical preview |
| **Languages** | Node.js, Python, Go, .NET |
| **Session APIs** | Experimental (v1.0.7+): list/manage skills, MCP servers, plugins with auto-discovery |
| **Repository** | [github.com/github/copilot-sdk](https://github.com/github/copilot-sdk) |
| **Difference from agents** | Agents are markdown prompts; SDK is programmatic code |

Expand Down Expand Up @@ -971,6 +1029,7 @@ Based on [lessons from 2,500+ repositories](https://github.blog/ai-and-ml/github
| **Plugins** | Bundled agent toolkits | `plugin.json` manifest | When sharing agent setups across repos |
| **Running Parallel Tasks / `/fleet`** | Auto-delegates or explicitly fans out work to subagents | *(runtime capability)* / `/fleet` slash command | When your request has multiple independent jobs |
| **Autopilot Mode** | Hands-off autonomous task completion | Copilot CLI (`--autopilot` / Shift+Tab) | When you want Copilot to work to completion without interaction |
| **`/pr` Command** | Create PRs, fix CI failures, address review feedback | Copilot CLI (`/pr` slash command) | When managing PRs from the terminal |
| **Coding Agent** | Autonomous cloud agent | GitHub infrastructure | When you want async issue automation |
| **Agentic Workflows** | AI + GitHub Actions automation | GitHub Actions | When you want automated repo maintenance |
| **Mission Control** | Multi-agent dashboard | GitHub.com / VS Code | When managing agents at scale |
Expand Down