Skip to content
pmLet’s talk
All projects

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.

CLI toolNo screen capture yet
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

cli

Node TypeScript command surface for ask, run, say, dictate, and history orders without a second app UI.

Codex run router

worker

Bounded codex exec runner that uses the existing subscription account and configured MCP tools.

Run ledger

library

Local filesystem history for orders, outputs, and the active queue so spoken work leaves a readable trail.

macOS voice helper

extension

Optional awake-only helper for speech recognition, file dictation, clap trigger, and spoken replies.

Codex desktop pet

surface

Alfred 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.