brew install gh

winget install --id GitHub.cli

curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
sudo apt update
sudo apt install gh

gh extension install github/gh-copilot

gh auth login

gh copilot --version

gh copilot

gh copilot explain "git rebase -i HEAD~3"

gh copilot explain "docker-compose up -d"

gh copilot suggest "find all python files modified in last 7 days"

gh copilot suggest "compress all jpg files in current directory"

gh copilot alias -- --shell bash

ghcs "list all running docker containers"
ghce "kubectl get pods -A"

gh copilot

> I need to review a Python Flask application for security issues

Copilot: I'll help you review your Flask application for security. Could you share:
1. The main application file
2. Any authentication/authorization code
3. Database interaction code

> @app.py @auth.py @models.py

Copilot: [Analyzes files and provides security review]

gh copilot explain "awk '{print $2}' file.txt | sort -u"

gh copilot explain "SELECT u.name, COUNT(o.id) FROM users u LEFT JOIN orders o ON u.id = o.user_id GROUP BY u.id"

gh copilot suggest "recursively delete all node_modules folders"

gh copilot suggest "monitor CPU and memory usage in real-time"

gh copilot
> Review @server.py for potential race conditions

gh copilot
> Compare @config.dev.json and @config.prod.json and explain differences

gh copilot
> @models.py @views.py @serializers.py review this Django app for N+1 queries

gh copilot
> @src/ explain the architecture of this application

gh copilot
> Review @pull_request_changes.diff for:
> - Security vulnerabilities
> - Performance issues
> - Code style violations
> - Missing error handling

gh copilot
> I'm getting "TypeError: Cannot read property 'map' of undefined" in @app.js line 42
> Here's the error stack: @error.log

gh copilot
> Generate pytest unit tests for @calculator.py covering edge cases

gh copilot
> Create Jest tests for @api-client.js including error scenarios

gh copilot
> Write table-driven tests for @handler.go

gh copilot
> Refactor @legacy-auth.js to use async/await instead of callbacks

gh copilot
> Convert @class-component.jsx to a functional component with hooks

mkdir -p ~/.config/gh-copilot/agents

undefined

**Python Expert Agent** (`~/.config/gh-copilot/agents/python-expert.md`):

```markdown

undefined

gh copilot
> @security-reviewer analyze @app.py

gh copilot
> @python-expert review @data_processor.py for optimization opportunities

mkdir -p ~/.config/gh-copilot

undefined

undefined

mkdir -p .copilot/skills

undefined

**React Project Skill** (`.copilot/skills/react-conventions.md`):

```markdown

Skills are automatically loaded when you run `gh copilot` in a directory containing `.copilot/skills/`.

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}

{
  "github": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
    }
  }
}

gh copilot
> Search GitHub for recent issues tagged "bug" in owner/repo

{
  "postgres": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-postgres"],
    "env": {
      "DATABASE_URL": "${DATABASE_URL}"
    }
  }
}

gh copilot
> Query the database for users created in the last 30 days

{
  "filesystem": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
  }
}

{
  "brave-search": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-brave-search"],
    "env": {
      "BRAVE_API_KEY": "${BRAVE_API_KEY}"
    }
  }
}

// my-mcp-server.js
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

const server = new Server({
  name: 'my-custom-server',
  version: '1.0.0',
});

// Define tools
server.setRequestHandler('tools/list', async () => ({
  tools: [{
    name: 'get_data',
    description: 'Fetch data from custom source',
    inputSchema: {
      type: 'object',
      properties: {
        query: { type: 'string' }
      }
    }
  }]
}));

// Implement tool
server.setRequestHandler('tools/call', async (request) => {
  const { name, arguments: args } = request.params;
  
  if (name === 'get_data') {
    const result = await fetchCustomData(args.query);
    return { content: [{ type: 'text', text: JSON.stringify(result) }] };
  }
});

const transport = new StdioServerTransport();
await server.connect(transport);

{
  "my-custom": {
    "command": "node",
    "args": ["/path/to/my-mcp-server.js"]
  }
}

undefined

undefined

gh copilot

> My Flask app is returning 500 errors. Here's the traceback: @error.log
> And here's the relevant code: @app.py @database.py

undefined

gh copilot

> Generate comprehensive Jest tests for @api-client.ts covering:
> - Successful API calls
> - Network errors
> - Invalid responses
> - Timeout scenarios
> - Retry logic

undefined

gh copilot

> I need to refactor @legacy-app/ to use modern React patterns:
> - Convert class components to functional components with hooks
> - Replace Redux with Zustand
> - Add TypeScript types
> Start with @legacy-app/components/UserList.jsx

undefined

gh copilot

> @models.py contains Django ORM queries. Analyze for N+1 query problems

undefined

~/.config/gh-copilot/
├── instructions.md          # Global instructions
├── mcp.json                # MCP server configuration
└── agents/                 # Custom agent definitions
    ├── security-reviewer.md
    ├── python-expert.md
    └── react-specialist.md

your-project/
├── .copilot/
│   └── skills/
│       ├── project-conventions.md
│       ├── api-documentation.md
│       └── deployment-guide.md
├── src/
└── tests/

gh copilot

> I need to add user authentication to my Flask app

undefined

gh copilot

> @legacy-system/ is an old codebase I inherited. Help me understand:
> 1. The overall architecture
> 2. How data flows through the system
> 3. External dependencies
> 4. Potential technical debt

undefined

gh copilot

> @security-reviewer perform a complete security audit of @api/

undefined

gh copilot

> Generate API documentation for @endpoints.py in OpenAPI format

> Create a README.md for @utils/ explaining each utility function

> Add inline comments to @complex-algorithm.py explaining the logic

gh copilot

> I need to migrate from @old-api/ (REST) to @new-api/ (GraphQL)
> Create a migration plan with backwards compatibility

> Show me how to implement the first endpoint in both versions

> Generate tests that verify both APIs return identical data

undefined

**Problem: Extension install fails**
```bash

undefined

undefined

**Problem: "No Copilot subscription"**
- Verify your GitHub account has Copilot access at https://github.com/settings/copilot
- Check if you're using the correct account: `gh auth status`

undefined

**Problem: Too much context, slow responses**
```bash

undefined

undefined

**Problem: Skill not activating**
```bash

undefined

undefined

**Problem: Server timeouts**
- Check network connectivity
- Verify API credentials are valid
- Check server logs if available