Factory Droid sessions in your Mac notch

Download for macOSFree 3-day trial · Apple silicon
AgentPeek monitoring a Factory Droid session and answering an approval from the Mac notch
Sessions
Hooks, 9 events
Permissions
Mutating tools, in notch
Direct Chat
droid exec --session-id
Usage
None reported
Installs
~/.factory/hooks.json

Droid, out of the terminal shadows

Run droid in a terminal (or work in the Factory desktop app) and the session appears in the notch with live state, current activity, and tool calls on the timeline. Turn completions flip the state where you can see it, with notifications when you're looking elsewhere.

Approvals: answered in the notch, or handed back

The PreToolUse hook returns Factory's documented hookSpecificOutput permission decision for mutating tools, sub-droids, notebooks, and opaque MCP tools, so you can allow once, deny, or deny with feedback from the notch. Reads and searches stay native, and if AgentPeek is unavailable the hook returns ask so Factory's own permission flow takes over. Other permission notifications stay native and are flagged for attention instead, with the notch able to auto-expand and ⌥ T jumping you to the session. The composer sends follow-up prompts into resumable Droid sessions once they're waiting or idle.

Setup and routes

Hooks install into ~/.factory/hooks.json, Factory's canonical user hook file, with settings.json read as a fallback and migration source. Doctor repairs them, and Quick Routes opens the Factory config and project logs. Droid exposes no usage data AgentPeek can read yet, so its sessions appear without usage numbers.

Questions

Yes. Droid sessions from the CLI or the Factory desktop app appear in the Mac notch with live state, tool activity, and answerable approvals for mutating tools, and follow-up prompts go into resumable sessions from the composer.
Yes, for the tools its PreToolUse hook holds: mutating tools, sub-droids, notebooks, and opaque MCP tools. You can allow once, deny, or deny with feedback from the notch. Reads and searches stay native, and if AgentPeek is unavailable the hook returns ask so Factory handles the prompt itself. Other permission notifications stay native and are flagged for attention.
Yes. Droid sessions that carry a resumable session ID accept follow-up prompts from the notch composer once the session is waiting or idle, with the reply streaming into the session card.

Factory Droid 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