vvbox 0.1.0

Lightweight sandbox runner for macOS 26 using Apple container CLI.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

# Configuration

vvbox loads config in this order:

1. `~/.vvbox/config.yaml` (or `.yml`, `.json`)
2. `vvbox.yaml` (or `.yml`, `.json`) in repo root
3. `--config <path>` override

## Example config

```yaml
image: ubuntu:latest
network: default
workdir: /work
env:
  CI: "1"
ports:
  - "8080:8080"
volumes:
  - source: vvbox:cache
    target: /cache
  - source: ~/.ssh
    target: /root/.ssh
    readonly: true
pre_install:
  - apt-get update
  - apt-get install -y git
run:
  - npm install
  - npm test
services:
  - name: db
    image: postgres:16
    env:
      POSTGRES_PASSWORD: postgres
      POSTGRES_USER: postgres
      POSTGRES_DB: app
    ports:
      - "5432:5432"
    volumes:
      - source: vvbox:pgdata
        target: /var/lib/postgresql/data
```

## Notes

- `pre_install` and `run` execute in a single `sh -lc` shell.
- `run` can be a string or list of commands.
- `vvbox:<name>` creates a persistent volume at `~/.vvbox/volumes/<name>`.
- `services` are optional and intended for simple dependencies.