Grok Build sessions in your Mac notch

Download for macOSFree 3-day trial · Apple silicon
AgentPeek monitoring a Grok CLI coding session from the Mac notch
Sessions
Hooks, 14 events
Permissions
Terminal handoff only
Direct Chat
grok agent stdio
Usage
None reported
Installs
~/.grok/hooks/agentpeek.json

Grok, visible while it works

Run grok in any terminal and the session appears in the notch: project, live state, current activity, file edits and commands on the timeline, and subagents under their parent. Expand a session for the transcript, read back from Grok's local session logs, and use the composer to send follow-up prompts into resumable sessions.

Approvals: flagged here, answered in the terminal

Grok doesn't accept permission responses from outside its own prompt, so AgentPeek doesn't pretend otherwise. The moment a Grok session blocks on an approval, it's flagged for attention, the notch can auto-expand, and ⌥ T jumps you to the exact terminal that's waiting. You lose the keystroke answer, but you stop losing the twenty minutes of not noticing.

Setup and routes

AgentPeek writes its hooks as a standalone drop-in at ~/.grok/hooks/agentpeek.json, leaving your own Grok config untouched, and Doctor repairs it if an update changes the format. Quick Routes opens the Grok hooks, config, and session logs in one click. Grok exposes no usage data AgentPeek can read yet, so sessions appear without usage numbers; that changes if Grok starts reporting it.

Questions

Yes. Grok sessions appear in the Mac notch with live state, activity, timelines, transcripts, and subagents, and the composer can send follow-up prompts into resumable Grok sessions.
No. Grok does not accept permission responses from outside its own prompt, so AgentPeek flags the waiting session for attention and jumps you to its terminal with Option T instead. Nothing is ever answered on your behalf.
Not yet. Grok does not expose usage data AgentPeek can read, so Grok sessions appear without usage numbers. Session monitoring, transcripts, attention flags, and follow-up prompts all work today.

Grok Build is a product of its respective owner. AgentPeek is independent and not affiliated with or endorsed by them.

Keep your agents in view

Download for macOSFree 3-day trial · Apple silicon