You'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.

Vibecircle 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.

Your friends see it. Your team sees it. A PM can follow a feature from start to ship without asking a single question.

No commit counts. No jargon. Just the story of what's being built.

You code with Claude
        ↓
Plugin detects something worth sharing
        ↓
Claude writes a headline + description (in plain English)
        ↓
You approve → posted to your circle's feed
        ↓
Friends and teammates see it instantly

The plugin is the engine. The feed is the output. You barely have to think about it.

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.

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.

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.

Screenshots — the plugin uses Playwright to capture what you're building. Frontend work gets a screenshot. Backend work gets a richer description instead.

Ambient presence — see who's building right now, who just shipped, who's away.

Reactions & comments — async energy. Fire emoji a friend's deploy. Ask a question about a teammate's feature.

Go to vibecircle.dev and sign in with GitHub.

A circle is a private group — your friend crew, your eng team, your side-project squad.

In Claude Code:

/plugin marketplace add miltonian/vibecircle
/plugin install vibecircle
/circle setup

That's it. The setup page guides you through authorizing the plugin. Takes 10 seconds.

The plugin runs in the background. When it detects something interesting, it'll show you a preview:

vibecircle — Ready to share:

  Redesigned the landing page with warm editorial aesthetic
  Replaced neon gradients with a premium journal feel. Serif headlines,
  copper accents, and floating post cards with warm tones.

  📸 Screenshot attached · Part of "Design Overhaul"

Share this? [Y]es · [E]dit · [S]kip

Press Y. Your circle sees it.

git clone https://github.com/miltonian/vibecircle.git
cd vibecircle
bun install
cp apps/web/.env.example apps/web/.env.local
# fill in env vars (DATABASE_URL, AUTH_SECRET, GITHUB_ID, GITHUB_SECRET)
bun run db:push
bun run seed
bun run dev

See CONTRIBUTING.md for full setup instructions.

Monorepo — apps/web (Next.js) + packages/plugin (Claude Code plugin)

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.

Web — Next.js 16, Drizzle ORM, Neon Postgres, Vercel Blob, Auth.js, SWR polling at 4s intervals.

See docs/specs/design.md for the full design spec.

Next.js 16 · Tailwind CSS · shadcn/ui · Drizzle ORM · Neon Postgres · Auth.js · Vercel Blob · Bun · Turborepo

See CONTRIBUTING.md. PRs welcome.

Open source under MIT License.