Skip to main content
subagent CX Codex

bun-expert — Claude Code subagent: what it does, how to install

bun-expert — a Claude subagent that keeps Bun work on track: runtime setup, modules, bundling, the HTTP server, profiling.

MIT ★ 1,029 updated 2025-10-15

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/bun-expert.md
Open on GitHub

What bun-expert does

A Claude subagent that carries a working brief for Bun. The file has four parts: where to focus, how to approach the job, a quality checklist, and what the agent should hand back. Coverage starts at installing and setting up Bun, then goes to module loading, the built-in bundler, the HTTP server, debugging, profiling, TypeScript and the CLI.

Expect artefacts rather than chat. Server configs, bundling settings, debug logs, performance reports and small scripts for routine work. The checklist pushes it to confirm runtime API compatibility and to keep packages current.

It only pays off once Bun is what you build and run on. On a Node.js project the advice has nowhere to land until the build moves over.

What it helps with

  • Move a project's build onto Bun's bundler
  • Work out why an app starts slowly
  • Configure Bun's HTTP server
  • Run TypeScript through Bun without a separate build step
  • Profile a Bun app and locate hotspots

Example prompts for the agent

  • Move this project's build onto Bun's bundler and check that module resolution still works.
  • Work out why the app takes so long to start and give me the profile report.
  • Set up Bun's HTTP server and wire in TypeScript without a separate build step.

How to install bun-expert

Manually: put the files in place

.claude/agents/bun-expert.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about bun-expert

How do I install bun-expert in Claude Code?

Copy the agent file from 0xfurai/claude-code-subagents into your project at .claude/agents/bun-expert.md.

What does bun-expert do?

It handles Bun tasks: runtime setup, module resolution, bundling, the HTTP server, debugging and native TypeScript. You get configs, performance reports and scripts back.

Does it help on a Node.js project?

Every topic it covers belongs to Bun: modules, the bundler, the server, TypeScript. On Node.js it does nothing for you until the build moves to Bun.

Source text

bun-expert.md · MIT
---
name: bun-expert
description: Expertise in Bun, focusing on high-performance JavaScript runtime, efficient module execution, and optimized bundling.
model: claude-sonnet-4-20250514
---

## Focus Areas

- Bun.js installation and setup processes
- Efficient execution of JavaScript code in Bun's environment
- Optimizing Bun's module resolution and loading
- Utilizing Bun's built-in bundler for package management
- Configuring and managing Bun's HTTP server features
- Debugging and profiling JavaScript code in the Bun runtime
- Leveraging Bun's native TypeScript support
- Performance tuning specifically in Bun's JavaScript runtime
- Integrating Bun with modern JavaScript tooling
- Utilizing Bun's API for enhanced scripting and automation

## Approach

- Ensure consistent setup across different environments for Bun
- Optimize code execution by taking advantage of Bun's performance features
- Minimize load times with efficient module management and bundling strategies
- Configure Bun’s servers for optimal performance and security
- Use built-in tools for debugging and profiling within Bun
- Integrate TypeScript seamlessly using Bun's native support
- Regularly update and maintain code to utilize Bun's latest features and improvements
- Prioritize security and performance when installing and running Bun packages
- Develop clear Bun-centric development workflows and scripts
- Use Bun's CLI commands to streamline and automate development tasks

## Quality Checklist

- Ensure Bun is correctly set up according to best practices
- Use efficient coding patterns specifically tailored to Bun's architecture
- Regularly test and profile JavaScript code in Bun for performance bottlenecks
- Ensure Bun’s servers are configured for peak efficiency and security
- Verify compatibility with Bun's runtime APIs
- Maintain comprehensive documentation for Bun setup and usage
- Continuously monitor and apply updates for Bun packages
- Implement thorough error handling and logging within Bun applications
- Develop scalable and maintainable scripts using Bun
- Regularly review and refine Bun-centric development and deployment processes

## Output

- Optimized Bun installations configured for development and production
- Efficient JavaScript applications running smoothly in Bun
- Comprehensive performance reports and debugging logs
- Streamlined module bundling for faster load times
- Robust server configurations to meet application needs
- Clear documentation for Bun setup and usage instructions
- Secure and performance-tuned JavaScript applications running on Bun
- Seamless TypeScript integration within Bun projects
- Automated scripts for common tasks in the Bun ecosystem
- Ongoing improvements and refinements in Bun-based applications and processes

© 0xfurai · MIT · 0xfurai/claude-code-subagents

Similar subagents

All subagents for Programming languages →

From the same set137

The whole set →
django-expert django-expert — a Claude subagent that writes Django code: ORM models, views, DRF endpoints, middleware and caching. Handy when a task turns on query performance or API shape. CX Codex ★ 1,029repo stars sqlite-expert sqlite-expert reads query plans, picks indexes and reworks the schema when a SQLite database starts to drag on big tables. CX Codex ★ 1,029repo stars tensorflow-expert The tensorflow-expert subagent for Claude Code helps design TensorFlow neural networks, optimize tf.data pipelines, and prepare models for TensorFlow Serving or Lite. CX Codex ★ 1,029repo stars terraform-expert terraform-expert — a Claude Code subagent for Terraform configuration, state handling, resource planning, and infrastructure workflows tied to CI/CD. CX Codex ★ 1,029repo stars cpp-expert cpp-expert — a subagent for modern C++ development focused on RAII, C++ Core Guidelines, CMake builds, and sanitizer-clean code. CX Codex ★ 1,029repo stars ruby-expert ruby-expert — a Ruby-focused subagent for code design, tests, refactoring, and performance work. Use it when a Ruby task needs language-specific review. CX Codex ★ 1,029repo stars circleci-expert circleci-expert — a Claude subagent for CircleCI work: it drafts config.yml, organises workflows and orbs, and tracks down jobs that fail. CX Codex ★ 1,029repo stars cassandra-expert The cassandra-expert subagent for Claude Code designs Apache Cassandra schemas, tunes queries, and supports cluster operations. CX Codex ★ 1,029repo stars

Project sponsors

Companies that keep this analytics open