open-ready

Smart dev server launcher: error→AI search, success→auto-open browser. Any CLI tool.

🤖 Agent skill — npx skills@latest add https://github.com/OpenSourceAGI/dev-tools-starter-agent --skill open-ready (what it covers)

Smart dev server launcher that watches your server's output and automatically opens the browser when ready — or opens an AI assistant with the error context when something goes wrong.

Works with Next.js, Vite, and any CLI-based dev server.

Install

npm install -g open-ready
# or use without installing:
npx open-ready <your-dev-command>

Usage

open-ready <command> [options]

Examples

open-ready npm run dev
open-ready bun run dev
open-ready vite
open-ready next dev

Options

Flag	Default	Description
`--ai-base <url>`	`https://perplexity.ai?q=`	AI assistant base URL to open on error
`--noAi`	`false`	Disable opening AI on error
`--noOpen`	`false`	Disable opening browser when ready
`--pollDelay <ms>`	`1200`	How often to poll the log for ready/error signals

Disable AI on error

open-ready npm run dev --noAi

Use a different AI assistant

open-ready npm run dev --ai-base "https://chatgpt.com/?q="

How it works

Spawns your dev command and pipes its stdout/stderr to a log file
Polls the log every pollDelay ms looking for:
- Error signal — lines matching error, failed, exception, SyntaxError, or ⨯
- Ready signal — lines matching ready - started server or Ready in Xms
On error: extracts up to ~1000 chars of surrounding context and opens your AI assistant with a pre-filled prompt explaining the error and asking for a fix
On ready: waits for the port to be reachable, then opens the local URL in your default browser

For Next.js projects, the log is written to .next/port.log; otherwise open-when-ready.log in the current directory.

License

MIT

Please star this repo for updates! 🌟

Source: packages/open-when-ready/README.md

On this page