whatisgithub

What is real-time-design?

pmarquees/real-time-design — explained in plain English

Analysis updated 2026-05-18

3JavaScriptAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A terminal tool that lets a developer code by voice, turning spoken instructions into tasks for Codex or Claude Code CLI.

Mindmap

mindmap
  root((repo))
    What it does
      Voice to coding tasks
      Dispatches to coding CLI
      Parallel agent runs
    Tech stack
      Node.js
      OpenAI Realtime API
      Codex CLI
      Claude CLI
    Use cases
      Hands-free coding
      Quick multi-part edits
      Barge-in corrections
    Audience
      Developers
    Setup
      npm install global
      Needs OpenAI API key
    Notes
      Early prototype
      Can conflict on same files

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Make small hands-free code edits by speaking instructions in a terminal.

USE CASE 2

Run several independent coding tasks in parallel from one spoken request.

USE CASE 3

Correct or cancel an in-progress AI coding task by talking over it.

USE CASE 4

Drive Codex or Claude Code CLI without typing prompts manually.

What is it built with?

Node.jsOpenAI Realtime APICodex CLIClaude CLISoX

How does it compare?

pmarquees/real-time-designamarjitjim/browserpilotboneskull/buggin
Stars333
LanguageJavaScriptJavaScriptJavaScript
Last pushed2022-12-30
MaintenanceDormant
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs an OpenAI API key plus a working Codex or Claude CLI login and a microphone.

The README does not state license terms.

So what is it?

Real Time Design is a terminal tool that lets a developer code by talking out loud instead of typing. A person opens it inside a project folder, speaks continuous coding instructions, and the tool turns that speech into structured tasks that get handed off to a coding assistant CLI, such as Codex or Claude Code, which then makes the actual edits to the repo. The voice side works through the OpenAI Realtime API, which streams microphone audio and uses voice activity detection to figure out when a spoken instruction is finished. It extracts a structured task from that speech, things like edit header, run tests, or create component, and if someone gives several instructions in one breath, it can split them into separate independent tasks. Up to four coding agents can run at the same time by default, so unrelated requests like changing a color, adjusting spacing, and running a typecheck can all happen in parallel. The voice model itself never writes any code, it only decides whether speech contains something actionable, and Real Time Design routes that decision to whichever coding CLI is doing the actual editing. A useful feature is barge-in correction. If someone says "make the header red" and then immediately says "actually make it blue instead," the first task is stopped and restarted using the correction. Saying something like "stop that" or "never mind" cancels a task outright instead of restarting it. The tool shows a compact terminal interface with the current listening state, the tasks that have been created, and each agent's status. Getting started requires Node.js 20 or newer, a working login for Codex or Claude CLI, an OpenAI API key for the realtime voice connection, a microphone, and on macOS the SoX audio tool if local capture needs it. After installing the package globally and adding an OpenAI key to a local .env file inside the target project, running the rtd command starts a voice coding session there. The author describes this as an early prototype. The core loop works, but barge-in detection is described as heuristic, agent progress is inferred rather than tracked precisely, and parallel agents can conflict if asked to edit the same files at once. Because it can edit real files, the README recommends committing or stashing work before using it heavily.

Copy-paste prompts

Prompt 1
Help me install real-time-design and set up my OpenAI API key to try voice coding.
Prompt 2
Explain how barge-in corrections work in real-time-design when I talk over an active task.
Prompt 3
Show me how to switch real-time-design between the Codex and Claude backends.
Prompt 4
Walk me through running multiple parallel agents with real-time-design's --max-agents flag.

Frequently asked questions

What is real-time-design?

A terminal tool that lets a developer code by voice, turning spoken instructions into tasks for Codex or Claude Code CLI.

What language is real-time-design written in?

Mainly JavaScript. The stack also includes Node.js, OpenAI Realtime API, Codex CLI.

What license does real-time-design use?

The README does not state license terms.

How hard is real-time-design to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is real-time-design for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.