bgng db
bgng db sends direct HTTP requests to BeginningDB. Each command accepts either --profile=<id> or explicit connection flags. Mixing the two is an error.
Shared target flags
| Flag | Description |
|---|---|
--profile=<id> | Use a saved direct IDE profile. |
--base-url=<url> | BeginningDB base URL. |
--tenant-id=<n> | Tenant id for x-tenant-id. |
--token=<t> | Bearer token. |
--filesystem-id=<id> | Compute a filesystem path prefix. |
--path-prefix=<p> | Explicit path prefix. |
--raw-paths | Disable prefix rewriting. |
--json | Emit JSON where supported. |
Lifecycle
bgng db health --profile local-dev
bgng db doctor --profile local-dev
health checks /healthz. doctor checks health plus namespace stat.
Read
bgng db stat /readme.md --profile local-dev
bgng db cat /readme.md --profile local-dev
bgng db placements /readme.md --profile local-dev
cat writes the raw response body to stdout.
Write and placement operations
bgng db put /readme.md --body "hello" --profile local-dev
echo "stdin" | bgng db put /stdin.txt --profile local-dev
bgng db mkdir /folder --profile local-dev
bgng db rm /old.md --profile local-dev
bgng db rm /old.md --everywhere --profile local-dev
bgng db mv /old.md /new.md --profile local-dev
bgng db cp /a.md /b.md --profile local-dev
bgng db place /a.md /also-a.md --profile local-dev
bgng db unplace /also-a.md --profile local-dev
unplace refuses to remove the last placement. Plain rm follows server delete semantics.
Search and changes
bgng db search "type system" --profile local-dev
bgng db search "rust" --profile local-dev --mode hybrid --limit 20
bgng db changes --profile local-dev --cursor 42
search supports keyword, vector, and hybrid modes. Vector modes require upstream vector support.