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
.claude/agents/bun-expert.mdWhat 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.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/bun-expert.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/bun-expert.mdCursor also reads .claude/agents/
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