Gajendra 0.4.0

Gajendra 0.4.0 — October 7, 2026

One clear focus across your AI tools.

Get the Codex plugin · Mac setup · User guide

This source release brings the native macOS utility and Codex plugin onto the same local work model:
one NOW, ordered Focus and Important, provider-reported Running, and Ready for Review. User intent
controls Finish/Reopen and exact continuation links. Provider sessions remain with their owners.

 What changed

• Faster reads and local changes. Prepared catalog reads and a shared local backend make everyday reads and priority changes fast.
  Source refreshes are coalesced; catalog/configuration/activity revisions prevent reuse across
  invalidation boundaries. Durable state uses atomic writes, revision checks and retry keys.
• Fewer provider scans. Normal Codex listing uses its supported metadata-only API. Full reconciliation remains periodic;
  fresh evidence is still required when acknowledging a review.
• Review with Undo. Review acknowledgement removes only the selected response and keeps priorities. Retry/Undo,
  external client changes and newer responses have explicit handling. History distinguishes
  reviewed responses and intentionally finished work.
• Continue in the right chat. Exact continuation selection retains prior chats and transfers priority/context/NOW together.
• A more consistent Mac utility. The launcher reconciles visibility with Spaces. Priority headers and compact controls are
  consistent across native and embedded surfaces.
• Smoother interaction. Titles crossfade their emphasis within a fixed footprint; row surfaces and buttons respond to
  pointer interaction. Keyboard commands remain immediate. Reduce Motion preserves static feedback.
• Development with evals. Added six product evals, with synthetic acceptance cases and machine-readable results in CI and the release gauntlet.
• Current screenshots and guides. Refreshed the real UI screenshots, Focus Deck hero/background, README and contribution/conduct guidance. Reviewed both MIT license copies; no terms changed.
• Dependency updates. Reconciled the dependency PRs in order, retaining the compatible MCP Apps 1.x API and patched MCP SDK 1.31.0. MCP Apps 2.x requires a separate SDK migration.

 Measured performance

Same machine, enabled sources, bundled runtime and isolated copies of local state; three samples
per before/after operation. Synthetic collapse writes were used. These are CLI/backend timings,
including process overhead, not render times or production percentiles.

Operation	Before median	After median	Change
Warm provider refresh	15.05 s	0.80 s	94.7% lower
Local state write	15.92 s	0.11 s	99.3% lower
Prepared read	New endpoint	0.12 s	Ready catalog plus current state

A later installed-build check recorded 90–94 ms prepared reads, 646–671 ms warm refreshes and
2.86 s for the first refresh with a new backend. The motion/release pass does not change the
listing algorithm. Ordinary and fast listing had equal indexed coverage in the comparison.
Full reconciliation can still take the previous scan time; unindexed provider metadata may lag
until it runs. No pagination, resource bounds or review freshness checks were removed.

 Install and update

The v0.4.0 GitHub release contains the
merged source and gajendra-codex-plugin-0.4.0.zip with a SHA-256 checksum. The ZIP contains the
complete 17-file runtime plugin; it is not a notarized macOS installer. The internal package and
repository marketplace version are 0.4.0. The earlier v0.4.0-rc.1 remains a separate historical
prerelease; its tag has not been moved.

See Codex plugin setup for the repository marketplace. Plugin-only use
requires Node.js matching package.json and locally available provider executables. Reopen the
panel/reload the host after updating to pick up both tools and UI. The optional native app is built
from source with a bundled Node runtime; see the repository README.

The repository package is available for local installation. Official directory review is a
separate process; see submission readiness.

 Known limits and remaining user checks

• No notarized downloadable native app or mobile companion is shipped. macOS clean-account,
  physical VoiceOver, login-item and manual drag checks remain separate from scripted evidence.
• Provider availability and bounded discovery can leave a saved priority outside current results;
  it stays preserved and the UI explains the condition.
• An expired or offline cache is visibly a saved view with neutral activity. It is never evidence
  of current Running or Ready status. Local changes can use that view while refresh catches up.
• Lifecycle hooks are optional and require host trust. Polling remains the fallback.
• The backend is a reversible session process with a private Unix socket, not a system service.
  It exits after idle use. GAJENDRA_SHARED_BACKEND=off, GAJENDRA_CODEX_FAST_LIST=off and
  GAJENDRA_METADATA_CACHE=off are independent rollback switches; restart clients after changes.
• Preserve your state and backup when downgrading; older writers can discard newer optional fields.

The PR, hosted checks and source release are separate receipts. A source release does not
certify OpenAI directory approval, code signing/notarization, or performance on every machine.

 Verification

169 source tests and 31 browser journeys passed, with five source-suite repetitions and all
155 repeated browser cases passing, along with native self-tests/build, strict
signature validation and bundle checks. The native installed synthetic review/Undo and priority
journeys, and plugin review/Undo journey, were inspected through CUA. User state stayed unchanged.

The release gauntlet's --non-native-ui mode records 19 passing gates and three not run,
reporting a partial run: its AX-based native
launcher/fullscreen/performance gates are deliberately not executed in the restricted UI-control
environment. Narrow CUA checks do not replace those broader receipts. No full-gauntlet or native
latency claim is made for this release. Hosted CI is reported on the PR separately.

