bun

Bun is a fast, all-in-one JavaScript runtime, bundler, test runner, and package manager designed as a drop-in replacement for Node.js. When working on projects that use Bun, AI agents should leverage its integrated tooling and native APIs to maximize performance and simplify development.

This skill synthesizes the best practices for Bun development, giving you the context needed to effectively write, test, and build applications.

---

🚀 1. Package Management (bun install)

Bun features a deeply optimized package manager. Always use bun commands instead of npm, yarn, or pnpm if a project has bun.lockb or bun.lock.

• Install all dependencies: bun install
• Add a package: bun add <package> (Use -d or --dev for devDependencies)
• Remove a package: bun remove <package>
• Run binaries: bunx <command> (The blazing fast equivalent of npx)

Agent Directive: Never run npm install gracefully if bun.lockb is present. Always opt for bun add.

---

⚡ 2. Script Execution (bun run)

Run scripts from package.json lightning fast:

bun run dev
bun run build

Run TypeScript and JavaScript files natively—no ts-node, tsc, or build step required:

bun run scripts/setup.ts
bun index.tsx

---

🌐 3. Core Runtime APIs

Bun provides deeply optimized, native APIs under the Bun global and bun:* modules.

HTTP Server (Bun.serve)

Use Bun.serve() as the default over Node's http or express for simple tasks.

const server = Bun.serve({
  port: 3000,
  fetch(req) {
    const url = new URL(req.url)
    if (url.pathname === '/') return new Response('Hello World!')
    if (url.pathname === '/json') return Response.json({ success: true })
    return new Response('Not Found', { status: 404 })
  },
})
console.log(`Listening on localhost:${server.port}`)

File I/O (Bun.file(), Bun.write())

Skip fs module when possible. Use Bun's native lazy-loaded File I/O.

const file = Bun.file('package.json')
const text = await file.text()
const json = await file.json()

// Writing
await Bun.write('output.txt', 'Hello world!')
await Bun.write('data.json', JSON.stringify({ a: 1 }))