Structured Steering is a dockless macOS overlay for correcting the implicit assumptions a coding
agent makes while it works. This first packaged release includes the SwiftUI overlay, per-session
state, the watcher subagent, automatic Codex context injection, and an app icon.
Install
- Download
Structured-Steering-1.0.0.zipbelow. - Unzip it and move
Structured Steering.appto/Applications. - Launch the app and click Install Hooks once.
- Keep using Codex Desktop or Codex in iTerm normally. The overlay appears in the lower-right
corner without taking keyboard focus.
The installer adds and approves four global Codex hooks: SessionStart, UserPromptSubmit,
PreToolUse, and PostToolUse. It preserves unrelated hooks and repairs its absolute resource
path automatically if the app is moved. No clipboard access or keystroke injection is used.
The popup's close button quits the app. When one of its text fields has keyboard focus,
Command-Q also quits it. Launch the app again to restore the overlay.
Requirements
- macOS 14 or newer on Apple Silicon
- Python 3
- an installed, authenticated
codexCLI
This archive has a verified hardened-runtime ad-hoc signature. This Mac had the Apple ID configured
in Xcode, but no usable Developer ID Application certificate was present in Keychain for this
build, so it is not notarized. If Gatekeeper quarantines the downloaded build, right-click the app,
choose Open, and confirm once.
SHA-256 checksums are published in SHA256SUMS.txt.