Files

gavrielc c6e1bfecc6 refactor: extract runtime-specific code into src/container-runtime.ts (#321 )

Move all container-runtime-specific logic (binary name, mount args,
stop command, startup check, orphan cleanup) into a single file so
swapping runtimes only requires replacing this one file.

Neutralize "Apple Container" references in comments and docs that
would become incorrect after a runtime swap. References that list
both runtimes as options are left unchanged.

No behavior change — Apple Container remains the default runtime.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-20 13:13:55 +02:00

1.9 KiB

Raw Blame History

NanoClaw

Personal Claude assistant. See README.md for philosophy and setup. See docs/REQUIREMENTS.md for architecture decisions.

Quick Context

Single Node.js process that connects to WhatsApp, routes messages to Claude Agent SDK running in containers (Linux VMs). Each group has isolated filesystem and memory.

Key Files

File	Purpose
`src/index.ts`	Orchestrator: state, message loop, agent invocation
`src/channels/whatsapp.ts`	WhatsApp connection, auth, send/receive
`src/ipc.ts`	IPC watcher and task processing
`src/router.ts`	Message formatting and outbound routing
`src/config.ts`	Trigger pattern, paths, intervals
`src/container-runner.ts`	Spawns agent containers with mounts
`src/task-scheduler.ts`	Runs scheduled tasks
`src/db.ts`	SQLite operations
`groups/{name}/CLAUDE.md`	Per-group memory (isolated)
`container/skills/agent-browser.md`	Browser automation tool (available to all agents via Bash)

Skills

Skill	When to Use
`/setup`	First-time installation, authentication, service configuration
`/customize`	Adding channels, integrations, changing behavior
`/debug`	Container issues, logs, troubleshooting

Development

Run commands directly—don't tell the user to run them.

npm run dev          # Run with hot reload
npm run build        # Compile TypeScript
./container/build.sh # Rebuild agent container

Service management:

launchctl load ~/Library/LaunchAgents/com.nanoclaw.plist
launchctl unload ~/Library/LaunchAgents/com.nanoclaw.plist

Container Build Cache

The container buildkit caches the build context aggressively. --no-cache alone does NOT invalidate COPY steps — the builder's volume retains stale files. To force a truly clean rebuild, prune the builder then re-run ./container/build.sh.

1.9 KiB Raw Blame History