zeptoclaw 0.9.0

Ultra-lightweight personal AI assistant
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
51
52
53
54
55

# Containerized Devtools (Podman Rootless)

## Quick Setup

**Podman** rootless (docker dropped).

**Admin (one-time)**: `usermod --add-subuids 100000-165535 --add-subgids 100000-165535 $USER; podman system migrate`

**sccache (required)**:
Host: `curl -sSf https://raw.githubusercontent.com/mozilla/sccache/master/install.sh | sh`
Env: `export RUSTC_WRAPPER=sccache && source ~/.bashrc`

## Usage

```bash
# Tests
./scripts/test-container.sh lib                    # cargo nextest --lib
./scripts/test-container.sh integration            # cargo test
./scripts/test-container.sh all extra args...      # nextest lib + test + passthru

# Lint (AGENTS.md gates)
./scripts/lint-container.sh                        # clippy/fmt/doc

# Bench
./scripts/bench-container.sh                       # cargo bench message_bus --no-run

# Podman
CONTAINER_RUNTIME=podman ./scripts/test-container.sh lib

# sccache
./scripts/test-container.sh lib --sccache
```

## Cache Prune

**Docker:** `docker builder prune --filter type=cache`

**Podman:** `podman volume prune` (or `podman volume rm zeptoclaw-*`)

## Pre-Push Workflow (Recommended)

```bash
./scripts/lint-container.sh
./scripts/test-container.sh lib
./scripts/bench-container.sh
```

Add to .git/hooks/pre-push for auto.

## Troubleshooting

- Slow first run: Image pull/deps.
- Podman vols missing: Create above.
- sccache miss: Host env set?
- Integrity: `cargo clean` + prune if stale.