minidex

Minidex is an Electrobun desktop app.

Development

Install dependencies:

bun install

Build and launch the app in development mode:

bun run dev

Rebuild and relaunch on source changes:

bun run dev:watch

Build without launching:

bun run build

The app entry point is src/bun/index.ts, and the first bundled view lives in src/mainview/.

Project structure

The intended long-term folder structure is documented in docs/project-structure.md. It separates main-process code, renderer code, shared contracts, and the future plugin API so end-user plugins can depend on stable extension points instead of internal app files.

Codex app-server

Minidex uses codex app-server as its local Codex backend. The Electrobun main process owns the app-server child process over stdio, while the renderer talks to the main process through Electrobun RPC.

The app expects the codex CLI to be available on PATH. You can set the initial workspace shown in the UI with:

MINIDEX_WORKSPACE=/path/to/project bun run dev