Grokestrator v0.2.0-alpha

Refreshed 2026-06-01: the tag and DMG were re-pointed to current main so the build is CI-clean and the alpha binary now includes the post-tag fixes — host lock-up (#70), client disconnect UX (#71), and the Swift 6 actor-isolation build fix (#69).

Second alpha. A round of conversation-surface and remote fixes on top of the first alpha — the transcript is calmer, the composer behaves, and a turn that asks you something now has real UI for it.

New

• Structured questions. When grok asks something mid-turn (_x.ai/ask_user_question) it renders as a native card — labelled options + a free-text field — and works across devices (answer on the Mac or a remote iPhone/iPad; first to answer wins).
• Live task checklist. grok's plan renders as one in-place checklist that updates as it works (pending → in-progress → done).

Fixed / improved

• The prompt box wraps correctly — backed by a real text view, so long lines soft-wrap to the box width, including when the inspector panel shrinks it and for a freshly typed line.
• The chat respects your scroll — during a streaming reply it only auto-scrolls if you're already at the bottom; scroll up to read and new text appends quietly. Return to the bottom to re-arm the follow.
• Tool calls fold away — a finished turn's 🔧 tool(...) rows collapse into one expandable "N tool calls" group (same as the thought process). They still show live while the turn runs.
• Includes the (untagged) v0.1.1-alpha remote fixes: Mac video over HTTP, live host UI when a turn is driven from another device, deletable remote servers, and stuck-"Connecting…" recovery.

Install

• Mac: download Grokestrator-0.2.0-unsigned.dmg. It isn't notarized yet, so the first launch needs a one-time Gatekeeper override — steps are in "How to open Grokestrator.txt" inside the DMG (System Settings → Privacy & Security → "Open Anyway", or xattr -dr com.apple.quarantine /Applications/Grokestrator.app). Or clone & build the GrokestratorMac scheme from source.
• iOS: sideload-only for now — build the GrokestratoriOS scheme in Xcode and deploy to your own device (free Personal Team = 7-day cert). TestFlight comes once the paid Apple Developer enrollment clears.

Full notes: see RELEASE_NOTES.md.

Grokestrator v0.1.0-alpha

Grokestrator — Release Notes

v0.1.0-alpha — 2026-05-29

First alpha. Grokestrator is a control console for grok agents (grok agent stdio):
launch and drive agents on your Mac, and pick up the same live session from another
device over your Tailscale network.

Highlights

Orchestrate grok agents

• Launch local grok connections on the Mac (grok agent stdio), with a working-directory
  picker + validation (blocks a non-existent cwd; expands ~).
• One connection = one grok instance, with persisted history that survives restarts.
• Archive (reversible) or permanently delete a connection in one step.

Remote & multi-device (Tailscale)

• Turn on Settings → Server → "Run server on this Mac" to share the Mac's connections.
• Drive the same session from an iPhone/iPad or another Mac — the host is the source of
  truth, so every device sees an identical transcript (prompts, thinking, answers) in real time.
• LAN-first dual-address: a connection stores a Local IP and a Tailscale address and
  tries the LAN first (full speed) before falling back to Tailscale; the sidebar shows which
  path is active ("· LAN" / "· Tailscale").
• Add / edit / remove remote servers on either platform; connections auto-reconnect.

Conversation

• Slash-command popup (type /) that fills in live as grok's MCP servers finish loading.
• Agent thinking streams live, then is erased when the final answer lands (ephemeral thoughts).
• Quick-reply buttons for multiple-choice asks; permission prompts surfaced over the thread.
• Clear a connection's chat history (syncs to every connected device).

Media

• Inline images; video plays via native HTTP streaming (progressive, scrubbable) from the
  Mac's media server — works on LAN and Tailscale.

Instance Inspector (right panel)

• Model + context window, live context-usage meter (ticks up during a turn),
  MCP server load state ("connecting 2/4… → 4/4 connected · 18 tools"), and the
  slash-command catalog.

App

• SourcePath-branded About and Help windows (⌘?).

Install

• Mac — two ways:
  • Clone & build from source (recommended if you have Xcode): git clone, then
    xcodegen generate && open Grokestrator.xcodeproj and run the GrokestratorMac scheme —
    no Gatekeeper hoops because it's your own local build. See the README's Getting Started.
  • Unsigned .dmg (Grokestrator-0.1.0-unsigned.dmg, no Xcode needed): first launch needs a
    one-time Gatekeeper override — see "How to open Grokestrator.txt" inside the DMG
    (System Settings → Privacy & Security → "Open Anyway", or
    xattr -dr com.apple.quarantine /Applications/Grokestrator.app).
• iOS — build & deploy yourself: there is no downloadable iOS build yet. You must
  build from source in Xcode and deploy to your own device as a developer (the
  GrokestratoriOS scheme + a free Personal Team gives a 7-day cert; an Apple Developer
  account gives a longer one). A public TestFlight build will come once the paid Apple
  Developer enrollment clears.

Known limitations

• iOS distribution is sideload-only until the paid Apple Developer enrollment clears (then TestFlight).
• Remote audio / file preview / large-image fullscreen still use the older chunked transfer
  (fine for small/single-chunk; can stall for large multi-chunk files) — migrating them to the
  same HTTP path as video is the next media task.
• Remote video needs reasonable bandwidth; on a slow remote Tailscale link it buffers. Same
  Wi-Fi (LAN path) is dramatically faster.
• MCP per-server detail (which one failed) isn't surfaced structurally — grok only reports an
  aggregate connected count; /mcps shows per-server detail on demand.

Notes for the next release

• Convert audio/files/full-image to the HTTP media path; consider per-file Range caching.
• Swap the iOS signing DEVELOPMENT_TEAM to the org once the paid account clears; switch
  distribution to TestFlight via scripts/build-ios-release.sh.