Skip to content

ravisojitra/vibex-desktop-v2

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VibeX

AI-powered desktop IDE that uses agents to build software projects. Point it at an idea, and VibeX writes the code, sets up the database, runs the dev server, and previews the result — all from one window.

Build web apps

VibeX building a web app — agent writes code, live preview on the right

Build mobile apps

VibeX building a mobile app — agent codes while Expo preview runs on device

Features

  • AI Agent Loop — Uses Claude Agent SDK and OpenAI Codex SDK to go from prompt to working code
  • Integrated IDE — Monaco editor, file tree, and live preview in a single workspace
  • Supabase Integration — Auto-provisions cloud databases, runs migrations, generates TypeScript types
  • Dev Server — Built-in dev server management with log streaming
  • Real-time Streaming — Watch the agent think and write code in real time
  • Cross-platform — macOS, Windows, and Linux

Prerequisites

Setup

  1. Clone the repository:
git clone https://github.com/ravisojitra/vibex-v2.git
cd vibex-v2
  1. Install dependencies:
npm install
  1. Copy the example environment file and fill in your keys:
cp .env.example .env

Required environment variables:

Variable Description
ANTHROPIC_API_KEY Your Anthropic API key for Claude
OPENAI_API_KEY Your OpenAI API key for Codex
SUPABASE_MANAGEMENT_API_TOKEN Supabase Management API token (optional, for cloud DB provisioning)
SUPABASE_PLATFORM_ORG_ID Supabase organization ID (optional, for cloud DB provisioning)
  1. Start the app in development mode:
npm run dev

Scripts

Command Description
npm run dev Start Electron app in dev mode with HMR
npm run build Typecheck and build for production
npm run build:mac Build and package for macOS
npm run build:win Build and package for Windows
npm run build:linux Build and package for Linux
npm run lint Run ESLint
npm run typecheck Run TypeScript type checking
npm run format Format code with Prettier

Architecture

src/
├── main/           # Electron main process
│   ├── agent/      # AI agent orchestration
│   ├── db/         # SQLite database layer
│   ├── prompts/    # Agent system prompts
│   ├── services/   # Supabase management, etc.
│   ├── tools/      # MCP tool servers
│   └── workspace/  # File system operations
├── preload/        # IPC bridge (window.api)
├── renderer/       # React UI
│   └── src/
│       ├── components/
│       ├── hooks/
│       ├── lib/
│       └── pages/
└── shared/         # Shared types

Tech Stack

  • Electron — Desktop shell
  • React 19 — UI framework
  • TypeScript — Type safety
  • Tailwind CSS — Styling
  • shadcn/ui — Component library
  • Monaco Editor — Code editor
  • SQLite — Local database
  • Claude Agent SDK — AI agent orchestration
  • OpenAI Codex SDK — AI code generation

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/my-feature)
  3. Commit your changes (git commit -m 'Add my feature')
  4. Push to the branch (git push origin feature/my-feature)
  5. Open a Pull Request

License

MIT

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors