# sandlot

A CLI for branch-based development using git worktrees and [Apple Container](https://github.com/apple/container). Each branch gets its own worktree and isolated container.

## Prerequisites

- macOS on Apple Silicon
- [Bun](https://bun.sh)
- [Apple Container](https://github.com/apple/container) (`brew install container`)
- Git

### First-time setup

After installing Apple Container, run `container system start` in your terminal. It will prompt to install the Kata kernel — say yes. This is a one-time step.

## Install

```bash
git clone https://github.com/your/sandlot
cd sandlot
bun install
bun link
alias sl=sandlot
```

## Usage

Run all commands from inside a cloned git repo.

### Start a session

```bash
sandlot new fix-POST
```

Creates a worktree, boots a container, and launches Claude Code inside it.

### Other commands

```bash
sandlot list           # show all sessions
sandlot open <branch>  # re-enter a session
sandlot stop <branch>  # stop a container without destroying it
sandlot rm <branch>    # tear down session (container, worktree, local branch)
```

Use git directly for commits, pushes, merges, etc. The worktree is a normal git checkout.