Getting Started

Install Vibehaus, sign in, and run your first project scan.

Vibehaus is a native macOS app that finds the projects you’ve already started, tracks what’s running, and keeps your notes and secrets next to the code they belong to.

Why it matters

Most Macs end up holding 30+ half-finished projects across different stacks. Vibehaus turns that pile into something you can browse, run, and remember without grepping ~/Developer for the right folder.

1. Get the app

Vibehaus is in closed beta. Tap Download for Mac on the home page; if you’re not invited yet, you’ll be added to the waitlist. Once you’re in, the same button hands you the latest DMG.

2. Install

  1. Open the DMG.
  2. Drag Vibehaus.app onto the Applications alias.
  3. Eject the DMG.

The app is signed and notarized by Apple, so Gatekeeper opens it without the “downloaded from the internet” warning on a fresh install.

3. First launch

Open Vibehaus from Spotlight or the Applications folder. macOS will ask whether Vibehaus can read three folders:

  • Documents
  • Desktop
  • Downloads

These are the folders macOS protects most strictly. Granting access lets the project scanner look inside them. Other common project locations (~/Developer, ~/Projects, ~/Sites) need no prompt.

4. Sign in with Apple

Sign in is required for vault, cloud sync, and flow automation. Tap Sign in with Apple on the auth gate. A browser tab opens, you complete the Apple flow, and you’re handed back to the app within a second.

If you’d rather try the app first, you can also start in offline mode (limited to local-only features) and sign in later from Settings → Account.

5. Your first scan

Pick a folder — most people start with ~/Developer or ~/Projects. Vibehaus walks the folder a few levels deep looking for project marker files. Anything it finds becomes a project in the sidebar.

It recognises Swift, Node, TypeScript, Next.js, Nuxt, Vue, Angular, Svelte, Remix, Astro, Vite, Webpack, Rust, Go, Python, Ruby, Java, Kotlin, Flutter, C/C++, Docker, Tailwind, Prisma, and more. If a project matches several stacks (a Next.js app is also TypeScript and Tailwind), all the labels show up on the same project chip.

Next steps