> ## Documentation Index
> Fetch the complete documentation index at: https://docs.edgespark.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub Copilot and EdgeSpark

> Set up GitHub Copilot with EdgeSpark — install the EdgeSpark Copilot plugin, generate AGENTS.md, and follow the public Copilot workflow.

GitHub Copilot uses the dedicated EdgeSpark Copilot plugin with `AGENTS.md` as the project instructions file.

<Steps>
  <Step title="Install the EdgeSpark CLI">
    ```bash theme={null}
    npm install -g @edgespark/cli
    edgespark login
    ```

    This installs the CLI globally and authenticates your account. Your credentials are stored locally and reused for all subsequent commands.
  </Step>

  <Step title="Install the EdgeSpark GitHub Copilot plugin">
    ```bash theme={null}
    copilot plugin marketplace add edgesparkhq/copilot-plugins
    copilot plugin install edgespark@edgespark-copilot-plugins
    ```

    This is the current public GitHub Copilot onboarding flow exposed by EdgeSpark.
  </Step>

  <Step title="Initialize your project">
    ```bash theme={null}
    edgespark init my-app --agent copilot
    cd my-app
    ```

    `--agent copilot` currently scaffolds `AGENTS.md`. That gives GitHub Copilot the EdgeSpark-specific project rules and workflow context.
  </Step>

  <Step title="Start an EdgeSpark task">
    In GitHub Copilot, use the EdgeSpark task-entry command:

    ```text theme={null}
    /edgespark:building-edgespark-apps
    ```
  </Step>
</Steps>

## Extending AGENTS.md

Add project-specific rules below the generated content:

```markdown theme={null}
<!-- Generated content above — do not edit -->

## Project-specific rules

- The `posts` table is soft-deleted — always filter `WHERE deleted_at IS NULL`
- Route `/api/admin/*` requires `user.role === 'admin'` checked after platform auth
```

GitHub Copilot should follow these additions with the same priority as the generated content. See [AGENTS.md reference](/agents/agents-md) for the full format.

## See also

<Columns cols={2}>
  <Card title="AGENTS.md reference" icon="file-lines" href="/agents/agents-md">
    Full reference for the agent instructions file and how to extend it.
  </Card>

  <Card title="Declarative workflow" icon="database" href="/agents/declarative-workflow">
    How GitHub Copilot should work with repo-owned defs, generated types, and deploys.
  </Card>

  <Card title="Supported agents" icon="robot" href="/agents/supported-agents">
    Status and setup paths for Claude Code, Gemini CLI, OpenAI Codex, Cursor, GitHub Copilot, and all other agents.
  </Card>

  <Card title="Other AI agents" icon="robot" href="/agents/other-agents">
    OpenCode, Amp, Devin, Aider, Windsurf, Cline, Continue, Antigravity, Kiro, and all other agents using generic EdgeSpark skills.
  </Card>
</Columns>
