Files

gavrielc b539fddbcb docs: v2 architecture design — session DB, channel adapters, agent provider

Three documents covering the complete v2 architecture:

- v2-architecture-draft.md: Core design (per-session SQLite as sole IO,
  two-level DB, entity model, channel adapters with Chat SDK bridge,
  container lifecycle, message flow, interactive operations, routing,
  flexibility model with PR Factory example)

- v2-api-details.md: Channel adapter interface definitions, Chat SDK
  bridge implementation, native channel example, message content
  format examples, host delivery logic

- v2-agent-runner-details.md: AgentProvider interface (stream-in/out),
  provider implementations (Claude, Codex, OpenCode), poll loop, MCP
  tool definitions, message formatting, media handling, container
  startup

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-08 23:07:33 +03:00

APPLE-CONTAINER-NETWORKING.md

Add Apple Container Networking Setup documentation (#178 )

2026-02-12 10:55:31 +02:00

BRANCH-FORK-MAINTENANCE.md

docs: warn about silently wrong auto-merges in maintenance guide

2026-03-28 15:59:57 +03:00

DEBUG_CHECKLIST.md

Merge branch 'main' into docs/k8s-image-gc-known-issue

2026-03-27 16:56:25 +03:00

docker-sandboxes.md

fix: correct Docker Sandboxes documentation URL

2026-03-13 12:03:27 +02:00

README.md

docs: update outdated documentation, add docs portal links

2026-03-24 10:40:04 +01:00

REQUIREMENTS.md

docs: add Windows (WSL2) to supported platforms

2026-03-24 10:48:18 +01:00

SDK_DEEP_DIVE.md

Adds Agent Swarms

2026-02-09 02:50:43 +02:00

SECURITY.md

feat: mount store rw for main agent and add requiresTrigger to register_group

2026-04-03 16:17:57 +03:00

skills-as-branches.md

docs: update contributing guidelines and skill type taxonomy

2026-03-21 13:08:42 +02:00

SPEC.md

fix: setup registration — use initDatabase/setRegisteredGroup, .ts imports, correct CLI commands

2026-03-10 22:51:40 +02:00

v2-agent-runner-details.md

docs: v2 architecture design — session DB, channel adapters, agent provider

2026-04-08 23:07:33 +03:00

v2-api-details.md

docs: v2 architecture design — session DB, channel adapters, agent provider

2026-04-08 23:07:33 +03:00

v2-architecture-draft.md

docs: v2 architecture design — session DB, channel adapters, agent provider

2026-04-08 23:07:33 +03:00

README.md

NanoClaw Documentation

The official documentation is at docs.nanoclaw.dev.

The files in this directory are original design documents and developer references. For the most current and accurate information, use the documentation site.

This directory	Documentation site
SPEC.md	Architecture
SECURITY.md	Security model
REQUIREMENTS.md	Introduction
skills-as-branches.md	Skills system
DEBUG_CHECKLIST.md	Troubleshooting
docker-sandboxes.md	Docker Sandboxes
APPLE-CONTAINER-NETWORKING.md	Container runtime