nolanmak

Agentflow — Development skill for Claude Code

Development community

Local voice conversations with existing Claude Code and Codex sessions, with swappable BYOK speech providers.

How to install Agentflow

This entry records only its repository, not the path inside it, so there is no exact command to give. Open nolanmak/Agentflow and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agentflow does

Local voice conversations with existing Claude Code and Codex sessions, with swappable BYOK speech providers.

Alternatives in Development

Coding Agent Session Search — Unified TUI and CLI to index and search your local coding agent session history across 11+ providers (Codex, C 708 ★
Mulmoterminal — Run multiple Claude Code and Codex sessions in parallel — a browser terminal grid that shows which agent needs 187 ★
Voice Guard — Use to check ONE already-written piece of copy against a voice guide before it ships — it spawns ONE fresh sib 130 ★

README

Agentflow

Speak to native Codex and Claude Code sessions on your Mac. The local service provides speech input/output, a session dashboard, and terminal/MCP speech tools.

[Dashboard](http://127.0.0.1:4317) · [Repository](https://github.com/nolanmak/Agentflow) · [Issues](https://github.com/nolanmak/Agentflow/issues) · [Validation and limitations](docs/VALIDATION.md)

Run

Requires macOS, Node 22.18 or newer, and installed/authenticated native `codex` and `claude` CLIs. Tested locally with Node 26.5.1.

npm ci
npm run build
mkdir -p "$HOME/.local/bin"
ln -sf "$PWD/dist/src/cli.js" "$HOME/.local/bin/agentflow"
node dist/src/cli.js service install
node dist/src/cli.js open

Add `~/.local/bin` to your shell PATH to use `agentflow`. The install command enables login startup. The microphone remains off until explicitly started.

agentflow run codex             # native terminal shared with the dashboard
agentflow run claude
agentflow run codex --resume NATIVE_SESSION_UUID
agentflow speak --text "The tests passed."
agentflow speak --speed 2 --text "Say this twice as fast."
printf 'The tests passed.\n' | agentflow speak
agentflow service status
agentflow service restart
agentflow service uninstall

`Ctrl+]` detaches an Agentflow terminal view and leaves its native process running. Service restart/stop terminates processes that service owns, so detach does not mean restarting the service is safe for an active turn.

Same native conversation

Agentflow-managed sessions have one native CLI process with terminal and browser views. User transcripts go unchanged into that process; no separate inference model or voice persona is inserted. Native tools, settings, cwd, and approvals remain in the native CLI. Approve native permission/trust prompts in its terminal panel.

Already-running external **Codex** sessions accept voice through native `codex queue`; the existing terminal stays open. This was tested live. Raw screen mirroring is available for Agentf