> ## Documentation Index > Fetch the complete documentation index at: https://docs.buildbetter.ai/llms.txt > Use this file to discover all available pages before exploring further. # ZeroShot Changelog > Updates to ZeroShot β€” the desktop app, `bb` CLI, and open-source BB-Skills packs. This page tracks **ZeroShot** β€” the desktop app, the `bb` CLI, and the open-source **BB-Skills** packs. For the main BuildBetter web app, see the [BuildBetter Changelog](/changelog). For the desktop and mobile Recorder, see the [Recorder Changelog](/recorder-changelog). Source: [github.com/buildbetter-app/BB-Skills](https://github.com/buildbetter-app/BB-Skills) (MIT-licensed). Version labels follow the **ZeroShot desktop production release**. The `bb` CLI and BB-Skills packages are versioned independently. **49 ZeroShot Commits Included** ### πŸš€ New Features * **Guided CLI Onboarding:** The ZeroShot CLI now walks through setup with clearer readiness checks, diagnostics, and recovery guidance. * **Skill Pull Requests:** Browse skill-related pull requests from the Skills switcher alongside existing skill proposals. * **More Agent Support:** Session ingestion and proposal workflows now recognize OMP, Pi, Oh My Pi, and Codex subagent sessions with honest availability states. * **Dedicated Session Scanning:** Session discovery has its own processing lane so large imports do not block the rest of the app. ### ✨ Improvements * **Faster Sessions and Skills:** Local SQLite-backed session and skill views load more quickly. * **Windowed Large Transcripts:** Very large session transcripts render in manageable windows for smoother browsing. * **Reliable Repository Selection:** Repository roots are normalized consistently across onboarding, sync, and local processing. * **Visible Runtime Status:** ZeroShot again shows the current session runtime and keeps background status pulses coordinated. * **Faster First Sync:** Initial discovery and indexing can use available machine resources more effectively, while later work remains bounded. * **Profile-Scoped Services:** Switching profiles keeps ZeroShot services and local state attached to the correct profile. ### πŸ› Bug Fixes * **Stable v0.10 Desktop Experience:** Fixed regressions introduced during the v0.10 desktop transition. * **Reliable Onboarding Completion:** First-run setup and initial sync no longer become stuck or lose legacy state during migration. * **Cursor Sign-In Detection:** Dispatch checks now read Cursor's structured status output more reliably. * **Accurate Subagent Classification:** Codex subagent sessions are labeled and grouped correctly instead of appearing as ordinary top-level sessions. **24 ZeroShot Commits Included** ### πŸš€ New Features * **Session Transcript Workspace:** Browse and work with session transcripts in a clearer, more focused workspace. * **Restored Skill Sets:** Skill Sets are available again for organizing and working with related skills. * **Shared CLI and Sync Runtime:** The desktop app and CLI now use a shared session-sync foundation for more consistent imports and uploads. * **Trustworthy Skill Analytics:** Skill usage and outcomes are measured from normalized session evidence instead of placeholder data. ### ✨ Improvements * **Reliable Team Analytics:** Team views and session sync stay aligned as new sessions arrive. * **Better Shot Notch Placement:** The menu-bar window positions correctly across multiple displays. * **Self-Contained CLI Installer:** The ZeroShot CLI installer includes what it needs instead of depending on repository-local files. * **Bounded Background Work:** Watchers, analytics, and skill processing use less idle CPU and avoid unbounded background loops. ### πŸ› Bug Fixes * **Local Skill Proposals:** Local proposal runs can complete without an arbitrary timeout. * **Codex CLI Discovery:** ZeroShot finds working Codex installations again across supported install layouts. * **Mirrored Codex Messages:** Duplicate mirrored messages no longer inflate session transcripts or analytics. **73 ZeroShot Commits Included** ### πŸš€ New Features * **Pi Session Ingestion:** Import and analyze sessions created with the Pi coding agent. * **Agent Dispatch:** Dispatch supported coding agents from ZeroShot with provider-aware setup and readiness checks. * **Pull Requests Workspace:** The Pull Requests tab is connected to live repository data with per-view fetching and GitHub connection guidance. * **Cloud Skill Proposals from PR Feedback:** Turn pull-request feedback into reviewable, repository-specific skill proposals and hand approved changes back to the local workflow. * **Repository Learning:** Preserve repository-specific learnings so future proposals can build on prior decisions. * **ZeroShot Invitations:** Invite teammates through a ZeroShot-branded flow with resource-oriented account routes. ### ✨ Improvements * **Clearer Session Titles:** Layered title extraction produces more useful names for local sessions. * **Smarter Skill Proposals:** The proposal pipeline uses stronger signal quality, review confidence, approval modes, and duplicate prevention. * **Simpler Settings:** Production settings hide developer-only controls while keeping proposal behavior and feedback access easy to find. * **Reliable Open at Login:** macOS registration now appears correctly in System Settings login items. * **Current Model Pricing:** Cost estimates include the latest supported Fable, Mythos, and Sonnet model pricing. ### πŸ› Bug Fixes * **Lower Idle CPU:** Pooled database connections, session watchers, sync, and skill scheduling no longer spin unnecessarily while idle. * **Reliable Repository Rollups:** Claude Code sessions are attributed to the selected repositories using their real on-disk git remotes. * **Stable Skill Reviews:** Proposal review, reset, reconciliation, and cloud handoff flows recover cleanly from interrupted work. * **Cursor Discovery:** ZeroShot resolves Cursor installations across supported installer and IDE launch paths. ### πŸš€ New Features * **ZeroShot Desktop App** β€” Introduced the ZeroShot desktop app for session analysis and related workflows. * **Local Session Analytics** β€” ZeroShot now supports local-first session analytics, including local processing, remote processing, and automatic fallback to local mode when signed out. * **Local Session Indexing** β€” Added native local indexing for Codex and Claude Code sessions, including usage, friction signals, and repository-aware attribution. * **Organization-Wide Session Browsing** β€” Browse teammate sessions and sessions from other machines, with owner names and People filtering. * **Remote Session Resume** β€” Cloud-only sessions can now be resumed when the related repository exists locally. * **Skills in ZeroShot** β€” Browse and install BuildBetter skills inside ZeroShot, with installed-version tracking and update detection. * **Local Insights** β€” ZeroShot Insights can read directly from the local session store for work breakdowns, friction-heavy sessions, and codebase hotspots. * **Host Name Capture** β€” Agent sessions can optionally include the machine host name for better cross-device context. * **Rewind and Archetypes** β€” Added a richer rewind experience with multi-repo onboarding, usage and signal story screens, and deterministic work-style archetypes. * **Channel-Based Desktop Releases** β€” ZeroShot desktop releases now support separate release channels for early access and stable builds. * **Shot Notch Chat Preview** β€” Shot Notch now includes an in-place chat preview with richer recent session cards and quick access to Sessions. * **Local Repository Selection** β€” Onboarding now lets users choose local Git repositories directly and keeps imports scoped to selected repos. * **Skill Discovery Inbox** β€” Added continuous skill discovery with ranked candidates, batch generation, and review steps. * **Developer Archetype Cards** β€” Added shareable developer archetype cards with downloadable artwork and copy-to-clipboard support. * **Live Pull Requests** β€” Added repository-specific live pull request views powered by GitHub data. * **Local Skill Proposals** β€” ZeroShot can turn imported local sessions into repository-specific skill proposals that users can review and install directly. * **Unified Local and Remote Sync** β€” Local import and remote upload are now combined into one sync flow. * **Goalcraft Skill** β€” Added the Goalcraft skill for turning approved plans into active, evidence-based goals. * **Smarter Repo Suggestions** β€” Onboarding highlights repositories with recent session activity and falls back to a broader scan when needed. ### ✨ Improvements * **Agent Session Sync Performance** β€” Session syncing is faster and more transparent, with better progress reporting, chunk reuse, and optional storage improvements. * **CLI Experience Improvements** β€” Command help and validation have been improved so setup and sync commands are easier to use correctly. * **Live Analytics Views** β€” Usage, repository, people, and session views now use real session data. * **More Accurate Usage Views** β€” Usage reporting uses real organization-wide people data and server-side filtering for more accurate breakdowns. * **Cross-Machine Session Experience** β€” Session resume, missing-repo guidance, and owner information are clearer across devices. * **Skills Screen Upgrade** β€” The Skills screen now uses real data, scans more local skill locations, and detects available updates more reliably. * **Hybrid Mode** β€” ZeroShot switches more cleanly between local indexing when signed out and remote sync when signed in. * **Faster Local Insights** β€” Local analytics are faster and more reliable thanks to direct reads from the local session store. * **Better Session Navigation and Filtering** β€” Sessions and Usage handle deep links, filtering, and single-person scenarios more smoothly. * **Improved Local Indexing Stability** β€” Local indexing processes sources more predictably and refreshes data at better times, reducing UI churn. * **Shared Local and Hosted Session Model** β€” Local and hosted session analysis use the same normalized model for more consistent results. * **Cached Local Signals** β€” Local signal extraction caches results so Home, Insights, onboarding, and session details load faster. * **Better Local Indexing Performance** β€” Indexing handles larger batches, skips bad transcripts more gracefully, and keeps loading states accurate. * **Shot Notch Improvements** β€” The macOS menu bar experience has better sizing, positioning, toggles, and settings integration. * **Less Misleading Placeholder Content** β€” Hosted-only features show clearer unavailable states instead of synthetic placeholder data. * **Faster Local Analytics Queries** β€” Local database optimizations improve responsiveness across sessions and analytics views. * **More Accurate Repository Attribution** β€” Local and synced sessions stay linked to the right repository more reliably, even across worktrees, deleted folders, or remote-only metadata. * **More Reliable Skill Discovery** β€” Skill discovery and generation avoid duplicates, clear acted-on suggestions, and better match the real product flow. * **Better Usage Burn-Down Tracking** β€” Claude usage burn-down views use more accurate live limit data when available, including model-specific pacing. * **Session Preview Improvements** β€” Session previews show cleaner recent conversation snippets with less noise. * **Repository-Scoped Remote Sync** β€” Remote sync uploads only sessions from selected repositories. * **Real-Data Experience** β€” Usage, Insights, and Home rely on real local session data and hosted usage when signed in. * **Insights as the Main Focus** β€” Insights is now the default ZeroShot landing page. * **Clearer Usage Breakdowns** β€” Usage includes breakdowns by model, repository, and branch, plus a β€œwhere tokens go” view. * **Plain-English Signals** β€” Signal displays are easier to understand, with clearer explanations of what ZeroShot noticed. * **Live GitHub Pull Requests** β€” PR views use live GitHub data for fresher results. * **Automatic Session Syncing** β€” ZeroShot now runs hourly local and remote syncs. * **Better Local Import Progress** β€” Local import shows clearer multi-stage progress through discovery, normalization, and database writes. * **Safer Skill Installation** β€” Skill discovery is standardized across supported local skill folders with safer path handling. * **App-Owned Authentication** β€” Native sign-in, sign-out, and token refresh behavior is smoother. * **More Stable Loading States** β€” Insights, Usage, and related views use steadier loading placeholders. * **Faster Onboarding Value** β€” Onboarding advances after the first recent-session batch imports while the rest continues in the background. * **Onboarding Skill Suggestions** β€” Ready skill proposals from selected repositories can appear directly in onboarding. * **Recent Repo Suggestions** β€” Onboarding prioritizes repositories from the last seven days of local session activity. ### πŸ› Bug Fixes * **CLI Authentication Refresh** β€” Stored login tokens refresh before requests, reducing sync and upload failures. * **Session Identity Collisions** β€” Claude subagent session uploads no longer collide during concurrent uploads. * **Auth Status Reporting** β€” `bb auth status` refreshes expired credentials and reports current auth state more reliably. * **Packaged ZeroShot Local Mode** β€” Packaged builds use the real local and remote processing flow. * **Usage Data Source Labels** β€” Usage and Insights correctly show whether data is local or hosted. * **Historical Repo Attribution** β€” Older synced and local sessions resolve repository attribution more reliably. * **Session Navigation** β€” Session links work across supported session ID formats. * **Local Database Reliability** β€” Reduced intermittent local database lock errors while indexing and browsing. * **Local Insights Query Handling** β€” Valid read-only insight queries are no longer misclassified. * **Skill Generation Edge Cases** β€” Improved candidate parsing, reset handling, and inbox-based proposal quality. * **Local Data Reset** β€” Local reset fully clears stored session data before restarting onboarding. * **Shot Notch Refreshing** β€” Session previews no longer briefly show the wrong chat snippet. * **Updater Link Generation** β€” Prerelease updater links work when asset names contain spaces. * **Remote Sync Scoping** β€” Syncing a selected repository no longer uploads sessions from every local repository. * **Repo Selection During Onboarding** β€” Adding a repository no longer removes repositories already selected. * **Sign-In Setup Errors** β€” Removed-hook setup failures no longer block setup. * **Profile Images on Archetype Cards** β€” Shared archetype cards use profile images correctly, with initials as a fallback. * **Signed-In State Timing** β€” Screens no longer get stuck on local-only data after login. * **Signed-Out Local Sync** β€” Signed-out users still get incremental local session syncing. * **Friction Detection Accuracy** β€” Successful tool output containing words like β€œerror” or β€œfailure” is no longer misclassified. * **Skill Install Path Safety** β€” Saved skill files cannot escape the selected repository. * **Codex CLI Detection** β€” Broken Codex shims are skipped in favor of working executables. * **No-Work Sync Progress** β€” Selected-repository syncs show correct progress even when there is nothing new to import. * **Analytics Accuracy** β€” Insights and Sessions use database-backed counts instead of placeholder or client-side estimates. * **Large Session Uploads** β€” Very large analytics batches persist correctly. * **First-Run Onboarding Guardrails** β€” Onboarding cannot be dismissed before a repository is selected. * **Cold-Start Empty States** β€” Usage and Insights show loading placeholders instead of incorrect empty states on startup. * **Desktop Button Rendering** β€” Fixed nested button rendering issues in the desktop UI. * **Missing Dashboard Breakdowns** β€” Restored work-type and usage summary breakdowns. * **Proposal Discovery Timing** β€” Proposal generation waits for enough imported sessions. * **Stuck Proposal Runs** β€” Interrupted background work no longer blocks future proposal runs. * **Onboarding Progress Timing** β€” Onboarding and import progress better reflect live import state. * **Multi-Repo Onboarding Thresholds** β€” Proposal generation starts once combined imported sessions reach the threshold. ### πŸš€ New Features * **Agent Session Usage Analytics** β€” New analytics support tracks coding-agent session usage, costs, and friction across providers. ### ✨ Improvements * **CLI Sync Improvements** β€” The `bb` CLI now provides improved sync uploads, auth checks, clearer status output, and more consistent provider naming. ### ✨ Improvements * **Latest CLI Version Reporting** β€” BuildBetter now checks GitHub releases for the latest BB CLI version. * **BB CLI Update Delivery** β€” The latest CLI release is served through the latest release path. ### πŸ› Bug Fixes * **CLI Session Upload Fixes** β€” Agent session uploads finalize correctly, refresh expired tokens when needed, and avoid getting stuck mid-upload. * **Hook Upload Reliability** β€” Repo-local hook uploads work more reliably, including better fallback handling and upload routing. ### πŸš€ New Features * **Go-Based CLI Foundation** β€” The `bb` CLI was rebuilt on a Go-based foundation with onboarding, auth, hook management, sync, and bootstrap capabilities. * **Local-First CLI Onboarding** β€” The CLI includes a local-first onboarding experience with terminal review screens. ### πŸ› Bug Fixes * **Legacy Hook URL Fix** β€” Existing `/bb.sh` bootstrap hook URLs work again. ## Earlier `bb` CLI Releases The `bb` binary captures agent sessions and lets your team resume them anywhere. These earlier CLI releases are now tracked here as part of ZeroShot. ### πŸš€ New Features * **BB CLI Support Tools** β€” `bb` now includes diagnostics, support bundle creation, and feedback submission to make troubleshooting easier. * **CLI Session Resume Filters** β€” Filter resumed agent sessions by provider, session, branch, commit, repository, or pull request. * **CLI Hook Management** β€” Install, repair, check, and remove Codex and Claude hooks from one place. * **One-Command CLI Installs** β€” BB CLI releases are available through a simpler install flow for macOS and Linux. * **Shipping Confidence Skill** β€” Added a skill for assessing release readiness using evidence-based guidance. ### ✨ Improvements * **CLI Updates and Install Experience** β€” Auto-update enabled for direct installs; clearer upgrade instructions for package-manager installs. * **Cleaner CLI Hook Output** β€” Hook output is quieter and easier to read, while still logging useful details when something goes wrong. * **Safer CLI Support Diagnostics** β€” Auth and support details easier to inspect, with permission checks and redacted diagnostics for privacy. * **Safer Session Restore** β€” Resuming a session on a different machine or checkout now gives clearer guidance to avoid restoring into the wrong context. * **Better Auth Visibility** β€” `bb auth status` gives more useful details and warns when credentials or config files are too broadly readable. ### πŸ› Bug Fixes * **CLI Release Publishing Fix** β€” Release publishing works correctly even when the workflow runs without a checked-out repository. * **Large CLI Session Uploads** β€” Large agent session uploads succeed more reliably, with full tool output preserved. * **Eval CLI Boolean Flags** β€” CLI boolean flags work properly when passed without explicit values. ### πŸš€ New Features * **ZeroShot CLI Session Resume** β€” Previously uploaded Codex and Claude sessions can now be reopened on the current branch with `bb agent-sessions resume`. * **Linear Command in Claude** β€” Create and manage Linear tickets directly from a Claude session, including ticket creation, workflow updates, and linking customer issues to engineering work. ## BB-Skills (open-source skill packs) The Python `bb-skills` package installs and updates the skill packs that your coding agent uses. Versioned independently on PyPI and GitHub. ### ✨ Improvements * **Staging environment support** in the `configure` command β€” point `bb-skills` at staging when needed. ### πŸš€ New Features * **`bb-` prefix on spec-workflow skills** β€” spec-workflow skill names now carry a `bb-` prefix so they don't collide with other skill catalogs. * **`configure` command** β€” set up workspace defaults and environment from one CLI command. ### πŸ› Bug Fixes * **PyPI installation path fix** β€” `bb-skills` now finds its skills directory when installed via `pip install` / `uvx` instead of from source. First public release of BB-Skills β€” AI coding skills for any coding agent. ### πŸš€ New * **Skills-first architecture** with pack-based installation. * **Three skill packs:** * `core` β€” base skills including `bb-skills-update` * `spec-workflow` β€” 9 skills derived from [github/spec-kit](https://github.com/github/spec-kit) (MIT), extended with BuildBetter customer evidence integration * `testing` β€” 3 browser testing skills (`app-navigator`, `trust-but-verify`, `generate-tests`) * **Multi-platform support** via 7 adapters: Claude Code, Codex, Cursor, Copilot, Gemini, Windsurf, Amazon Q. * **`bb-skills` CLI** with `install`, `update`, `list`, `uninstall`, `platforms` commands. * **User-initiated update checking** via GitHub releases. ### Acknowledgments * Spec-workflow skills derived from [github/spec-kit](https://github.com/github/spec-kit) (MIT). * Extended with BuildBetter customer evidence integration. Initial scaffolding release. ### πŸš€ New * **BB-Skills launch** β€” BuildBetter-enriched spec workflow built on the spec-kit foundation.