opensourceagi/dev-tools-starter-agent/open-ready

Claude Code and agent skill by opensourceagi/dev-tools-starter-agent

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Guide to open-ready (packages/open-when-ready), the dev-server wrapper that opens the browser when the server is ready and an AI assistant when it errors — wrapping any CLI command, the default portless integration that serves the app at https://<name>.localhost, the --ai-base / --noAi / --noOpen / --pollDelay / --name / --no-portless / --portless flags, how ready and error signals are detected, and where the log file goes. Use when working with open-ready or troubleshooting it — the browser never opening, opening too early or at the wrong port, an AI tab opening on a harmless log line, the portless URL not being used, or flags being swallowed by the wrapped command.

Install

npx vskill@latest install opensourceagi/dev-tools-starter-agent/open-ready

SKILL.md

Working With open-ready

The wrapper in packages/open-when-ready, published as `open-ready` (bin open-ready, entry open-when-ready.mjs). It spawns your dev command, tees its output to a log file, polls that log, and reacts: browser on ready, AI assistant on error.

Setup

bash
npx open-ready npm run dev      # no install
npm install -g open-ready       # then: open-ready <command>

Node ≥18. It wraps anything that prints to stdout/stderr — next dev, vite, bun run dev, a plain script.

Flags

FlagDefaultEffect
--ai-base <url>https://perplexity.ai?q=Base URL opened on error, with the prompt appended
--noAifalseNever open an AI tab on error
--noOpenfalseNever open the browser on ready
--pollDelay <ms>1200How often the log is re-read
--name <app>inferredApp name for the portless URL
--no-portlessfalseSkip portless even when installed
--portlessfalseUse portless without a TTY / under CI (proxy must already run)

Portless (default when installed)

If a portless binary is found — node_modules/.bin walking up from the cwd, then PATH — and the terminal is interactive (stdin is a TTY, CI unset), open-ready:

  1. Runs portless proxy start attached to the terminal, so the first-run sudo / CA-trust prompt can happen (the wrapped command's stdio is piped and detached, so portless can't prompt from there).
  2. Spawns portless run --name <app> <command>. <app> is --name, else the package.json name without scope, else the directory name — lowercased, non-[a-z0-9-] collapsed to -.
  3. On the ready signal, waits on the framework's own http://localhost:<port> (Node may not trust the portless CA), then opens the URL portless printed (-> https://<app>.localhost, including any worktree prefix or custom TLD).

No portless, a failed proxy start, --no-portless, or a non-interactive run without --portless → the original localhost behaviour. portless itself needs Node ≥ 24; it is not a dependency of open-ready.

How the signals work

  • Error — a log line matching error, failed, exception, SyntaxError, or ⨯. Up to ~1000 characters of surrounding context are extracted into a pre-filled prompt.
  • Ready — a line matching ready - started server or Ready in Xms. The port is then polled until it actually accepts connections before the browser opens.
  • Log file — .next/port.log for Next.js projects, otherwise open-when-ready.log in the current directory.

Recipes

Swap the assistant — open-ready npm run dev --ai-base "https://chatgpt.com/?q=". Any URL that accepts a query string works.

CI or headless — pass both --noOpen and --noAi and it degrades to a plain pass-through runner.

Slow-starting servers — raise --pollDelay to reduce log churn; the ready check waits for the port regardless, so a larger delay costs only detection latency.

In `package.json` — "dev": "open-ready next dev" keeps the behavior for everyone on the team.

Troubleshooting

SymptomCause → fix
Browser never opensYour dev server prints a ready line the matcher doesn't recognize (only Next.js/Vite-style phrasings are matched). Confirm the phrasing in the log file, or open manually — there is no custom-pattern flag.
Browser opens before the app respondsRare, since the port is polled after the ready signal; if the framework prints ready before binding, raise --pollDelay.
An AI tab opens on a benign lineThe error matcher is substring-based, so a log line containing "error" (e.g. an "0 errors" summary) trips it. Use --noAi for noisy servers.
Flags land on the wrapped command insteadEverything after the command is forwarded. Put open-ready's own flags at the end (open-ready npm run dev --noAi) and check the wrapped tool isn't consuming them.
Localhost port opens instead of https://<app>.localhostportless wasn't found on PATH/node_modules/.bin, stdin isn't a TTY / CI is set (pass --portless), or --no-portless was given.
"Could not start the portless proxy"The sudo prompt was declined or port 443 is taken. Start it yourself (portless proxy start, or -p 1355 for no sudo) and rerun.
Nothing at all happensThe wrapped command exited immediately or wrote nothing to stdout/stderr. Run it bare first.
Log file keeps growingIt's a plain append-only file — delete open-when-ready.log / .next/port.log between runs if size matters, and gitignore it.
Output looks buffered or colorlessThe child's output is piped, so tools that detect a TTY may disable colors or batch writes. Force color with the tool's own flag (--color, FORCE_COLOR=1).

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

7-day trend score
0

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/opensourceagi/dev-tools-starter-agent/open-ready/badge)](https://verified-skill.com/skills/opensourceagi/dev-tools-starter-agent/open-ready)

Something wrong with this skill or its page? Tell us.