# 14-dev-runner

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.

- prompt · `type=prompt` · Claude Code, ChatGPT · ★ 3444 repo stars
- Author: codeaashu
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codeaashu/claude-code/tree/HEAD/prompts/14-dev-runner.md
- Updated: 2026-10-14
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/prompts/14-dev-runner

## What it 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`.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/14-dev-runner.md`

### ChatGPT

**How to use**
- Paste the text at the start of a chat or into project instructions

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/codeaashu/claude-code/tree/HEAD/prompts/14-dev-runner.md

## When to use it
- 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
- Execute `.claude/commands/14-dev-runner.md` to set up our Bun development launcher
- Follow /14-dev-runner to create `scripts/dev.ts` and configure the module alias

## Similar
- [bun-shell](https://affpapa.org/en/nevibecode/skills/bun-shell.md) — skill · 413 installs
- [netlify-agent-runner](https://affpapa.org/en/nevibecode/skills/netlify-agent-runner.md) — skill · 2800 installs
- [bun-runtime](https://affpapa.org/en/nevibecode/skills/secondsky-bun-runtime.md) — skill · 435 installs
- [create-headless-agent](https://affpapa.org/en/nevibecode/skills/create-headless-agent.md) — skill · 320 installs
- [write-script-bun](https://affpapa.org/en/nevibecode/skills/write-script-bun.md) — skill · ★ 18673 repo stars
- [npx-cli](https://affpapa.org/en/nevibecode/skills/npx-cli.md) — skill · 309 installs

From the same set: [codeaashu/claude-code](https://affpapa.org/en/nevibecode/by/codeaashu/claude-code.md) — 17 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
