ai-dev-terminal
v0.1.1
Published
Interactive terminal CLI that uses Codex to iteratively fix and rerun program failures.
Maintainers
Readme
ai-dev-terminal
ai-dev is a terminal-first CLI that watches command output, detects failures or warnings, streams Codex responses, and reruns your command until it’s clean or you stop it.
Install
From npm (after publish)
npm install -g ai-dev-terminalFrom source
npm install
npm run build
npm install -g .Quick Start
ai-devRun commands inside the interactive UI, or use the one-shot commands below.
Commands
ai-dev Start interactive mode
ai-dev run -- <cmd> Run a command in the current directory
ai-dev start-dev -- <cmd> Run, detect errors/warnings, stream Codex, rerun
ai-dev codex -- <prompt> Send a prompt to Codex (streams output)
ai-dev start-codex-session Resume or start a session for this project
ai-dev new-codex-session Start a fresh session for this project
ai-dev codex-session-path Show session file path for this project
ai-dev codex-session-list List sessions for this project
ai-dev codex-session-use <id> Use a specific session idExamples
ai-dev run -- npm test
ai-dev start-dev -- npm test
ai-dev codex -- "Summarize the build errors above"How start-dev Works
- Runs your command.
- If there are errors or warnings, it streams a Codex response.
- It then re-runs the command.
- The loop stops when there are no errors/warnings, or you press
qbetween iterations.
Notes:
- It does not apply patches to your files. It only streams Codex responses and re-runs.
- Logs are saved under
.ai-dev/logs/<run-id>/.
Sessions
Sessions are stored globally under your home directory:
- Production:
~/.codex/.ai-dev-sessions.json - Development:
~/.codex/.ai-dev-sessions-dev.json(whenNODE_ENVis notproduction)
Each project is keyed by its repo root. Use the session commands above to list or switch.
.gitignore
On startup, ai-dev ensures .gitignore includes entries for:
.ai-dev/.ai-dev/logs/.ai-dev/cache/.ai-dev/history.ai-dev/codex-session.json.ai-dev-sessions.json.ai-dev-sessions-dev.json
Requirements
- Node.js
>=18 @openai/codex-sdkdependency (bundled with this package)
Safety
ai-dev runs the exact command you provide and streams Codex output. It does not apply edits unless you extend it to do so.
License
MIT — see LICENSE.
