{"id":48654702,"url":"https://github.com/withcoral/coral","last_synced_at":"2026-04-10T09:01:02.194Z","repository":{"id":350403293,"uuid":"1200798950","full_name":"withcoral/coral","owner":"withcoral","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-10T08:31:42.000Z","size":1991,"stargazers_count":17,"open_issues_count":17,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-10T08:32:30.633Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://withcoral.com","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/withcoral.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-03T20:56:07.000Z","updated_at":"2026-04-10T07:02:25.000Z","dependencies_parsed_at":null,"dependency_job_id":"95b7fb29-388c-4f78-bba3-c55fea38ffa9","html_url":"https://github.com/withcoral/coral","commit_stats":null,"previous_names":["withcoral/coral"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/withcoral/coral","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/withcoral%2Fcoral","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/withcoral%2Fcoral/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/withcoral%2Fcoral/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/withcoral%2Fcoral/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/withcoral","download_url":"https://codeload.github.com/withcoral/coral/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/withcoral%2Fcoral/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31635969,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T07:40:12.752Z","status":"ssl_error","status_checked_at":"2026-04-10T07:40:11.664Z","response_time":98,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-10T09:00:50.491Z","updated_at":"2026-04-10T09:01:02.182Z","avatar_url":"https://github.com/withcoral.png","language":"Rust","funding_links":[],"categories":["\u003ca name=\"Rust\"\u003e\u003c/a\u003eRust"],"sub_categories":[],"readme":"# Coral\n\nOne SQL interface over APIs, files, and live sources — built for agents.\n\nCoral gives agents a local-first SQL runtime over APIs, files, and other live\nsources. Query it from the CLI, inspect schemas and tables, or expose the same\nruntime over MCP so agents can use it without bespoke tool glue.\n\n\u003e Coral is local-first today: add sources, query them through one runtime, and\n\u003e expose that runtime to agents over MCP. We’re actively expanding the product\n\u003e surface, including additional transports, deployment options, and broader\n\u003e source support.\n\n## Why Coral\n\nMost agent workflows access company data one tool at a time. That works, but it\ntends to create:\n\n- too many tool calls\n- repeated auth, pagination, and retry logic\n- poor cross-source reasoning\n- high token traffic\n- brittle glue code and prompts\n\nCoral gives agents one query interface instead:\n\n- query multiple live sources through SQL\n- keep workflows inspectable and scriptable\n- expose the same runtime over MCP\n- answer cross-source questions without stitching tools together by hand\n\n## What Coral does today\n\n- onboard a local workspace with bundled or imported sources\n- discover bundled sources\n- add or import sources into a local workspace\n- inspect schemas and tables through SQL\n- run SQL queries from the CLI\n- launch a local MCP stdio server for agent workflows\n\n## Quickstart\n\n### 1. Install Coral\n\n```bash\nbrew install withcoral/tap/coral\ncoral --help\n```\n\n### 2. Run onboarding\n\n```bash\ncoral onboard\n```\n\n`coral onboard` guides you through adding or importing a source and validating\nit before you start querying.\n\nIf you prefer the low-level manual flow, you can still run:\n\n```bash\ncoral source discover\ncoral source add github\ncoral source test github\n```\n\n### 3. Inspect available tables\n\nUse `coral.tables` to see what Coral can query:\n\n```bash\ncoral sql \"SELECT * FROM coral.tables LIMIT 20\"\n```\n\n### 4. Run a query\n\nFor example, to inspect recent GitHub releases:\n\n```bash\ncoral sql \"\n  SELECT name, draft, prerelease, published_at\n  FROM github.releases\n  WHERE owner = 'withcoral' AND repo = 'coral'\n  ORDER BY published_at DESC\n  LIMIT 10\n\"\n```\n\nThe exact schemas and tables depend on the sources you have installed. When in\ndoubt, inspect `coral.tables` first.\n\n### 5. Use Coral with an agent\n\nCoral can run as a local MCP server so agents can query your installed sources\nthrough the same runtime.\n\n#### Claude Code\n\n```bash\nclaude mcp add coral -- coral mcp-stdio\n```\n\n#### Codex\n\n```bash\ncodex mcp add coral -- coral mcp-stdio\n```\n\n#### OpenCode\n\nAdd a new MCP app configured to launch Coral with:\n\n```bash\ncoral mcp-stdio\n```\n\n#### Claude Desktop\n\nOpen:\n\n`Settings -\u003e Developer -\u003e Edit Config`\n\nThen add Coral to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"coral\": {\n      \"command\": \"/path/to/coral\",\n      \"args\": [\"mcp-stdio\"]\n    }\n  }\n}\n```\n\nUse the full path to your `coral` binary. Once configured, your agent can use\nCoral over MCP to inspect schemas, list tables, and query the sources installed\nin your local workspace.\n\nCoral also ships a reusable skill for agent workflows:\n\n```bash\nnpx skills add withcoral/skills\n```\n\nFor the full agent setup flow, including MCP examples and skills guidance, see\n[Agent usage](https://withcoral.com/docs/guides/agent-usage).\n\n## Core concepts\n\n### Source\n\nA source is an external system or local dataset that Coral can query, such as\nGitHub, Slack, Stripe, local JSONL files, or Parquet data.\n\n### Table\n\nCoral exposes source data as SQL tables under source-owned schemas.\n\n### Runtime\n\nThe CLI and MCP server use the same underlying runtime.\n\n### Source spec\n\nA source spec is the configuration Coral validates and installs for one source.\nCoral ships bundled source specs and can also import custom ones.\n\n## Local state\n\nCoral stores local state in its platform-specific configuration directory.\n\nYou can override the config directory with:\n\n```bash\nexport CORAL_CONFIG_DIR=/path/to/coral-config\n```\n\nImportant files include:\n\n- `config.toml` for installed-source metadata and non-secret variables\n- installed source specs under `workspaces/\u003cworkspace\u003e/sources/...`\n- source secrets stored separately within the same local trust boundary\n\n## Current focus\n\nCoral is already usable for local agent workflows. We’re currently expanding:\n\n- broader source coverage\n- additional transports and network support\n- richer deployment options\n- smoother setup and ergonomics\n- stronger source authoring and packaging\n\n## Development\n\nRun the workspace validation gate from the repository root:\n\n```bash\nmake validate\n```\n\n## Documentation\n\nFor setup guides, reference docs, and examples, visit\n[withcoral.com/docs](https://withcoral.com/docs).\n\n## Contributing\n\nContributions are welcome, especially bug fixes, tests, documentation\nimprovements, source improvements, and user-facing usability improvements.\n\nPlease read [`CONTRIBUTING.md`](./CONTRIBUTING.md) before opening a pull\nrequest.\n\n## Security\n\nPlease do not report security issues in public issues or pull requests. See\n[`SECURITY.md`](./SECURITY.md).\n\n## Licence\n\nCoral is licensed under the Apache License 2.0. See [`LICENSE`](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwithcoral%2Fcoral","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwithcoral%2Fcoral","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwithcoral%2Fcoral/lists"}