onto_ingest`). DuckDB acts as a federation backbone via its `httpfs`/`parquet`/`csv`/`postgres_scanner`/`iceberg` extensions. Connection strings: `postgres://…`, `duckdb:///path.duckdb`, `:memory:`, or `*.duckdb` file path. |
| `onto
deviate without explicit user approval.
1. **Data persistence**: Always use Supabase (production) or local Postgres (dev) for any multi-user data. **NEVER use localStorage as the primary data layer
alembic` step.
- Prod DB is **Neon** (`stash-prod`, id `little-scene-08473932`), not Render Postgres. Query read-only via the Neon MCP.
- `docker-compose.prod.yml` and the **GHCR images are for self
github/workflows/docker-image.yml`) — never under QEMU emulation.
## Commands
Root:
```bash
pnpm dev # full local stack: Neo4j+Postgres (docker), core (watch), dashboard (vite), drizzle studio
pnpm build # recursive build of all packages
pnpm
onboarding to the first governed action.
## Tech stack
- Node 20+, Next.js 16 (App Router), Postgres (Neon recommended).
- Versions live in their manifests (`package.json`, `sdk/package.json`, `sdk-python/pyproject.toml`, `plugins/dashclaw/.claude-plugin/plugin.json
Next rewrite to the backend.
- `backend/` - Bun + Hono + Postgres/Drizzle control plane: event-sourced
runs/steps (Postgres is the source of truth), replaceable engine adapters
(`src/engines/`) spawned one-shot per run, worker
generates keys/TLS + the dev-idp RSA key, starts the Docker infra, and runs the Postgres + ClickHouse migrations and finally starts all local services. Run it per session after starting
fundamentally faster and smarter than bolt-on AI features.
One Next.js app. One Postgres database. Multi-tenant SaaS with org_id on every table.
Licensed under the GNU Affero General
A file Claude Code reads at the start of every session. It holds the commands, conventions and warnings the agent needs for this project.
Where does it go?
At the repository root. Claude Code also reads CLAUDE.md files in subdirectories when it works there.
What should it contain?
Build and test commands, the project's layout, conventions that aren't obvious from the code, and mistakes to avoid. Short files tend to work better than long ones.
CLAUDE.md or AGENTS.md?
Claude Code reads CLAUDE.md; most other agents read AGENTS.md. Many projects keep one and point the other at it.