SelectStar is built in the open
We're a small group of engineers who got tired of writing SQL by hand. SelectStar is MIT-licensed, contributor-friendly, and we'd love your help — whether it's a typo fix, a new database parser, or an idea for a whole new agent capability.
Four ways to contribute, ranked by effort
Pick the one that matches your time budget. Even a one-line typo fix helps.
Report a bug
Time: 5–30 min
Open an issue with a reproducible example. Docs typos can be fixed inline on GitHub — no local setup needed.
Open an issueOpen a PR
Time: 1–6 hours
Pick something small, ship a fix. We review PRs within 24 hours and mentor first-time contributors through every step.
Browse issuesAdd a provider
Time: 1–3 days
SelectStar is pluggable. Adding a new datasource (MySQL driver, CockroachDB) or model provider (vLLM, LM Studio) is a self-contained change.
Read the guidePropose a feature
Time: 1–2 weeks
Have an idea for a new agent capability? Open a discussion. We've shipped community-proposed features before.
Start a discussionClone, install, run — in under 2 minutes
SelectStar uses Bun for development. The dev script watches for changes and rebuilds in real time.
# 1. Clone the repo
git clone https://github.com/Shyamnath-Sankar/SelectStar.git
cd SelectStar
# 2. Install dependencies
bun install
# 3. Set up the dev database
cp .env.example .env
# edit .env to point at your Postgres / MySQL / SQLite
# 4. Seed the demo DB & push the Prisma schema
bun run scripts/seed-demo.ts
bun run db:push
# 5. Run the dev server
bun run dev
# Open http://localhost:3000 — type 'demo' — connect
# 6. Run the test suite
bun testBe kind. Be specific. Be welcoming.
SelectStar follows the Contributor Covenant. We have zero tolerance for harassment of any kind. Disagreements are fine — personal attacks are not.
Safe by default
Reports go to a private channel. We take every report seriously.
Mentor-first
First-time contributors get help before their first PR ships.
Credit matters
Every contribution — even a one-line fix — lands in the changelog.
Your first PR could ship this week
Clone the repo, open an issue, or try the live app first. Every contribution matters.