dynamodb-axi

July 11, 2026 ยท View on GitHub

Agent-facing DynamoDB operations AXI for discovering, inspecting, querying, scanning safely, planning, creating, updating, backing up, restoring, exporting, importing, diagnosing, and safely operating DynamoDB tables.

The project follows the AXI creation guidelines installed with npx skills add kunchenguid/axi.

Goals

  • Show useful live AWS and DynamoDB context with dynamodb-axi, not help text.
  • Use compact TOON-style stdout for agent parsing.
  • Keep every command non-interactive.
  • Fail loudly on unknown flags before side effects.
  • Default to read-only discovery or dry-run behavior.
  • Require --execute for mutations.
  • Require --execute and --confirm <exact-name> for destructive operations.
  • Require explicit --limit for scans.
  • Redact credentials, tokens, passwords, secrets, keys, and secret-like item fields.

Usage

npm test
node bin/dynamodb-axi.js
node bin/dynamodb-axi.js doctor
node bin/dynamodb-axi.js services
node bin/dynamodb-axi.js discover
node bin/dynamodb-axi.js tables
node bin/dynamodb-axi.js inspect --table <name>
node bin/dynamodb-axi.js query --table <name> --key-condition "pk = :pk" --expr-values '{":pk":{"S":"USER#1"}}'
node bin/dynamodb-axi.js scan --table <name> --limit 25
node bin/dynamodb-axi.js put-item --table <name> --item '{"pk":{"S":"USER#1"}}'
node bin/dynamodb-axi.js delete-table --table <name> --confirm <name> --execute

Global flags:

--cwd <path>
--profile <name>
--region <name>
--endpoint-url <url>
--help

Capability Domains

  • AWS context: profiles, regions, identity, endpoint URL, DynamoDB Local
  • Tables: list, describe, create, update, delete
  • Keys/indexes: partition/sort keys, GSIs, LSIs, projection, index status
  • Reads: get-item, query, bounded scan, pagination hints
  • Writes: put-item, update-item, delete-item with condition support
  • Expressions: key conditions, filters, update expressions, expression values
  • Backups/restore: on-demand backups, PITR hints, restore to new table
  • Export/import: S3 export/import workflows
  • Streams: stream status, stream ARN, consumer hints
  • TTL: inspect and update TTL
  • Capacity: billing mode, provisioned throughput, consumed capacity hints
  • Local dev: DynamoDB Local, Docker Compose, local endpoint mode
  • CI/CD: schema validation, table planning, dry-run guarded operations
  • Security: IAM/auth errors, credential redaction, secret-like item fields

Agent Integration

Use a hook for ambient live context:

dynamodb-axi hooks install --agent codex --scope user --execute

Use the generated skill as a lower-overhead discovery path:

npx skills add thatdudealso/dynamodb-axi --skill dynamodb-axi

Regenerate or check the skill:

node bin/dynamodb-axi.js skill generate
npm run skill:check

AXI Catalog Entry

The upstream kunchenguid/axi community catalog entry should be:

  • AXI: dynamodb-axi
  • Author: thatdudealso
  • Domain: DynamoDB
  • Description: Discover, inspect, query, scan, create, update, back up, restore, export, import, and safely operate DynamoDB tables through token-efficient CLI workflows.
  • Link: https://github.com/thatdudealso/dynamodb-axi