Development

​

Prerequisites

• Bun — worker runtime and build tool
• Node.js 18+ — for npm tooling
• Git

​

Build from Source

git clone https://github.com/anergcorp/vibelearn.git
cd vibelearn
npm install
npm run build-and-sync

1. Compiles TypeScript hooks → ESM scripts → bundles with esbuild
2. Bundles worker-service.cjs (~1.7MB)
3. Bundles vl-cli.cjs (~10KB)
4. Syncs built artifacts to ~/.claude/plugins/marketplaces/vibelearn/
5. Restarts the worker

​

Build Artifacts

​

Development Workflow

# Make changes to src/

# Rebuild hooks only (fast)
bun scripts/build-hooks.js

# Full build + restart worker
npm run build-and-sync

# Watch worker logs
tail -f ~/.vibelearn/logs/vibelearn-$(date +%Y-%m-%d).log

​

Adding a New Analysis Step

1. Create src/services/analysis/MyAnalyzer.ts
2. Add a new route in src/services/worker/http/routes/VibeLearnRoutes.ts
3. Call it from src/hooks/summarize.ts (the Stop hook dispatcher)
4. Add any new columns to src/services/sqlite/migrations.ts (increment migration ID)

​

Adding a New vl CLI Command

async function cmdMyCommand() {
  const db = new Database(`${homedir()}/.vibelearn/vibelearn.db`);
  const rows = db.query('SELECT * FROM vl_concepts LIMIT 10').all();
  // ...
}

​

Database Migrations

{ id: 9, sql: `ALTER TABLE vl_concepts ADD COLUMN my_new_column TEXT` }

​

Code Style

• TypeScript strict mode
• ESM modules throughout (import/export, no require)
• Hooks: always exit 0 (never block the IDE)
• Worker errors: log at ERROR level, continue execution
• Analysis steps: independent — step failure must not block subsequent steps

​

Testing

# Test session init
curl -X POST http://127.0.0.1:37778/api/sessions/init \
  -H "Content-Type: application/json" \
  -d '{"contentSessionId":"test-123","project":"test","prompt":"test"}'

# Test health
curl http://127.0.0.1:37778/api/health | jq .

​

Publishing

npm run build-and-sync
# Artifacts in plugin/ are ready to publish to the marketplace