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

# Quickstart

> Set up Coral in minutes: run the onboarding flow, connect your first sources, and start querying your data.

This tutorial gets you from a fresh [install](/docs/getting-started/installation) of Coral, to your first SQL query.

<Tip>
  Prefer the CLI experience? Run `coral onboard` for an interactive wizard that
  walks you through the whole setup described in this page.
</Tip>

## 1. Discover bundled sources

```shellscript theme={"theme":{"light":"github-light","dark":"github-dark"}}
coral source discover
```

This lists the bundled sources available in your build. Coral comes with [bundled sources](/docs/reference/bundled-sources) for GitHub, Slack, Datadog, Linear, Sentry, and more.

## 2. Add a source

For example, add GitHub. Pass `--interactive` and Coral will prompt you for each required input:

```shellscript theme={"theme":{"light":"github-light","dark":"github-dark"}}
coral source add --interactive github
```

Once connected, the source's data is available as SQL tables. To update a source's credentials later, run the same command again.

<Tip>
  For scripted setups, omit `--interactive` and Coral reads each input from an
  environment variable of the same name — e.g. `GITHUB_TOKEN=ghp_... coral
      source add github`.
</Tip>

## 3. Query your data

You can now query any connected source using SQL.

Use `coral.tables` to see all available tables:

```shellscript theme={"theme":{"light":"github-light","dark":"github-dark"}}
coral sql "SELECT schema_name, table_name FROM coral.tables ORDER BY 1, 2"
```

Assuming you've connected GitHub, try listing open issues for a repo:

```shellscript theme={"theme":{"light":"github-light","dark":"github-dark"}}
coral sql "
  SELECT number, title, state, created_at
  FROM github.issues
  WHERE owner = 'withcoral' AND repo = 'coral' AND state = 'open'
  ORDER BY created_at DESC
  LIMIT 10
"
```

## Next steps

* **[Use Coral over MCP](/docs/guides/use-coral-over-mcp)** — expose Coral to Claude Code, Cursor, or VS Code over MCP so your agent can query sources directly
* **[Write a custom source spec](/docs/guides/write-a-custom-source)** — connect any HTTP API or local dataset that isn't bundled yet
* **[Install Coral skills](/docs/getting-started/installation#skills)** — teach your coding agent how to use Coral
