UrbanWafflezz/GilbertCodex

Gilbert Codex v0.0.2 is the second public Windows alpha. It focuses on making the project more useful as a real open-source desktop agent workspace: a SQL-backed local database, stronger local Git review surfaces, broader GitHub tooling, app-update plumbing, and contributor-ready repository structure.

Download

• Windows x64 installer: Gilbert-Codex-0.0.2-x64-setup.exe
• SHA-256: e95a90ec012ad16333dfe48fcbcb71f245652c23f24d0f307921e30b8b3a8e96
• Approximate size: 5.49 MiB

This build is currently unsigned. Windows SmartScreen may ask for extra confirmation before installing.

macOS and Linux release artifacts are not official yet. The repo has partial source support for both platforms, and contributors with those operating systems are needed to test and complete the port.

This v0.0.2 installer and checksum were refreshed after the first publication so the same version includes the local SQL database work.

What's New

• Composer Git awareness: the composer can surface changed-file counts, additions, deletions, branch state, and a direct Review changes action.
• Review changes panel: local Git changes can be reviewed from a dedicated side panel with auto-review, risk, test, and summary prompts.
• SQL-backed Gilbert Database: desktop state now uses a local SQLite database for auth, chats, projects, settings, integrations, browser preview state, and agent runs.
• Database settings surface: Settings now includes a Database page for storage usage, context inventory, legacy storage cleanup, and full local database reset.
• Legacy storage migration: older local auth, agent-run, and browser localStorage data is migrated or cleaned after the database is available.
• Compact composer refinements: the composer uses tighter spacing and a shorter text area so the chat workspace leaves more room for active work.
• Local Git tool expansion: source-control tools now cover status, diff, log, stage, unstage, commit, push, pull, fetch, branch, and checkout flows.
• GitHub release and workflow tools: GitHub support now includes release-note generation, release creation/listing, workflow listing, workflow dispatch, and workflow-run inspection.
• GitHub OAuth documentation and scope clarity: docs now explain broader source-control, release, workflow, package, gist, organization, and repository-admin scopes.
• App update shell: the desktop chrome now has update checking/install UI, and the Tauri host includes update check/install commands for the future signed update feed.
• Window chrome polish: the top bar now reserves a right-side action area for update state plus native window controls.
• README preview refresh: the README now includes an animated preview and updated screenshots for the main app surfaces.
• Contributor infrastructure: issue forms, a pull request template, CODEOWNERS, CI, Dependabot, branching docs, contribution docs, and documentation standards were added.
• Tool/runtime documentation: source comments and docs were expanded around local computer tools, GitHub tools, web search, and runtime tool boundaries.

Fixes And Hardening

• More explicit unavailable-state handling when a selected workspace is not a Git repository or Git status cannot be read.
• More stable composer Git polling with focus and visibility refresh.
• More useful final fallback text when tool work completes but the model provider returns no visible final answer.
• Safer handling for unreadable or empty legacy auth databases during migration.
• Safer source-control prompt guidance for local Git and GitHub mutating actions.
• Better app-local documentation for release hygiene, branch lanes, contribution flow, platform support, and security-sensitive changes.

Known Limits

• Windows x64 is still the only official packaged target for this release.
• The installer is not code-signed yet.
• App updater plumbing exists, but signed updater artifacts are not bundled in this release because the private updater signing key is not part of the repository.
• macOS and Linux need native contributors to validate launch, packaging, shell behavior, and platform-specific fixes.
• Provider keys, GitHub tokens, Discord settings, local accounts, logs, and workspace data remain local user data and are not bundled.

Verification

The release was validated with:

npm.cmd run check
npm.cmd run audit:prod
npm.cmd run app:build
git diff --check

The public installer and checksum were checked after upload by downloading them from GitHub Releases and comparing SHA-256 hashes.

Release Assets

• Gilbert-Codex-0.0.2-x64-setup.exe: Windows x64 installer for end users.
• Gilbert-Codex-0.0.2-x64-setup.exe.sha256: checksum file for the installer.

Built from commit c335c3bb6a0c5d81afeead2a3201bc0651b31cea and tag v0.0.2.