Describe a workflow. Get a verified, reusable AI skill. Installed. Executed. Permanent.
"Most coding assistants give you snippets. VibeForge creates tools — on demand — and installs them into your repo."
💬 You type: "Create /fix-ci that runs tests, finds failures, patches the code,
reruns tests, and summarizes the root cause"
⚡ VibeForge: Context Analysis → SkillSpec (JSON) → Skill Folder → Install → Execute → ✅ Green
| Step | What Happens | Time |
|---|---|---|
| 💬 | Type your requested workflow based on codebase context | 5s |
| 📋 | VibeForge generates a strict JSON SkillSpec via Mistral Large 3 | ~3s |
| 📁 | Codestral produces a full Agent Skill folder (SKILL.md + Scripts + Tests) | ~5s |
| 📦 | Skill is installed into .vibe/skills/ — Vibe-compatible, versionable |
instant |
| Skill executes in a sandboxed runner: finds bug → patches → reruns tests | ~10s | |
| ✅ | Tests go green. Results summarized. Skill is now reusable by your whole team. | done! |
The "wow" isn't the patch — it's that the agent created a reusable automation skill, not a one-off completion.
|
|
┌─────────────────────────────────┐
│ 🔍 Codebase Analyzer │
│ Reads file structure & TODOs │
└──────────────┬──────────────────┘
│
┌──────────────▼──────────────────┐
│ 📋 SkillSpec Generator │
│ Mistral Large 3 + JSON Schema │
│ Strict structured output │
└──────────────┬──────────────────┘
│
┌──────────────▼──────────────────┐
│ 🔮 Skill Code Generator │
│ Codestral / Devstral │
│ → SKILL.md + scripts + tests │
└──────────────┬──────────────────┘
│
┌──────────────▼──────────────────┐
│ 📦 Install to .vibe/skills/ │
│ Vibe-compatible discovery path │
└──────────────┬──────────────────┘
│
┌──────────────▼──────────────────┐
│ ▶️ Sandbox Runner │
│ Timeout · DRY_RUN · Secret Mask │
│ Step-by-step log capture │
└─────────────────────────────────┘
vibeforge/
├── apps/
│ ├── web/ # React + Vite frontend (port 5173)
│ │ └── src/
│ │ ├── App.jsx # 3-panel UI: Context | Preview | Pipeline
│ │ └── index.css # Premium dark theme with glowing magic UI
│ └── api/ # Express.js backend (port 3001)
│ ├── server.js # API server entry point
│ ├── routes/sessions.js # Full pipeline endpoints
│ └── lib/
│ ├── mistral.js # Mistral Large 3 + Codestral clients
│ ├── runner.js # Sandbox executor (timeout, secrets, DRY_RUN)
│ ├── skillspec-schema.js # SkillSpec JSON schema + Ajv validator
│ └── golden-paths.js # Prebaked /feature, /fix-ci and /ship-demo skills
├── demo-repo/ # Test repo with intentional bug
...
| Layer | Technology | Purpose |
|---|---|---|
| 🔍 Context Analyzer | Mistral Large 3 | Reads repository metadata to suggest missing features |
| 📋 SkillSpec | Mistral Large 3 | Structured JSON output via json_object response format |
| 🔮 Code Gen | Codestral | Multi-file Python skill code generation |
| Node.js / Python Sandbox | Subprocess with timeout, DRY_RUN, secret masking | |
| 🎨 Frontend | React + Vite | 3-panel dark UI with glassmorphism |
| 🔧 Backend | Express.js | REST API with session state management |
| ✅ Validation | Ajv JSON Schema | Strict SkillSpec enforcement — no free-form ambiguity |
- Node.js 18+
- Python 3.8+
- Mistral API Key → Get one here
git clone https://github.com/dataanalystram/mistralhackthon.git
cd mistralhackthon/vibeforge
# Install API dependencies
cd apps/api && npm install
# Install Web dependencies
cd ../web && npm install# Copy the example env and add your Mistral API key
cp .env.example .env
# Edit .env → set MISTRAL_API_KEY=your_key_here# Terminal 1: Start API server
cd apps/api && node server.js
# → 🔥 VibeForge API running on http://localhost:3001
# Terminal 2: Start Web UI
cd apps/web && npx vite --host
# → VITE ready on http://localhost:5173Open http://localhost:5173 and follow the prompt suggestions!
| Method | Endpoint | Description |
|---|---|---|
POST |
/api/analyze-repo |
Extract repo context and get Mistral suggestions |
POST |
/api/sessions |
Create a new skill generation session |
POST |
/api/sessions/:id/skillspec |
Generate SkillSpec via Mistral Large 3 |
POST |
/api/sessions/:id/skill/generate |
Generate skill folder via Codestral |
POST |
/api/sessions/:id/skill/install |
Install skill to target repository folder |
POST |
/api/sessions/:id/skill/run |
Execute Python skill safely in sandbox |
GET |
/api/health |
Diagnostic status of the API |
| Feature | Description |
|---|---|
| Tool Allowlist | Every skill declares which tools it can use in SKILL.md |
| Path Restrictions | Explicit read/write roots + deny globs (.env, .ssh/, etc.) |
| Confirmation Gates | Risky steps require explicit user approval in the CLI |
| DRY_RUN Mode | Preview all Python sandbox commands without executing |
| Secret Masking | API keys, tokens, and passwords auto-redacted from logs |
| Timeout Enforcement | 60s per step, 300s total — no runaway processes |
Scans git history → checks for TODOs → inspects file tree → synthesizes AI recommendations for your next immediate MVP features to build!
Runs
npm test→ identifies failures → patches buggy code → reruns tests → summary (The demo repo includes an intentional bug for it to catch!)
Runs tests → gathers
git log→ generates formatted release notes ready to present.
"Stop re-prompting. Start forging skills."
⚡ VibeForge — Built by Ramprasad Somaraju for the Mistral Worldwide Hackathon 2026 ⚡