47 lines
1.1 KiB
Markdown
47 lines
1.1 KiB
Markdown
# 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
|
|
```
|
|
|
|
## 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.
|