CLI Reference

Dynoxide has three subcommands: serve (the default), mcp, and import.

serve

Starts the HTTP server. This is the default - running dynoxide with no subcommand does the same thing.

dynoxide --port 8000
dynoxide --db-path data.db --port 8000

Key flags:

mcp

Starts the MCP (Model Context Protocol) server for coding agents. See the MCP docs for the full setup guide.

dynoxide mcp
dynoxide mcp --http --port 19280

Stdio transport is the default. Use --http for the Streamable HTTP transport.

import

Imports data from a DynamoDB Export (the S3 export format). Useful for creating local snapshots of production data.

dynoxide import \
  --source ./export-data/ \
  --schema schema.json \
  --output snapshot.db

The --schema flag takes a DescribeTable JSON output. The --source flag points to the directory of exported JSON files.

Anonymisation is built in - you can mask, hash, redact, or replace fields with fake data:

dynoxide import \
  --source ./export/ \
  --schema schema.json \
  --rules rules.toml \
  --output anonymised.db

The rules file uses TOML format. Available actions: fake, mask, hash, redact, and null.

For the full list of flags and anonymisation options, see the README.