Building from Source

Prerequisites

• Rust 1.70+ with x86_64-pc-windows-gnu target
• MinGW-w64 (for the GNU linker)
• Node.js 18+ and npm

Install prerequisites automatically:

.\scripts\setup-windows.ps1

Build the Desktop App

cd apps/desktop-tauri
npm install
cd ../..
npm --prefix apps/desktop-tauri run tauri:build

The release binary lands at target/release/codexbar-desktop-tauri.exe.

For a debug build (faster compile, no optimisations):

cd apps/desktop-tauri
npm run tauri:build:debug

Build the CLI Only

cargo build -p codexbar --release
# Binary at: target/release/codexbar.exe

Dev Mode (Hot Reload)

.\dev.ps1                   # default debug build + launch
.\dev.ps1 -Release          # optimised build
.\dev.ps1 -Verbose          # debug logging
.\dev.ps1 -SkipBuild        # run last build without rebuilding

Or directly:

cd apps/desktop-tauri && npm run tauri:dev

Project Structure

Win-CodexBar/
├── apps/desktop-tauri/          # Tauri desktop shell
│   ├── src/                     # React frontend (TypeScript)
│   └── src-tauri/               # Tauri/Rust backend
│       └── src/
│           ├── commands/        # Tauri IPC commands
│           ├── shell/           # Window management, DWM, tray bridge
│           └── main.rs          # App entry point
├── rust/                        # Shared backend crate + CLI
│   └── src/
│       ├── providers/           # Per-provider fetch/parse/auth
│       ├── core/                # Provider IDs, cost pricing
│       ├── browser/             # Browser cookie extraction (DPAPI)
│       ├── tray/                # Tray icon rendering
│       └── main.rs              # CLI entry point
├── extra-docs/                  # Additional documentation
├── dev.ps1                      # Windows dev launcher
└── dev.sh                       # WSL/Linux dev launcher

Running Tests

# Shared crate tests
cargo test --manifest-path rust/Cargo.toml

# Tauri crate tests
cargo test --manifest-path apps/desktop-tauri/src-tauri/Cargo.toml

# TypeScript type check
cd apps/desktop-tauri && npx tsc --noEmit

# Lint
cargo clippy --all-targets -- -D warnings
cargo fmt --all --check