{"id":51320336,"url":"https://github.com/phin-ai/phin","last_synced_at":"2026-07-01T13:00:25.481Z","repository":{"id":366309187,"uuid":"1261943682","full_name":"phin-ai/phin","owner":"phin-ai","description":"Phin — AI-native data workbench for macOS. PostgreSQL, MySQL, SQLite, MongoDB + AI chat. Free public beta.","archived":false,"fork":false,"pushed_at":"2026-06-29T08:55:00.000Z","size":9,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-29T10:07:43.269Z","etag":null,"topics":["ai","ai-agent","chatgpt","claude","database","database-gui","genai","gpt","llm","macos","mongodb","mysql","nl2sql","openai","postgresql","rag","sql","sql-client","sqlite","text-to-sql"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/phin-ai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"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":null,"dco":null,"cla":null}},"created_at":"2026-06-07T11:15:29.000Z","updated_at":"2026-06-29T08:54:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/phin-ai/phin","commit_stats":null,"previous_names":["phin-ai/phin"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/phin-ai/phin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phin-ai%2Fphin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phin-ai%2Fphin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phin-ai%2Fphin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phin-ai%2Fphin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phin-ai","download_url":"https://codeload.github.com/phin-ai/phin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phin-ai%2Fphin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35007278,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-01T02:00:05.325Z","response_time":130,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai","ai-agent","chatgpt","claude","database","database-gui","genai","gpt","llm","macos","mongodb","mysql","nl2sql","openai","postgresql","rag","sql","sql-client","sqlite","text-to-sql"],"created_at":"2026-07-01T13:00:17.010Z","updated_at":"2026-07-01T13:00:25.452Z","avatar_url":"https://github.com/phin-ai.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003ePhin — AI-native data workbench for macOS\u003c/h1\u003e\n  \u003cp\u003e\u003cb\u003eOne desktop app for every database. AI that drips answers from your data.\u003c/b\u003e\u003c/p\u003e\n  \u003cp\u003e\u003cem\u003e/fɪn/ · cà phê phin · ☕\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\nPhin is a native macOS app for working with **PostgreSQL, MySQL, SQLite, and MongoDB** through one warm workbench. Browse schemas, write queries, see results — and chat with an AI that knows your schema, drafts queries, and asks before running anything that writes.\n\n```\n┌────────────────────────────────────────────────────────────────────────┐\n│  Datafabric dev / studio.users                            ⌘B  ⌘J  ⌘,  │\n├────────────────┬───────────────────────────────────────┬────────────────┤\n│  Datafabric    │  SELECT * FROM users                  │  Phin          │\n│  postgres ▾    │  WHERE last_seen \u003e= now() - '7d';     │                │\n│                │  ──────────────────────────────       │  How many      │\n│  SCHEMA  · 268 │   id   │  email     │  plan  │  …    │  pro users     │\n│  ▼ studio      │   8a4  │  m@…       │  pro   │       │  signed up     │\n│    • users     │   8b2  │  k@…       │  free  │       │  this month?   │\n│    • orders    │                                       │                │\n│  ▶ public      │                                       │  Approve ▶ ✓   │\n│  ● 12ms · pg16 │  Data · Structure · Plan              │                │\n└────────────────┴───────────────────────────────────────┴────────────────┘\n```\n\n## Why Phin\n\n- **One app, every database.** Postgres, MySQL, SQLite, MongoDB — same UI, same chat, same approval flow.\n- **Chat that knows your schema.** Pin tables with `@-mentions` — drill into columns with `@table.`. Phin writes against the columns you actually have, not the columns it guessed. Bring your own key — Anthropic, OpenAI, Gemini, or OpenRouter (300+ models).\n- **Use it from Claude Code.** Phin ships a local connector so you can explore your saved connections from Claude Code — list connections, browse schemas, preview tables, and run read-only SQL or MongoDB queries. Read-only by default; passwords never leave your Keychain. One-click setup in **Settings → Claude Code**.\n- **Safety floor for writes.** Reads can auto-approve; writes and schema changes always need explicit approval. Production-tagged connections refuse `DROP TABLE` / `TRUNCATE` regardless.\n- **Passwords stay on your Mac.** Saved to the macOS Keychain. Never written to disk in plaintext, never sent to the AI.\n- **Native macOS feel.** Vibrancy throughout, Spotlight-style command palette, sheets, warm cà phê sữa theme.\n\n## Download\n\n**[⬇︎ Download the latest release](https://github.com/phin-ai/phin/releases/latest)** — a universal macOS app (Apple Silicon + Intel), ~75 MB, self-contained.\n\n1. Download **`Phin-\u003cversion\u003e-macOS.zip`** and unzip it.\n2. Drag **Phin** into your **Applications** folder.\n3. **First open.** Phin isn't notarized yet, so macOS blocks it once with *\"Apple could not verify 'Phin' is free of malware…\"*. To approve it, either:\n   - **Settings:** double-click Phin → click **Done** → open **System Settings → Privacy \u0026 Security**, scroll to **Security**, and click **Open Anyway** next to the Phin notice. Confirm — Phin launches and opens normally from then on. **or**\n   - **Terminal (faster):** clear the download-quarantine flag once, then open Phin normally:\n     ```bash\n     xattr -dr com.apple.quarantine /Applications/Phin.app\n     ```\n\n\u003e **Beta note.** Phin is in **free public beta**. AI chat in this build is enabled **through 30 September 2026**; the rest of the app keeps working after that. New builds will extend it.\n\n## First run\n\n1. **Connect.** Welcome screen → **New connection**. Pick your database, enter host / user / password. The password goes straight to your Keychain.\n2. **Browse.** Sidebar shows your schemas / collections. Click a table to preview rows.\n3. **Query.** Write SQL in the editor (`⌘⏎` runs the statement at the cursor). Results land in a virtualized grid.\n4. **Chat.** Open the AI panel (`⌘J`). Add your LLM API key in **Settings → Ask Phin** (Anthropic, OpenAI, Gemini, or OpenRouter). Ask a question — Phin drafts a query and asks before running it.\n\n## Supported databases\n\n| Engine | Status |\n|---|---|\n| PostgreSQL | ✅ Full support |\n| MySQL | ✅ Full support |\n| SQLite | ✅ Full support |\n| MongoDB | ✅ Full support |\n\n## Use with Claude Code\n\nPhin ships a local connector (an MCP server) that lets **Claude Code** explore the databases you've already connected in Phin — list connections, browse schemas, describe \u0026 preview tables, and run **read-only** SQL or MongoDB queries. Writes are refused, and your passwords stay in the macOS Keychain — they're never sent to the model.\n\nPick whichever setup you prefer:\n\n**Option A — one click (easiest).** In Phin, open **Settings → Claude Code** and click **Install**. Phin registers the bundled connector with Claude Code for you. (If Claude Code's CLI isn't found, the screen shows the exact command to copy.)\n\n**Option B — one command.** Register it yourself:\n```bash\nclaude mcp add -s user phin -- /Applications/Phin.app/Contents/MacOS/phin-mcp --stdio\n```\n\n**Option C — Claude Code plugin marketplace.** Inside Claude Code, add the Phin marketplace once, then install the plugin:\n```\n/plugin marketplace add phin-ai/phin-plugins\n/plugin install phin-mcp@phin-official\n```\n\nThen, in Claude Code, just ask about your data — e.g. *\"using phin, list my connections\"* or *\"preview the users table on my staging Postgres.\"*\n\n## Keyboard shortcuts\n\n| | |\n|---|---|\n| `⌘⏎` | Run statement at cursor |\n| `⌘P` | Command palette (tables / chats / recent queries / connections) |\n| `⌘J` | Toggle chat panel |\n| `⌘B` | Toggle sidebar |\n| `⌘N` | New connection |\n| `⌘,` | Settings |\n| `⌘L` | Add selection to chat |\n| `⌘C` | Copy selected rows as TSV |\n| `⌘/` | Search all shortcuts |\n\nFull shortcut list lives in **Settings → Shortcuts**.\n\n## Feedback\n\nPhin is in active development and feedback shapes what ships next. Found a bug, want a feature, or hit something confusing?\n\n**[→ Open an issue](https://github.com/phin-ai/phin/issues/new)**\n\nEvery report is read. Thank you for trying Phin. 🙏\n\n## Changelog\n\nSee [CHANGELOG.md](CHANGELOG.md) for what's new in each release.\n\n## License\n\nPhin is currently in **free public beta**. © 2026 Phin AI. All rights reserved. The application is free to use during the beta period; the source is not currently public.\n\n\u003cdiv align=\"center\"\u003e\u003csub\u003eSlow-brewed for your data. One steady drip at a time. ☕\u003c/sub\u003e\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphin-ai%2Fphin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphin-ai%2Fphin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphin-ai%2Fphin/lists"}