The Complete Production SOP: How to Deploy and Run Bun Shell Cross-Platform Bash-Like Scripting in JS in Autonomous AI Agents

---
name: "bun-shell-scripting-automation"
description: "Write cross-platform automation scripts using Bun Shell with native pipes and redirects."
metadata:
  author: "Jarred Sumner"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "write bun shell script"
  - "pipe commands bun shell"
  - "cross-platform bash javascript"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# Bun Shell Cross-Platform Bash-Like Scripting in JS

Authors automation scripts using Bun Shell ($ tagged template): executing shell commands cross-platform on Windows and Linux, piping outputs into JavaScript variables, redirecting to files, and running tasks concurrently.

## When to Invoke
Invoke this skill whenever you need to:
- write bun shell script
- pipe commands bun shell
- cross-platform bash javascript

## Execution SOP & Rules
1. Import shell operator: import { $ } from 'bun'.
2. Execute commands: await $`echo 'Starting build...' && pnpm build`.
3. Capture output: const stdout = (await $`git rev-parse HEAD`.text()).trim().
4. Pipe streams: await $`cat log.txt | grep 'ERROR' > filtered_errors.txt`.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.

import { $ } from "bun";

// Explicitly enforce environment context without string concatenation
const branch = (await $`git rev-parse --abbrev-ref HEAD`.text()).trim();
const commitHash = (await $`git rev-parse --short HEAD`.text()).trim();

console.log(`Executing pre-flight checks for branch: ${branch} (${commitHash})`);

// Chained env injection and error trapping
await $`bun test`
  .env({ ...process.env, CI: "true", DEPLOY_TARGET: branch })
  .quiet();

# Test agent trigger invocation via Claude Code CLI
claude "write bun shell script to parse build logs, pipe commands bun shell to filter errors, and write to filtered_errors.txt"

import { $ } from "bun";

try {
  // Non-zero exit codes throw ShellError by default; use .nothrow() when failures are expected
  const result = await $`git diff --staged --exit-code`.nothrow();
  if (result.exitCode !== 0) {
    console.warn("Uncommitted staged changes detected.");
  }
} catch (error: any) {
  console.error(`Script pipeline crashed: ${error.message}`);
  process.exit(1);
}