Release features
Which features ship, the shared release config, development previews and Coming Soon status.
Last updated
release-features.json at the repository root is the single release catalog. Change a feature's released boolean there, then rebuild the app and website. There is no runtime override in a shipped app. Changing the file affects future releases and updates; it cannot change an already installed binary.
Inventory#
| ID | Feature | Includes | Requires |
|---|---|---|---|
sidebar | Sidebar & chats | Chat list, live status, grouping, pins, labels, selection, subagents and peeking | — |
tasks | Tasks | Task board, PR checks and task plans | sidebar |
search | Search | Chat search, full text and command palette | sidebar |
composer | New chat composer | New chats, app/model/folder choices and attachments | sidebar |
voice | Voice dictation | Dictation, recognition, cleanup, Polish, history and floating microphone | — |
voiceLearning | Voice corrections & learning | Ratings, word and phrase corrections, dictionary learning | voice |
agents | Agents | Agent library, editing, creation and launching | composer |
skills | Skills | Skill library, delivery, drift repair and pins | sidebar |
workflows | Workflows & check-ins | Planning, steps, runs, startup questions, scheduling, check-ins and doctor | composer |
notes | Notes & sessions | Text/voice notes, sessions, search, export and dragging packages | — |
capture | Capture (Coming Soon) & browser DOM (Coming Soon) | Screen crops, selection overlay, browser DOM (Coming Soon), AX picker and browser adapter | notes |
windows | Window layouts & Basket | Basket, layouts, moving windows together and saved setups | sidebar |
handoff | Handoff, fork & follow-ups | Handoff between apps, forks and follow-up messages | composer |
limits | Plan limits & usage | Claude/Codex plan limits and local system usage | — |
notifications | Notifications & sounds | Desktop notifications, notification sounds and badges | — |
integrations | Hooks, MCP & agent actions | Live hooks, MCP/control tools, plugin install and agent actions | sidebar |
cloud | Cloud chats | Claude/Codex cloud chats and cloud composer destinations | composer |
Release behavior#
./build.sh --distributionand--distribution-dry-runcompile immutable release switches from this file. Disabled features have no active entry points or startup work. Capture (Coming Soon)'s picker, DOM (Coming Soon) resolver and overlay implementation are compiled out, and its browser extension files are not bundled. Existing notes and screenshots (Coming Soon) are kept; disabling a feature never deletes user data.- Regular developer builds and E2E test copies keep all features available for ongoing development. The public website always uses the release catalog, not developer availability.
- The build rejects unknown IDs, missing booleans, invalid dependencies and cycles. Disabling a parent requires disabling its children too; the build does not silently change your choices.
python3 app/scripts/check-release-features.pylists release status.web/scripts/sync-content.mjscopies the same catalog for website builds, including standalone deployments. Do not edit that generated copy.- Public pages show a shared Coming Soon notice, feature-specific previews, and availability labels in documentation, content prose, metadata and search results. Disabled features are previews, not claims about the installed release.
- Licensing, updates, privacy controls and core settings are infrastructure, not optional feature flags.
Checking a change#
Release builds bypass SwiftPM manifest caches, so changing only the JSON still recompiles the correct switches. For direct SwiftPM checks after changing the catalog, pass --manifest-cache none --disable-build-manifest-caching.
Run native tests in both development and PAIRBAR_DISTRIBUTION modes, compile the app in distribution mode, run the website's tests and type check, and inspect the app resources for disabled adapters. Verify every newly added feature has a catalog entry and gates at its UI, startup and action owners.