API Reference
contextdb exposes five interfaces:
- Go SDK: the primary embedded client (
pkg/client) - gRPC API: JSON-over-gRPC on port 7700
- REST API: HTTP/JSON on port 7701
- Python SDK: REST client for Python applications
- TypeScript SDK: REST client for TypeScript/Node.js applications
- Query DSL: Pipe syntax and CQL query languages
The Go SDK supports all four deployment modes (embedded, standard, remote, scaled). The Python and TypeScript SDKs connect to a running contextdb server via the REST API. The Query DSL provides two syntax tiers (pipe and CQL) that compile to the same AST.