14-dev-runner — Claude Code prompt: what it does, how to install
The 14-dev-runner prompt configures a development runner for Claude Code to execute TypeScript directly with Bun. It eliminates the need for full production builds during iterative work.
no license ★ 3,444 updated 2026-10-14
.claude/commands/14-dev-runner.mdWhat 14-dev-runner does
The instructions walk through setting up a fast development launcher using Bun's native TypeScript support. It creates scripts/dev.ts and wires up dev, dev:repl, and start inside package.json. That way, the CLI starts instantly without waiting for a compilation pass.
A central hurdle is resolving the bun:bundle import during development. The prompt directs the agent to test a bunfig.toml path alias, a custom loader plugin, or a temporary transform step. It also configures .env loading and adds a dev:debug script powered by CLAUDE_CODE_DEBUG_LOG_LEVEL=debug.
Without pre-installed runtime shims and Bun itself in /workspaces/claude-code, the dev runner will break on import errors. Testing involves running --version, --help, and a test prompt using ANTHROPIC_API_KEY.
What it helps with
- run TypeScript CLI files directly via Bun without bundling
- resolve bun:bundle imports during local development
- configure dev and dev:debug commands in package.json
- verify CLI flags and environment variables against Anthropic API
Example prompts for the agent
- Execute
.claude/commands/14-dev-runner.mdto set up our Bun development launcher - Follow /14-dev-runner to create
scripts/dev.tsand configure the module alias
How to install 14-dev-runner
Manually: put the files in place
.claude/commands/14-dev-runner.mdHow to use
Paste the text at the start of a chat or into project instructions
Questions about 14-dev-runner
How to install 14-dev-runner in Claude Code?
Place the prompt file at .claude/commands/14-dev-runner.md. You can then trigger it as a slash command within Claude Code.
What does 14-dev-runner do?
It sets up an executable dev runner using Bun to launch the CLI without full builds. It handles module shims, sets up npm scripts, and validates startup flags.
What dependencies are required beforehand?
The workspace requires Bun installed alongside runtime shims for MACRO and bun:bundle. You also need an ANTHROPIC_API_KEY defined in .env.