{
"markdown": "\n\n# vibecircle\n\n### Vibe coding is the most interesting creative activity happening right now. But it's solo.\n\n**vibecircle makes it social.**\n\nA Claude Code plugin + live feed that shows what your friends and teammates are building — as it happens.\n\n[vibecircle.dev](https://vibecircle.dev) · [Install the Plugin](#install) · [Run it Yourself](#self-host)\n\n
\n\n---\n\n\n\n---\n\n## The idea\n\nYou're building something with Claude Code. Your friend is building something too. Your teammate just shipped. But nobody knows — until a standup, a Slack message, or someone asks.\n\nVibecircle sits in the background. A Claude Code plugin watches your session and detects when something interesting happens — a new UI, a deploy, a big feature landing. It writes a plain-English summary of what you built, shows you a preview, and shares it to your circle if you approve.\n\nYour friends see it. Your team sees it. A PM can follow a feature from start to ship without asking a single question.\n\n**No commit counts. No jargon. Just the story of what's being built.**\n\n---\n\n## How it works\n\n```\nYou code with Claude\n ↓\nPlugin detects something worth sharing\n ↓\nClaude writes a headline + description (in plain English)\n ↓\nYou approve → posted to your circle's feed\n ↓\nFriends and teammates see it instantly\n```\n\nThe plugin is the engine. The feed is the output. You barely have to think about it.\n\n---\n\n## What makes it different\n\n| | Traditional | vibecircle |\n|---|---|---|\n| **How updates happen** | Standups, Slack, \"what are you working on?\" | Automatic — the plugin captures as you build |\n| **Who can read it** | Engineers reading diffs | Anyone — AI writes human-readable descriptions |\n| **Granularity** | End-of-sprint demos | Real-time — see features evolve from WIP to shipped |\n| **Effort** | Write a status update | Approve a preview (or skip it) |\n\n---\n\n## Features\n\n**Smart plugin** — a sentinel watches your session and detects share-worthy moments. First deploy? New UI? Big feature? It proposes sharing. Config changes and dependency updates? It stays quiet. And nothing ever posts without your approval — you always see a preview first.\n\n**AI ghost-writer** — Claude writes every headline and description. \"Built a settings page with dark mode and notification preferences\" — not \"refactored SettingsProvider component tree.\" Written for humans, not machines.\n\n**Narrative arcs** — related posts are grouped into stories. A PM watches \"Payment Integration\" go from Stripe setup → pricing page → subscriptions live, without attending a single meeting.\n\n**Screenshots** — the plugin uses Playwright to capture what you're building. Frontend work gets a screenshot. Backend work gets a richer description instead.\n\n**Ambient presence** — see who's building right now, who just shipped, who's away.\n\n**Reactions & comments** — async energy. Fire emoji a friend's deploy. Ask a question about a teammate's feature.\n\n---\n\n\n\n## Get started\n\n### 1. Sign up\n\nGo to [vibecircle.dev](https://vibecircle.dev) and sign in with GitHub.\n\n### 2. Create a circle\n\nA circle is a private group — your friend crew, your eng team, your side-project squad.\n\n### 3. Install the plugin\n\nIn Claude Code:\n\n```\n/plugin marketplace add miltonian/vibecircle\n/plugin install vibecircle\n/circle setup\n```\n\nThat's it. The setup page guides you through authorizing the plugin. Takes 10 seconds.\n\n### 4. Build something\n\nThe plugin runs in the background. When it detects something interesting, it'll show you a preview:\n\n```\nvibecircle — Ready to share:\n\n Redesigned the landing page with warm editorial aesthetic\n Replaced neon gradients with a premium journal feel. Serif headlines,\n copper accents, and floating post cards with warm tones.\n\n 📸 Screenshot attached · Part of \"Design Overhaul\"\n\nShare this? [Y]es · [E]dit · [S]kip\n```\n\nPress Y. Your circle sees it.\n\n---\n\n\n\n## Run it yourself\n\n```bash\ngit clone https://github.com/miltonian/vibecircle.git\ncd vibecircle\nbun install\ncp apps/web/.env.example apps/web/.env.local\n# fill in env vars (DATABASE_URL, AUTH_SECRET, GITHUB_ID, GITHUB_SECRET)\nbun run db:push\nbun run seed\nbun run dev\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for full setup instructions.\n\n---\n\n## Architecture\n\n**Monorepo** — `apps/web` (Next.js) + `packages/plugin` (Claude Code plugin)\n\n**Plugin** — prompt-based hooks that run inside Claude Code. The sentinel analyzes your session, the ghost-writer drafts posts, the context engine tracks narrative arcs. All AI runs locally in your Claude session — zero cost for vibecircle.\n\n**Web** — Next.js 16, Drizzle ORM, Neon Postgres, Vercel Blob, Auth.js, SWR polling at 4s intervals.\n\nSee [docs/specs/design.md](docs/specs/design.md) for the full design spec.\n\n## Tech stack\n\nNext.js 16 · Tailwind CSS · shadcn/ui · Drizzle ORM · Neon Postgres · Auth.js · Vercel Blob · Bun · Turborepo\n\n---\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md). PRs welcome.\n\nOpen source under [MIT License](LICENSE).\n\n---\n\n\n\nBuilt with [Claude Code](https://claude.ai/code)\n\n
\n",
"bytes": 5171,
"sha": "f35444e838525ab578c8b30eced13bc66299627bcadae6523f71ff761f4993e9",
"repo_slug": "miltonian/vibecircle",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/plg_miltonian_vibecircle_vibecircle_508e62bf/readme"
}