# Vibewright

> Source: <https://github.com/neodk2004/vibewright/>
> Published: 2026-10-30 11:29:38+00:00

**You vibe. It builds.**

Turn a one-line idea into a complete project roadmap – and build it with Claude Code, right inside the app.

You have an idea. Maybe a bird house camera, a podcast, a home server. Getting from *"I'd like to…"* to *"it works"* usually means juggling chats, notes, half-finished plans and forgotten next steps.

Vibewright is a desktop app for Windows and macOS that does the project management for you. You type one sentence; Vibewright interviews you, writes a needs analysis, cuts the goal into phases, checks which tools you and Claude need – and then lets you build it step by step with **Claude Code running inside the app**. You stay the decision maker: you click, approve and tick off. Claude does the heavy lifting in the background.

```
Idea ──► Interview ──► Needs analysis ──► Plan ──► Tool check ──► Build
          (clicks)      🚦 approve        🚦 approve  🚦 approve     Claude Code in the app
```

- **Guided interview** – one multiple-choice question per screen (keys 1–4), with your own answer as an option. Two short rounds, follow-up questions only where answers leave gaps.
- **Needs analysis** – goal, scope, must-have / could-have / non-goals, risks you didn't think of, and a feasibility traffic light.
- **Plan as a roadmap** – 3–6 phases with goals, "done when" criteria and concrete steps in plain language (no unexplained commands).
- **Tool check** – inspects your PC and your Claude setup (plugins, skills, MCP servers, operating system) and recommends only what a phase really needs, from official sources. Nothing gets installed without your OK.
- **Cockpit** – the current phase with its checklist, progress, next step and all phases at a glance.
- **Claude Code inside the app** – an embedded terminal runs Claude Code with a generated`CLAUDE.md` that knows your project, phase and next step. Claude ticks off finished steps; the checklist updates live.
- **"I just had another idea"** – type a thought any time; Claude sorts it into the right phase (or creates a new one). While Claude is working, the idea waits until the current step is done.
- **Your notes, your format** – everything is written as Markdown into your**Obsidian** vault (with Dataview tables and Kanban if you use them) or locally as`.md` + an`.html` dashboard.
- **Git safety net (optional)** – the code folder becomes a Git project and Claude commits after every finished step, so you can always go back.
- **English & German** – UI, Claude's texts and the generated files. The language is fixed per project.
- **Easy on your limits** – planning calls run Claude Code headless without tools and with a short system prompt (~1,000 input tokens per call instead of ~15,000–20,000).

| Interview | Needs analysis | 
|---|---|
| **Plan** | **Tool check** | 
| **Claude Code inside the app** | **Settings** | 
| **While Claude thinks** | **Light mode** | 

