Storage Overview

AIWG storage subsystem

Storage Documentation

Prompt-first procedure: Describe the outcome you want in your agent conversation. The agent should select and load the appropriate AIWG assets, explain material changes, request any needed approval, and report verification evidence. Exact commands and flags appear only in the CLI reference.

AIWG stores project artifacts on the local filesystem by default. These pages explain when to keep that default, when to route a subsystem to another backend, and how to verify storage behavior before relying on it.

Start with Overview if you are choosing a backend. Use Security before adding external services or credential-backed configuration.

Pages

  • Overview — what the storage system does, quick start, CLI surface, what's implemented vs deferred
  • Security — credential handling, path traversal rejection, atomic writes, doctor validation
  • Migration — the agent-owned storage operation command walkthrough
  • Direct PostgreSQL — advanced canonical backend, roles, TLS, migration, and qualification
  • PostgreSQL through PostgREST — optional HTTP transport, RPC boundaries, RLS, and limits
  • Scalable backend contract — versioned capabilities,

data classes, consistency, and backend maturity

offline/online migration, approval, cutover, and rollback

Per-backend pages

BackendPageStatus
`fs`backends/fs.mdREADY (default)
`obsidian`backends/obsidian.mdREADY
`logseq`backends/logseq.mdREADY
`fortemi`backends/fortemi.mdREADY (alpha; legacy for search)
`notion`backends/notion.mdSTUB (#959)
`anythingllm`backends/anythingllm.mdSTUB (#960)
`s3`backends/s3.mdSTUB (#962)
`webdav`backends/webdav.mdSTUB (#963)

Reference