{"id":47715802,"url":"https://github.com/wordbricks/onequery","last_synced_at":"2026-04-26T09:03:22.407Z","repository":{"id":347931948,"uuid":"1195711958","full_name":"wordbricks/onequery","owner":"wordbricks","description":"One interface for your whole data stack, with built-in safeguards and a simpler workflow for your team. Written in Rust.","archived":false,"fork":false,"pushed_at":"2026-04-22T06:03:12.000Z","size":9118,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-22T08:03:15.678Z","etag":null,"topics":["agent","ai","ai-agents","anthropic","chatgpt","claude","claude-code","cli","codex","hermes","llm","openai","openclaw","rust","self-hosted"],"latest_commit_sha":null,"homepage":"https://onequery.dev","language":"TypeScript","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/wordbricks.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"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-03-30T01:42:18.000Z","updated_at":"2026-04-22T05:54:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"06d55fcf-a66e-4030-8f25-4e65ff705d32","html_url":"https://github.com/wordbricks/onequery","commit_stats":null,"previous_names":["wordbricks/onequery"],"tags_count":41,"template":false,"template_full_name":null,"purl":"pkg:github/wordbricks/onequery","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wordbricks%2Fonequery","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wordbricks%2Fonequery/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wordbricks%2Fonequery/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wordbricks%2Fonequery/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wordbricks","download_url":"https://codeload.github.com/wordbricks/onequery/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wordbricks%2Fonequery/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32291347,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T08:29:33.829Z","status":"ssl_error","status_checked_at":"2026-04-26T08:29:18.366Z","response_time":129,"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":["agent","ai","ai-agents","anthropic","chatgpt","claude","claude-code","cli","codex","hermes","llm","openai","openclaw","rust","self-hosted"],"created_at":"2026-04-02T18:56:19.858Z","updated_at":"2026-04-26T09:03:22.402Z","avatar_url":"https://github.com/wordbricks.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OneQuery\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"./README.md\"\u003eEnglish\u003c/a\u003e | \u003ca href=\"./README.zh-CN.md\"\u003e中文\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://onequery.dev\"\u003e\u003cimg src=\"https://img.shields.io/badge/Site-onequery.dev-blue?style=for-the-badge\" alt=\"Site\"\u003e\u003c/a\u003e\n  \u003ca href=\"./LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-Apache%202.0-green?style=for-the-badge\" alt=\"License: Apache 2.0\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n**Self-host OneQuery to connect databases, analytics tools, and APIs, manage credentials centrally, and run safe, auditable queries from a CLI and web UI.**\n\nOne interface for your whole data stack, with built-in safeguards and a simpler workflow for your team.\n\n---\n\n## Features\n\n| | Self-Host | Cloud / Enterprise |\n|---|---|---|\n| **Safe querying** | Read-only validation, single-statement enforcement | ✓ |\n| **Query cost limit** | Budget caps for BigQuery, Athena, etc. | ✓ |\n| **Audit log** | Full query history and tracking | ✓ |\n| **Auth / Org / RBAC** | Organization-level access control | SSO, SAML |\n| **Connection vault** | Centralized credential management | ✓ |\n| **Connectors** | 15+ sources | ✓ |\n| **NL → SQL** | — | ✓ |\n| **Insights** | — | ✓ |\n| **SLA / Compliance** | — | ✓ |\n\n---\n\n## Quick Install\n\n```bash\ncurl -fsSL https://onequery.dev/install.sh | sh\n```\n\nOr use a package manager:\n\n```bash\nbrew install wordbricks/tap/onequery    # Homebrew\nnpm install -g @onequery/cli            # npm\nbun add -g @onequery/cli                # Bun\n```\n\nWithout a global install: `npx @onequery/cli --help` or `bunx @onequery/cli --help`.\n\n---\n\n## Getting Started\n\n### Option A: Self-host (run your own server)\n\n```bash\nonequery gateway start\nonequery auth login\n```\n\nAdd a source and run a query:\n\n```bash\nonequery source connect --source postgres \\\n  --input '{\"name\":\"warehouse\",\"credentials\":{\"host\":\"db.example.com\",\"database\":\"app\",\"username\":\"onequery\",\"password\":\"secret\"}}'\nonequery query execute --source warehouse --sql \"select 1\"\n```\n\n### Option B: Connect to an existing server\n\n```bash\nonequery config set server https://onequery.example.com\nonequery auth login\nonequery source list\nonequery query execute --source \u003csource-key\u003e --sql \"select 1\"\n```\n\n---\n\n## Supported Sources\n\nPostgreSQL · Supabase · MySQL · MongoDB · BigQuery · AWS Athena · Google Analytics · Amplitude · Mixpanel · PostHog · Sentry · GitHub · Linear · Laminar\n\nRun `onequery source connect --help` for provider-specific setup.\n\n---\n\n## Documentation\n\n| Document | Description |\n|----------|-------------|\n| [Self-Hosting Guide](./docs/self-host.md) | Install, proxy, SMTP, storage, backup, restore, upgrade |\n| [Architecture](./docs/architecture.md) | System design, monorepo structure, runtime surfaces |\n| [CLI Reference](./apps/cli/README.md) | CLI workspace, config, and runtime behavior |\n| [Env \u0026 Secrets](./docs/env-secrets-management.md) | Managed local config flow for the web/server workspace |\n\n---\n\n## Claude Code Plugin\n\nThe `onequery` Claude Code plugin ships from the Wordbricks marketplace:\n\n```bash\n/plugin marketplace add wordbricks/skills\n/plugin install onequery@wordbricks\n```\n\nFor skills-compatible agents, install the `onequery-cli` skill:\n\n```bash\nnpx skills add https://github.com/wordbricks/skills --skill onequery-cli -y\n```\n\n## OpenClaw Plugin\n\nFrom npm:\n\n```bash\nopenclaw plugins install @onequery/openclaw-plugin\nopenclaw plugins enable onequery\n```\n\nFrom a checkout of this repository:\n\n```bash\nopenclaw plugins install -l ./packages/openclaw-plugin\nopenclaw plugins enable onequery\n```\n\nThen enable the plugin in `openclaw.json`:\n\n```json5\n{\n  plugins: {\n    entries: {\n      onequery: { enabled: true },\n    },\n  }\n}\n```\n\n## Hermes\n\nFor plugin-free Hermes Agent usage, install the standalone `onequery-cli`\nskill:\n\n```bash\nhermes skills install skills-sh/wordbricks/skills/onequery-cli --yes --force\n```\n\nThen start Hermes with the skill preloaded:\n\n```bash\nhermes chat --skills onequery-cli\n```\n\nOr load it inside an existing Hermes session:\n\n```text\nLoad skill onequery-cli.\n```\n\n---\n\n## Built With\n\nTwo libraries that make OneQuery more reliable:\n\n- [better-result](https://github.com/dmmulroy/better-result): Forces every failure to be handled explicitly, so errors never silently slip through.\n- [antiox](https://github.com/rivet-dev/antiox): Keeps concurrent queries, timeouts, and cancellations predictable, with no leaked tasks or hanging connections.\n\n---\n\n## Contributing\n\nWe welcome data source integration contributions. See [CONTRIBUTING.md](./CONTRIBUTING.md) for structure and PR process.\n\n---\n\n## License\n\nApache 2.0. See [LICENSE](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwordbricks%2Fonequery","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwordbricks%2Fonequery","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwordbricks%2Fonequery/lists"}