Developers

Fork the vibe.

Every capability in the extension ships as a framework-agnostic npm package. MIT. Drop them into Electron, Raycast, Tauri, your own site. Nothing requires vibeclubs.ai.

5 packages·MIT·zero lock-in

@vibeclubs/vibe-mix

Three-layer Web Audio mixer. Ambient + music + page. Framework-agnostic, equal-power faders, duck-on-voice.

import { createMixer } from '@vibeclubs/vibe-mix'

npm →

@vibeclubs/pomodoro-sync

Pomodoro state machine + Supabase Realtime broadcast. Late-joiner ping/pong. No drift.

import { createPomodoro } from '@vibeclubs/pomodoro-sync'

npm →

@vibeclubs/ai-witness

Claude prompt builder for session recaps. Hard-enforces "never interrupt" in the system prompt.

import { witnessPrompt } from '@vibeclubs/ai-witness'

npm →

@vibeclubs/session-card

SVG session card renderer. 1200×630. Deterministic from session data. Brand-locked.

import { renderSessionCardSVG } from '@vibeclubs/session-card'

npm →

@vibeclubs/suno-bridge

Suno API wrapper with royalty-free fallback. Prompt helper reads club genre + time of day.

import { generateMusic } from '@vibeclubs/suno-bridge'

npm →

Quickstart

Three lines. Running mixer.

Any framework, any runtime. The packages use `import` maps instead of framework plugins, so they drop into anything — including Chrome extensions and Node.

Read the source →

quickstart.ts

pnpm add @vibeclubs/vibe-mix @vibeclubs/pomodoro-sync

import { createMixer } from '@vibeclubs/vibe-mix'
import { createPomodoro } from '@vibeclubs/pomodoro-sync'

const mixer = createMixer()
await mixer.loadAmbient('lofi')
mixer.setLevel('ambient', 0.4)

const pomo = createPomodoro({
  clubId: 'lofi-coders',
  preset: '50_10',
})
pomo.start()
pomo.on('complete', (cycle) => console.log('shipped', cycle))

Contribute

Help ship the format.

Read CONTRIBUTING.md for style + the vetoes (no breakout rooms, no host controls, no recording-by-default, no calendar features — these are load-bearing).

good-first-issue →

Why open source

A format has to move.

If the mixer, the sync, and the recap live behind a paywall, they never travel. MIT is the only license that lets the vibeclub format spread into Electron apps, Raycast extensions, ops dashboards, and tools nobody's built yet.