Changelog
v0.1.20 — 2026-07-14
Section titled “v0.1.20 — 2026-07-14”- Allows Launch Services URL opens (
lsopen) in the base profile so CLI agents can open the system browser for OAuth (Grok Build, Claude, Codex, MCP). Without this, interactive setup could hang with prompts stuck in “queued” after_LSOpenURLsWithCompletionHandlererror -54. - Documents Grok Build “queued” / incomplete setup troubleshooting: authenticate and trust folders outside the sandbox first (
grok inspect, interactive/hooks-trust— not a top-levelgrok --trustflag), avoid nested Seatbelt, and use headless health checks. - Documents the
FS_PERMISSION_DENIED/ “Couldn’t create session” failure when running Grok under BlastShield older than v0.1.19 (Homebrew installs that predate~/.grokruntime write support). - Notes browser/OAuth opens in the base profile reference.
v0.1.19 — 2026-07-10
Section titled “v0.1.19 — 2026-07-10”- Adds first-class Grok Build support in the base profile: allow runtime state writes under
~/.grok(sessions, memory, logs, sockets, auto-update binaries). - Protects Grok Build auth, configuration, policy, skills, plugins, hooks, and installed-plugin extension points from sandboxed writes.
- Documents
blastshield grok/blastshield grok --always-approvein the README, getting started guide, FAQ, profiles reference, docs index, architecture, and whitepaper. - Preserves Grok Build non-secret routing endpoints under
--clean-env(GROK_MODELS_BASE_URL,GROK_MODELS_LIST_URL,GROK_CLI_CHAT_PROXY_BASE_URL). - Adds integration tests covering allowed Grok runtime state and denied Grok auth/config/extension-point writes.
- Documents Grok Build launch patterns and the intentional auth/config write protections for public use.
v0.1.18 — 2026-06-22
Section titled “v0.1.18 — 2026-06-22”- Adds
AGENTS.mdwith repository instructions for future coding agents. - Adds
CLAUDE.mdas a symlink toAGENTS.mdso Claude uses the same instructions. - Documents the requirement that every non-release commit updates the changelog with the next release number and includes relevant docs updates in the same commit.
v0.1.17 — 2026-06-22
Section titled “v0.1.17 — 2026-06-22”Release commit: d4523c0
- Allows Gradle builds to use
~/.gradlecache, native, daemon, and wrapper state. - Keeps Gradle user-level init/config files such as
~/.gradle/gradle.propertiesand~/.gradle/init.dprotected. - Allows read-only GitHub CLI commands with IDs and JSON flags, including
gh pr view,gh pr checks, andgh run view/watch. - Allows read-only
gh apiGET/HEAD requests while continuing to block mutating API methods. - Leaves Gradle commands unguarded by
blastshield-guard.
v0.1.16 — 2026-06-22
Section titled “v0.1.16 — 2026-06-22”Release commit: 3a0a226
- Allows sandboxed GUI apps to open external links and documents through Launch Services.
- Fixes clicking GitHub links and other external URLs from Conductor running under BlastShield.
v0.1.15 — 2026-06-22
Section titled “v0.1.15 — 2026-06-22”Release commit: f89209d
- Marks
conductor-appas an intentional allow-only companion profile. - Updates CI and local profile linting to accept explicitly marked allow-only profiles.
v0.1.14 — 2026-06-22
Section titled “v0.1.14 — 2026-06-22”Release commit: 48f2e4e
- Allows Conductor workspace creation to materialize tracked project metadata such as
.idea,.vscode, and.mcp.json. - Removes Conductor-managed root denies that could break
git worktreecheckout.
v0.1.13 — 2026-06-22
Section titled “v0.1.13 — 2026-06-22”Release commit: 1fd49b4
- Adds the Conductor documentation page.
- Documents the supported Conductor launch command and inherited sandbox behavior.
- Adds Conductor support to the docs index, sidebar, README, FAQ, getting started guide, profiles reference, architecture page, and whitepaper.
v0.1.12 — 2026-06-22
Section titled “v0.1.12 — 2026-06-22”Release commit: 3736add
- Added the
conductor-appprofile. - Auto-detects Conductor by bundle id
com.conductor.app. - Allows Conductor-launched agents to write under
~/conductor/workspaces,~/conductor/repos, and~/.conductor. - Keeps sensitive workspace persistence paths protected, including
.git/hooks,.git/config,.vscode,.idea, and.mcp.json.
v0.1.11 — 2026-06-22
Section titled “v0.1.11 — 2026-06-22”Release commit: 2f61c6e
- Keeps interactive terminals open for GUI app launches.
- Streams redirected GUI app logs in the terminal.
- Adds
--detachfor scripts or terminal profiles that should return immediately. - Preserves the detached GUI process model so apps continue running after the log follow is stopped.
v0.1.10 — 2026-06-15
Section titled “v0.1.10 — 2026-06-15”Release commit: 4d2c6c4
- Allows scoped Metal, CoreAnimation, IOAccelerator, IOSurface, and Apple Silicon GPU access for GUI apps.
- Fixes Metal-backed apps such as Zed failing with graphics-device enumeration errors.
- Allows GUI apps to write normal per-user logs under
~/Library/Logs. - Adds regression coverage for Metal device enumeration and user log writes.
v0.1.9 — 2026-06-15
Section titled “v0.1.9 — 2026-06-15”Release commit: 2484e47
- Launches sandboxed GUI apps in a detached process instead of holding the app in the foreground.
- Redirects GUI app stdout and stderr to a temporary log file.
- Keeps temporary sandbox profile and guard directories alive until the GUI app exits.
- Adds regression coverage for detached
.applaunches and explicit GUI profile behavior.
v0.1.8 — 2026-05-29
Section titled “v0.1.8 — 2026-05-29”Release commit: f6be224
- Preserves BlastShield runtime guard path precedence across GUI app login-shell startup.
- Keeps guard wrappers ahead of user shell paths when GUI apps rebuild
PATH. - Improves
.applaunch compatibility for apps that inspect or modify shell environment.
v0.1.7 — 2026-05-28
Section titled “v0.1.7 — 2026-05-28”Release commit: bceeb3f
- Allows GUI apps to register for macOS power notifications.
- Fixes
IORegisterForSystemPower failederrors seen during Conductor startup. - Adds regression coverage for GUI power registration.
v0.1.6 — 2026-05-20
Section titled “v0.1.6 — 2026-05-20”Release commit: 20513ff
- Allows WebKit sandbox extension issuance needed by embedded web views.
- Fixes
com.apple.webkit.mach-bootstrapsandbox extension failures in GUI apps. - Adds regression coverage for WebKit extension issuance.
v0.1.5 — 2026-05-20
Section titled “v0.1.5 — 2026-05-20”Release commit: 0a71c99
- Skips project profile auto-detection for GUI app launches.
- Prevents project profiles such as
ghfrom blocking normal GUI app startup checks. - Lets users opt into specific GUI app restrictions with explicit
-pprofiles.