ZeroShot Changelog

2026-09-02

v0.13.0

🚀 New Features

• Unified Skills Workspace: Review installed and suggested skills in one card-based list, filter recommendations for the current branch, inspect details, and add useful skills without moving between separate proposal screens.
• Local Diagnostics Center: Keep a local diagnostic log, open its folder from Settings, and capture the information needed to investigate session, pull-request, usage, and team-view failures.

✨ Improvements

• More Reliable Agent Hooks: Skill synchronization and token-saving hooks use one managed provider integration across supported coding agents, reducing setup drift and conflicting hook advice.
• More Relevant Skill Recommendations: Mark suggestions as not useful, preserve repository preferences, and target accepted proposals to the current branch or selected destination more clearly.

🐛 Bug Fixes

• Honest Loading Failures: Sessions, pull requests, team insights, and usage views now distinguish real empty states from failed requests and offer a direct retry path.
• Safer Skill Publication: Skill proposals retain their intended repository and destination while moving through review and publication.

2026-08-22

v0.12.0

🚀 New Features

• SkillRank for Your Skills: Browse registry skills, review recommendations and installed versions, inspect skill contents, and run guided evaluations against your own local skills from one workspace.
• Publish Skills to Coding Agents: Publish approved skills from ZeroShot and keep managed hooks synchronized across supported Codex, Claude, and Cursor setups without overwriting unrelated configuration.
• Folder-Scoped Session Tracking: Choose the folders ZeroShot should monitor, map sessions to the correct repository, and target generated skill proposals to the intended project.
• Windows Desktop Release: Install ZeroShot on Windows x64 with automatic updates and native tray controls for opening or closing the app.

✨ Improvements

• More Useful Session Browsing: Filter Agent Sessions by the context that matters, refresh linked pull requests on demand, and see whether GitHub attribution is current or still pending.
• Reliable Session Uploads: Upload an individual Agent Session when needed, while large uploads finish safely in the background instead of holding an open request.
• Safer Production Updates: Settings can check for updates against reachable production metadata and clearly report the installed and available versions.

🐛 Bug Fixes

• Reliable Transcript Search: Agent Session transcript searches avoid database timeouts on larger histories.
• Stable Agent Detection: Provider availability checks and ZeroShot background services recover more consistently without leaving duplicate or stale service instances.

2026-07-30

v0.10.0

🚀 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.

2026-07-23

v0.7.1

🚀 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.

2026-07-13

v0.3.2

🚀 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.

2026-06-30

v0.2.1

🚀 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.

2026-06-20

ZeroShot analytics and sync

🚀 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.

2026-06-10

CLI updates and session upload reliability

✨ 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.

2026-05-22

Go-based CLI foundation

🚀 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.

2026-05-05

v4.19 platform release

🚀 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.

2026-04-28

v4.18 platform release

🚀 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.

2026-04-02

v1.0.0

🚀 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 (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 (MIT).
• Extended with BuildBetter customer evidence integration.

2026-04-02

v1.0.1

🐛 Bug Fixes

• PyPI installation path fix — bb-skills now finds its skills directory when installed via pip install / uvx instead of from source.

2026-04-02

v1.1.0

🚀 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.

2026-04-02

v1.1.1

✨ Improvements

• Staging environment support in the configure command — point bb-skills at staging when needed.

2026-02-28

v0.0.1

🚀 New

• BB-Skills launch — BuildBetter-enriched spec workflow built on the spec-kit foundation.