Alfred
A Codex desktop butler for voice orders and bounded local agent runs
Alfred is the small butler I wanted beside Codex desktop. I can give it a voice order, let the Alfred pet hold the instruction in view, and send bounded work through the Codex subscription and MCP setup I already use. It is meant to feel like a quiet desk assistant, not another dashboard to babysit.
- Role
- Product design and engineering
- Year
- 2026
- Platform
- Software project
- Status
- prototype
The problem
Codex is already where I hand work to agents, but quick spoken orders still fall through the cracks. Alfred gives those orders a small trusted place to land, keeps the run bounded, and leaves the record on disk instead of turning the idea into a full app.
What I built
The work includes Typed order CLI, Codex run router, Run ledger.
The choices behind it.
Solo · design + engineering
Implementation choice
Typed orders keep the CLI narrow: ask, run, say, dictate, and history stay as explicit commands instead of a vague natural-language daemon.
Implementation choice
Codex exec routing uses the account and MCP configuration already present on the machine, so Alfred does not ship its own MCP server or duplicate secrets.
Serialized runs keep local agent work bounded
One order is active at a time, later orders wait in line, and each run records what was asked and what came back.
The Codex desktop surface stays primary
Alfred is designed around the pet and voice layer already in the user's working environment, with no separate interactive demo pretending to be the product.
Implementation choice
The macOS voice worker is optional and native: it can listen while awake, take file dictation, and speak a reply with system speech.
Clap activation is honest about the hardware boundary
It can trigger the awake helper, but waking a sleeping Mac needs an always-on external sensor.
- typed order families
- 5
- serialized local run queue
- 1
- custom MCP servers
- 0
- optional macOS voice worker
- 1
Under the surface.
Typed order CLI
cliNode TypeScript command surface for ask, run, say, dictate, and history orders without a second app UI.
Codex run router
workerBounded codex exec runner that uses the existing subscription account and configured MCP tools.
Run ledger
libraryLocal filesystem history for orders, outputs, and the active queue so spoken work leaves a readable trail.
macOS voice helper
extensionOptional awake-only helper for speech recognition, file dictation, clap trigger, and spoken replies.
Codex desktop pet
surfaceAlfred Pennyworth-inspired pet treatment that makes the assistant visible inside the existing Codex desktop flow.
Build details Stack, scope, and implementation
Built with
- TypeScript
- Node.js
- OpenAI Codex CLI
- macOS speech synthesis
- macOS speech recognition
- filesystem history
- shell workers
- Codex MCP configuration
- GitHub
Areas
- Codex
- desktop companion
- voice control
- macOS
- agent orchestration
- local-first
More about the project
The prototype keeps the surface simple: a Node TypeScript CLI for typed orders, Codex exec account routing, serialized runs so two jobs do not stomp each other, and a local history of what was asked and answered. A native macOS helper can listen while the machine is awake, dictate files, and speak replies. Clap activation is an awake-helper shortcut only, not a real asleep wake system.