# Sandboxer

> Manage Claude Code terminal sessions via Sandboxer web dashboard. Use when: (1) listing running Claude Code sessions, (2) checking what a Claude session is doing, (3) sending commands to a Claude session, (4) creating or killing sessions, (5) user mentions 'sandboxer' or 'session'.

- Skill: `kbarbel640-del/sandboxer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add kbarbel640-del/sandboxer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/sandboxer/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/kbarbel640-del/sandboxer

---


# Sandboxer

Manage Claude Code sessions running in tmux via HTTP API.

**All commands run locally - no SSH needed.**

## Health Check (Run First!)

Before using any commands, verify Sandboxer is running:

```bash
curl -sf http://localhost:8081/api/sessions >/dev/null && echo "✓ Sandboxer is running" || echo "✗ Sandboxer not reachable"
```

**If Sandboxer is not reachable:**

```
✗ Sandboxer is not installed or not running on this machine.

To install Sandboxer, run:
  claude --dangerously-skip-permissions "clone github.com/chriopter/sandboxer to /home/sandboxer/git/sandboxer, read README.md for install instructions, then install sandboxer"

To start if already installed:
  sudo systemctl start sandboxer

See: https://github.com/chriopter/sandboxer
```

## List Sessions

```bash
curl -s http://localhost:8081/api/sessions | jq
```

Filter by project:

```bash
curl -s http://localhost:8081/api/sessions | jq '.[] | select(.name | contains("PROJECT"))'
```

## Read Session Output

See what Claude is doing:

```bash
tmux capture-pane -t "SESSION_NAME" -p | tail -80
```

## Send Command to Session

Forward user requests to Claude Code:

```bash
tmux send-keys -t "SESSION_NAME" "implement feature X" Enter
```

Then wait 10-30s and read output to check result.

## Create Session

```bash
curl -s "http://localhost:8081/create?type=claude&dir=/path/to/project"
```

Types: `claude`, `bash`, `lazygit`

## Kill Session

```bash
curl -s "http://localhost:8081/kill?session=SESSION_NAME"
```

## Workflow: Forward Tasks to Claude

When user says "do X" or "implement Y":

1. Find the right session: `curl -s http://localhost:8081/api/sessions | jq`
2. Send command: `tmux send-keys -t "SESSION" "do X" Enter`
3. Wait 10-30 seconds
4. Read result: `tmux capture-pane -t "SESSION" -p | tail -80`
5. Report back to user

## Web Dashboard

URL: `https://YOUR_SERVER:8080`

Shows live terminal previews. May require password.

## Installation

See [GitHub README](https://github.com/chriopter/sandboxer#install) for setup instructions.