Runtime dependency patches bring the production dependency audit to zero findings. The full
development audit still reports the unpatched braces nested-pattern denial of service
through vite-plugin-singlefile/micromatch (three affected package entries). This dependency is
build-only; our single-file plugin uses an empty inlinePattern, bypassing that matching path.
No untrusted pattern is accepted by this build. No forced downgrade or broad dependency migration
is included.

Repository update

Fresh product screenshots, eval acceptance criteria and current community documentation are included in PR #47. The README and repository homepage now describe both the macOS utility and Codex plugin.

Documentation icons and navigation were polished in PR #48. The v0.4.0 tag and downloadable artifacts are unchanged.

Gajendra 0.4.0 RC1 — faster refresh and shared workflows

This is the Gajendra 0.4.0 source prerelease, targeting PR #41 at commit 8feafd2c452b82a686faec889ef0661f16287bbe. It is not yet merged and is not a signed/notarized macOS download.

Changes

• One shared local backend and prepared metadata cache for the macOS utility and Codex plugin, with atomic revision-checked changes and coalesced refreshes.
• Explicit Finish/Reopen, exact continuation links, and shared History. Provider sessions remain with their owners; idle or opening never means finished.
• Response-specific review acknowledgement with immediate feedback, durable Retry and Undo, and protection for newer responses.
• Subtle title crossfades, row highlights and pointer press feedback. Actions dispatch immediately; keyboard and Reduce Motion remain supported.
• Fullscreen launcher recovery, clearer priority controls, improved Codex onboarding/listing metadata, reviewer cases and privacy documentation.
• Three compatible runtime dependency patches; production dependency audit reports zero findings.

Measured improvement

A controlled local comparison, three samples per operation, reduced median backend refresh from 15.05s to 0.80s (94.7%), and local changes from 15.92s to 0.11s (99.3%). These are backend timings including process overhead, not UI render guarantees. Cold startup and periodic full reconciliation can take longer.

Assets and installation

• gajendra-codex-plugin-0.4.0-rc.1.zip: complete 17-file local runtime plugin, including manifest, MCP server, UI, skill, optional hooks and license notices.
• SHA256SUMS.txt: checksum for that ZIP.
• GitHub source archives: repository source including the optional macOS utility.

The internal package version is 0.4.0. Use the source candidate and setup instructions for the repository marketplace. Plugin-only use requires a supported Node.js runtime and locally available providers. Reopen panels/reload Codex after updating. Hooks remain optional and require host trust. There is no notarized app installer in this release.

Verification and limits

169 source tests and 31 browser journeys passed, plus five source-suite repetitions and 155 repeated browser cases. Native self-tests, build and strict local bundle/signature checks passed. Synthetic installed native review/Undo and priority journeys, plus plugin review/Undo, were inspected through CUA. Private user state stayed unchanged.

The release gauntlet is explicitly partial: 18 gates passed, three native automation gates not run. Separate CUA checks do not replace its broader native launcher/fullscreen/performance gates. Clean-Mac, physical accessibility, login-item and manual drag acceptance remain open. Both hosted jobs, Linux plugin and macOS companion, passed on the exact candidate commit: CI run.

The full development dependency audit flags the unpatched braces nested-pattern advisory through vite-plugin-singlefile/micromatch. It is build-only, and this build uses no inline matching patterns, so that path is unused. See the detailed release notes.

This is a community repository plugin, not an approved OpenAI directory listing. The official route still requires accepted local-MCP support or an approved remote architecture, verified publisher and review materials. See publication readiness and privacy information.

Gaja 0.3.1 — Elephant Focus for AI Power Users

Gaja is a local-first macOS focus utility for AI power users working across Codex, Claude Code, Cursor, and explicitly configured agents.

Highlights

• One global NOW, an ordered Focus queue, and an Important tier across source-namespaced AI-agent threads.
• Bottom-right icon-only macOS utility with hover details, a resizable organizer, menu-bar/Dock recovery, Launch at Login, light/dark appearance, Reduce Motion, and VoiceOver labels.
• Codex, opt-in Claude Code metadata, Cursor Agent, and bounded generic JSON-catalog adapters.
• Portable MCP App with GSAP/Flip interaction feedback and native resume handoff to the owning agent.
• Original seven-stroke thin-line lotus shared across SVG, SwiftUI, menu-bar, app-icon, and web surfaces.
• Owner-only metadata persistence with atomic writes and copy-only migration from earlier Priority Deck/Aadi state.

Verification

• Clean-clone gauntlet: 18/18 gates passed.
• Hosted GitHub Actions: plugin and macos-companion passed on the tagged commit.
• 19 unit/integration tests, 7 browser journeys, 35 repeated browser journeys, five repeated unit suites, native Swift validation, accessibility/themes/reduced-motion checks, and zero high-severity production dependency findings.

Install

Follow the source installation steps in the README. The repository includes source and deterministic build tooling.

This is a source release. It does not include a downloadable Developer ID–signed or notarized macOS binary. Locally built app bundles are ad-hoc signed; public binary distribution remains a separate release gate.