Run TypeScript scripts
with inline dependencies

No package.json needed. Just declare your npm packages in comments and run. Inspired by PEP 723 and uv.

hello.ts

#!/usr/bin/env buns
// buns
// packages = ["chalk@^5.0"]

import chalk from "chalk";

console.log(chalk.green("Hello from buns!"));

Dependencies auto-installed • Cached for reuse

Scripts that just work

Everything you need to run standalone TypeScript scripts without the ceremony.

Declare npm packages directly in your script comments. They're automatically installed and cached the first time you run.

Pin specific Bun versions per script. Missing versions are automatically downloaded from official releases.

Dependencies are stored in a content-addressed cache. Same packages across scripts share a single installation.

No package.json. No tsconfig.json. No node_modules. Just write your script and run it.

Run untrusted scripts safely with built-in sandboxing. Control filesystem access, network, and resource limits.

Restrict read and write access to only the paths your scripts need

Block all network access or allow only specific hosts with wildcards

Set memory, CPU time, and execution timeout limits per script

$ buns script.ts --sandbox --allow-read /data --allow-write /tmp

Uses sandbox-exec on macOS, bubblewrap on Linux

Choose your preferred installation method.

Homebrew (Recommended)

brew install eddmann/tap/buns

Quick Install

curl -fsSL https://raw.githubusercontent.com/eddmann/buns/main/install.sh | sh

Direct Download

Terminal

$ buns hello.ts
Hello from buns!