Skip to content

Structured Steering 1.0.0

Latest

Choose a tag to compare

@pirate pirate released this 12 Aug 17:21
· 8 commits to main since this release
9d2d5fa

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

  1. Download Structured-Steering-1.0.0.zip below.
  2. Unzip it and move Structured Steering.app to /Applications.
  3. Launch the app and click Install Hooks once.
  4. 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 codex CLI

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.