Skip to content
View Zimb's full-sized avatar

Block or report Zimb

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
zimb/readme.md

Zimb(.app) — Bounty debugging for Vibe Coders

Plateforme de bounty debugging reliant les Vibe Coders (juniors boostés à l'IA) à des seniors capables de débloquer les bugs typiques causés par l'IA.


⚡ Try it in 30 seconds

The fastest path to a working @zimb in VS Code. No clone, no build, no Node.js.

# One command — assumes you have VS Code 1.94+ with `code` on your PATH
code --install-extension https://github.com/Zimb/zimb/releases/download/v0.1.0/zimb-vscode-0.1.0.vsix --force

Then in VS Code:

  1. Reload the window — Ctrl/Cmd + Shift + P → "Developer: Reload Window"
  2. Open a folder that's a git clone of a GitHub repo you own (any repo works)
  3. Open Copilot Chat — Ctrl/Cmd + Shift + I
  4. Type: @zimb /bounties — you should see existing bounties (or an empty list)

That's it. The sidebar Zimb icon (left activity bar) shows your bounties + a persistent notifications badge.

No GitHub OAuth? The extension prompts you to sign in when you first use a command that needs it (/post, /status).


🌐 What's actually working today (v0.1.0)

Honest status — what's shipped and what's vapourware.

Capability Status Notes
Issue creation (/redact, /fix, /post) ✅ Works Creates a GitHub issue with a structured body via Octokit
Chat commands (/bounties, /status, /discard) ✅ Works Read-only commands against GitHub
Sidebar (Bounties + Notifications) ✅ Works Tree view + persistent status bar badge
Notifications polling (60s) ✅ Works Detects new comments / claims / status flips
Landing page (zimb.app) 🟡 Code only Not deployed — packages/landing/ is buildable but not live
Senior Kanban (app.zimb.app) 🟡 Code only Not deployed — packages/app-web/ exists but is frozen (see CONCEPT_REVIEW_AND_PIVOT)
@zimb-bot GitHub App claim flow 🟡 Code only The handler exists in packages/worker/ but api.zimb.app is not deployed, so no auto-claim happens today
Stripe Connect escrow 🟡 Code only Stripe pre-auth + capture code exists but no live payments
Airtable ticket mirror 🟡 Code only Worker can read/write Airtable, but the Worker isn't deployed

TL;DR — the only thing that actually works end-to-end today is creating GitHub issues from VS Code. Everything else is code on a shelf waiting for infrastructure.

📦 Monorepo

zimb/
├── packages/
│   ├── extension/   # @zimb/extension — VS Code / Copilot @zimb chat  ✅ ACTIVE
│   ├── worker/      # @zimb/worker — Cloudflare Worker (api.zimb.app) 🟡 code only, not deployed
│   ├── app-web/     # @zimb/app-web — Flutter Web Kanban             🟡 frozen, not deployed
│   └── landing/     # @zimb/landing — Astro landing                   🟡 code only, not deployed
├── SPECIFICATIONS.md # Tech & product spec (exhaustive)
├── docs/
│   └── CHAT_COMMANDS.md  # Slash command reference
├── recettes/         # Gherkin test scenarios
├── FOUNDER_NOTES.md  # Original founder notes
└── .github/
    ├── agents/       # 8 specialised Copilot agents
    ├── ISSUE_TEMPLATE/
    ├── PULL_REQUEST_TEMPLATE.md
    └── workflows/    # CI

🚀 Try it (1 minute, no clone)

See ⚡ Try it in 30 seconds above.

If you want to compose a bounty (not just look at them), the flow is:

  1. @zimb /redact <your problem in plain English or French> [-l en] [-u high] [-b 50] → see a structured preview, nothing posted yet
  2. @zimb /post → publishes the preview to GitHub on your current repo

Try it on a throwaway repo first.


🛠 Dev setup (for contributors)

Only needed if you want to modify the extension or the Worker.

Prerequisites

  • Node.js 20+ (nvm use 20 if you use nvm)
  • npm 10+
  • Git
  • VS Code 1.94+ (for extension development)
  • A GitHub account with a repo you can push to

Clone and build

gh repo clone Zimb/zimb
cd zimb
npm install                # monorepo root
npx turbo run build        # build every package

Run each package in dev mode

npm run dev -w @zimb/worker      # api.zimb.app → http://localhost:8787
npm run dev -w @zimb/landing     # zimb.app → http://localhost:5173

# Extension:
code packages/extension          # opens in a new VS Code window, press F5 to launch the Extension Dev Host

# Flutter Web Kanban:
cd packages/app-web && flutter pub get && flutter run -d chrome

Dev secrets

The Worker needs API keys to talk to Stripe / Airtable / GitHub. For local dev:

cp packages/worker/dev.vars.example packages/worker/.dev.vars
# Edit and fill in:
#   STRIPE_SECRET_KEY (test mode)
#   AIRTABLE_API_KEY
#   GITHUB_APP_ID + GITHUB_PRIVATE_KEY
#   JWT_SECRET

The extension uses VS Code's built-in GitHub authentication — no secrets needed in dev.


🧪 Test the @zimb chat commands

Once installed, try each slash command. See docs/CHAT_COMMANDS.md for the full reference.

Command What it does
@zimb /bounties List bounties in the current repo (read-only)
@zimb /redact <bug> Compose a draft locally, no network call
@zimb /fix <hint> Compose using your chat history as troubleshooting context
@zimb /post Publish the last draft to GitHub
@zimb /discard Throw away the current draft
@zimb /status T-XXXX Check a ticket via api.zimb.app
@zimb /notif Show the notifications poller status

🤖 Agents Copilot spécialisés

Le projet utilise 8 agents custom (.github/agents/) qui orchestrent le travail :

Agent Domaine
Backend Middleware Cloudflare Worker, routes REST, Airtable, Durable Objects
Flutter Web Kanban UI seniors, post-it, Lock & Timer, Match !
Stripe Connect Paiements Escrow, capture, transfer, commission 20 %
GitHub Bot App @zimb-bot, invite/revoke collaborateurs
Litiges & Reviewer SLA 48 h, escalation, verdicts
VS Code Extension Chat participant @zimb, détection langages
QA & Recette 64 scénarios Gherkin, bug reports, MVP gate
Documentation Produit SPECIFICATIONS, CDC, recettes, landing copy

Voir .github/agents/README.md pour les détails.

🧪 Tests & qualité

# Lint + type-check + tests sur tous les packages
npm run lint
npm run type-check
npm test

# Formatage
npm run format

# Audit de la documentation (recettes) — utiliser l'agent QA & Recette

📚 Documentation

Doc Audience Usage
SPECIFICATIONS.md Tech, fondateurs Source de vérité (comment ça marche)
CDC.md Prestataires, direction Cadrage (quoi, quand, combien)
recettes/ QA, devs 64 scénarios E2E (ça marche ?)
.github/agents/ Tous Workflow IA (qui fait quoi)
FOUNDER_NOTES.md Tous Notes originales v0 (intentions brutes)

🔒 Sécurité

Voir SECURITY.md pour signaler une vulnérabilité (security@zimb.app).

  • RGPD : conformes, droit à l'effacement via DELETE /me
  • GitHub access : ephemeral via @zimb-bot (jamais d'accès permanent)

📅 Statut du projet

Phase : préparation / scaffolding
Complétude : ~70 % de la préparation, ~0 % du code en prod
Roadmap : voir SPECIFICATIONS.md §7

📜 Licence

UNLICENSED — proprietary, all rights reserved.

Popular repositories Loading

  1. Job Job Public

    All projects

  2. Scrap Scrap Public

    Product winner, niches, and trends

  3. EduAI EduAI Public

    TypeScript

  4. infinite-Quizz infinite-Quizz Public

    JavaScript

  5. Polyglot Polyglot Public

    JavaScript

  6. Midnight Midnight Public

    C++