- 📖 [Wiki manual (English)](https://github.com/neodk2004/vibewright/wiki/Home-English) ·[Handbuch (Deutsch)](https://github.com/neodk2004/vibewright/wiki) – one page per chapter, with screenshots
- 📘 [User guide](https://github.com/neodk2004/vibewright/blob/main/docs/user-guide.md) – everything from the first start to a finished project
- 📗 [Anleitung (Deutsch)](https://github.com/neodk2004/vibewright/blob/main/docs/anleitung.md)
- 🛠️ [Developer guide](https://github.com/neodk2004/vibewright/blob/main/docs/developer-guide.md) – architecture, Claude calls, tests, building
- 📜 [Third-party notices](https://github.com/neodk2004/vibewright/blob/main/THIRD_PARTY_NOTICES.md) – all libraries and tools with versions and licenses
- 🤝 [Contributing](https://github.com/neodk2004/vibewright/blob/main/CONTRIBUTING.md) ·[Code of Conduct](https://github.com/neodk2004/vibewright/blob/main/CODE_OF_CONDUCT.md) ·[Security policy](https://github.com/neodk2004/vibewright/blob/main/SECURITY.md)

| **Windows 10 or 11** (64-bit)**or macOS 11 Big Sur or later** | Mac: Apple Silicon (M1–M4) and Intel are both supported | 
| **Claude Code** | installed and signed in – [official setup guide](https://docs.claude.com/en/docs/claude-code/setup) . Native installer and npm installation are both supported. | 
| **Claude subscription** | Pro or Max recommended. Signing in with an API key works too, but then every call is billed separately. | 
| Obsidian *(optional)* | [obsidian.md](https://obsidian.md) – with the community plugins*Dataview* and*Kanban* for live tables and a project board. Without Obsidian, Vibewright saves`.md` files plus an`.html` dashboard. | 
| Git *(optional)* | [git-scm.com](https://git-scm.com/downloads) – for the automatic commit-per-step safety net. | 

1. Download **`Vibewright.Setup.x.y.z.exe`** from the[Releases](https://github.com/neodk2004/vibewright/releases) page.*Optional but recommended:*[verify the download](#verify-your-download) .
2. Run it and choose an installation folder.
The installer is not code-signed yet, so Windows SmartScreen may warn you. Click **More info → Run anyway** .
3. Start Vibewright. On first launch it checks Claude Code, lets you sign in and asks where your projects should live.

1. 
Download the file for your Mac from the [latest release](https://github.com/neodk2004/vibewright/releases/latest) :
  - **Apple Silicon** (M1, M2, M3, M4 …):`Vibewright-x.y.z-mac-arm64.dmg`
  - **Intel** :`Vibewright-x.y.z-mac-x64.dmg`
 Not sure? Apple menu → *About This Mac* → "Chip" (Apple M…) or "Processor" (Intel).
2. 
Open the `.dmg` and drag**Vibewright** into**Applications** .
3. 
Start Vibewright from *Applications* . The app is**signed with an Apple Developer ID and notarized by Apple** , so macOS opens it without warnings.

Every release lists the **SHA-256 checksum** of the installer in its release notes and in an attached `SHA256SUMS.txt` (GitHub also shows it next to the file). Inside your download folder:

```
# Windows (PowerShell)
(Get-FileHash .\Vibewright.Setup.0.2.4.exe -Algorithm SHA256).Hash
# macOS (Terminal)
shasum -a 256 Vibewright-0.2.4-mac-arm64.dmg
```

If the output matches the published value, your file is exactly the released one.

Every installer is also **scanned by VirusTotal** (around 70 antivirus engines) with the public workflow [`.github/workflows/virustotal.yml`](https://github.com/neodk2004/vibewright/blob/main/.github/workflows/virustotal.yml). The result and a link to the full report are added to the release notes; the badge at the top shows the latest result. Prefer to check the code yourself? [Run from source](#run-from-source) or build the installer with `npm run exe`.

```
git clone https://github.com/neodk2004/vibewright.git
cd vibewright/app
npm install
npm start            # starts the app
npm test             # end-to-end test with real Claude calls (uses a bit of your limit)
npm run exe          # builds the Windows installer into app/dist/
npm run exe:mac      # builds the Mac app (on a Mac) into app/dist/
```

- **Electron 42:** updated from Electron 33 to 42.11.18. This closes more than 40 known security issues in Electron (sandbox and context-isolation bypasses, use-after-free bugs, compromised eMudhra certificates and more).
- **Installer tools updated:** electron-builder 26.18 with fixed versions of`tar` ,`app-builder-lib` and`builder-util-runtime` .

- **Stuck at step 2 (needs analysis):** with a long project idea, the main area grew wider than the window, so the right column and the*Looks good* button were cut off. The idea in the header is now shortened with "…" and everything fits in the window again.

### [0.2.2](https://github.com/neodk2004/vibewright/releases/tag/v0.2.2) – 2026-10-26

- **Tool check – more sources:** besides the official catalog, Vibewright now uses every plugin marketplace you have added to Claude Code and the[claude-skills](https://github.com/alirezarezvani/claude-skills) catalog (even if you have not added it yet).
- **Tool check – ready-made skills from [SkillsMP](https://skillsmp.com):** if no catalog fits, Vibewright searches SkillsMP. Only Claude-compatible skills from GitHub repositories with at least 50,000 stars are considered, and Claude picks one only if it really fits. SkillsMP only receives 1–3 English keywords, never your idea or plan.
- **Tool check – link check:** suggested download pages are opened once; dead links are replaced with the maker's current page or marked with ⚠.
- **Report a bug from the app:*** Settings → Report a bug* opens the GitHub form with version, system and storage already filled in. New reports get a friendly reply and are sorted automatically; outdated versions get a hint to update first.
- **Windows installer in the Vibewright look:** welcome page with the Vibewright sidebar, logo header on every page, German or English depending on your Windows language.

- *Settings → User guide* now opens the manual in the wiki.
- The tool check now also counts skills inside installed plugins and skills in the project's code folder as available, and notices switched-off plugins.

- The settings page showed version 0.2.0 regardless of the installed version.

```
┌──────────── Vibewright (Electron) ────────────┐
│  UI ──► core.js (state machine, files)        │
│           │                                   │
│           ├─► claude -p --json-schema …        │  planning: headless, no tools,
│           │     (structured JSON answers)     │  own short system prompt
│           │                                   │
│           └─► node-pty ──► claude (interactive)│  building: embedded terminal
│                    ▲            │             │  (xterm.js)
│                    └─ CLAUDE.md ┘             │
└──────────────┬───────────────────────────────┘
               ▼
   Your vault / folder: Dashboard · Tasks · Plan · Needs analysis · Tool check
```

- Claude only returns **structured JSON** ; Vibewright writes all files itself – Claude never needs write access for planning.
- Progress lives in the **task files** . Whether you tick a box in Vibewright, in Obsidian, or Claude ticks it while building – the app reads it back and updates progress, next step and dashboard.
- Each project keeps its state in `projekthelper-state.json` , so you can pause for weeks and pick up exactly where you left off.

- Vibewright itself sends **no telemetry** and stores its settings only on your PC (`%APPDATA%` ).
- **Tool check:** while checking tools, Vibewright fetches the[claude-skills](https://github.com/alirezarezvani/claude-skills) plugin catalog from GitHub, sends 1–3 English keywords per missing skill to the[SkillsMP](https://skillsmp.com) search (never your idea or plan text), reads candidate`SKILL.md` files from GitHub and opens the suggested download pages once to check they exist.
- **Update check:** once per start, Vibewright asks the public GitHub API for the newest release (`api.github.com/repos/neodk2004/vibewright/releases/latest` ). No project data is sent – GitHub only sees an ordinary web request.
- What you plan with Claude (your idea, answers, plan, a list of installed Claude plugins/skills and your operating system for the tool check) is sent to Anthropic through Claude Code – exactly like any other Claude Code usage.
- If you push a project to GitHub, the Git commits contain the name and email from your Git config. Use GitHub's `noreply` address if you don't want your email to be public.

```
app/
  main.js        Electron main process: windows, settings, embedded terminal (node-pty)
  core.js        Planning flow, Claude calls, file generation, progress
  renderer.js    User interface
  i18n.js        English UI layer
  style.css      Design, animations, compact mode for small screens
  splash.html    Splash screen
  assets/        Runtime icons
  build/         Icon source (icon.svg) and build resources
  test/          End-to-end and installation tests
docs/            README images
```

Vibewright macht aus einer einzeiligen Idee eine fertige Laufkarte: Interview → Bedarfsanalyse → Plan → Werkzeug-Check → Umsetzung. Umgesetzt wird mit Claude Code direkt in der App, du entscheidest nur noch an den Freigaben. Die Ablage erfolgt in Obsidian oder lokal als Markdown. Die Oberfläche lässt sich in der Seitenleiste oder in den Einstellungen per Flagge zwischen Deutsch und Englisch umschalten. Voraussetzungen und Installation: siehe oben.

Vibewright stands on the shoulders of a few open-source projects – [Electron](https://www.electronjs.org), [xterm.js](https://xtermjs.org) and [node-pty](https://github.com/microsoft/node-pty) (via [@lydell/node-pty](https://github.com/lydell/node-pty)) – all MIT-licensed. Full details, versions and license texts: [THIRD_PARTY_NOTICES.md](https://github.com/neodk2004/vibewright/blob/main/THIRD_PARTY_NOTICES.md).

Vibewright was developed with the help of **Claude Code**. All code was reviewed and tested and is published by the author under the MIT license.

Vibewright is an independent open-source project and is **not affiliated with, endorsed by or sponsored by Anthropic**. *Claude* and *Claude Code* are trademarks of Anthropic, PBC. Vibewright simply uses the Claude Code CLI that you install and sign in to yourself.