Help us ship stable releases across all platforms and operating systems

We run CI on Windows, Ubuntu, and macOS — but real-world usage catches things CI can't. If you want to help test pre-release versions before they hit main, sign up below.

Beta testers who consistently contribute will be promoted to core contributors with write access.

How it works

1. Comment on this issue with your OS + platform (e.g. "macOS + Gemini CLI")
2. We'll tag you on the PR when a new release is ready for testing
3. You test it and report back — either "all good" or open an issue

How to test

Upgrade (existing users):

/context-mode:ctx-upgrade

Fresh install: see README for your platform.

Local dev (contributors): see Contributing Guide.

Diagnostics: Run the debug script before reporting issues:

bash scripts/ctx-debug.sh
# Paste the JSON output from /tmp/ctx-debug-*.json

What to test

After upgrading, run these checks:

1. Debug script — bash scripts/ctx-debug.sh (all checks should pass)
2. Basic tools — Run a few prompts that trigger ctx_execute, ctx_batch_execute, ctx_search
3. Context savings — Run /context-mode:ctx-stats and check the savings ratio
4. Session continuity — After 20+ tool calls, compact the conversation and verify the model resumes correctly
5. Upgrade — /context-mode:ctx-upgrade should complete without errors

Report back

• Works fine: Comment with your OS + platform + version + "All good"
• Found a bug: Open a separate issue using the bug report template

Coverage Matrix

We need testers for every cell in this matrix:

⭐ = QA Lead

Beta Testers

Comment below to join. Include your OS and which platform(s) you use.

Known Platform Issues