@dbx-tools/cli

Scaffold, formatting, codegen, verification, build, and release helpers for Bun + workspaces monorepos. It wraps the shared tsdown config for building and a Bun-based publish flow; dbxtools keeps only the workspace automation that is orthogonal to writing package code.

Installation

bun add -d @dbx-tools/cli

Then point your root package.json scripts at the dbxtools bin for the helper commands you want:

{
  "scripts": {
    "format": "dbxtools format",
    "build": "dbxtools build",
    "codegen": "dbxtools codegen",
    "verify": "dbxtools verify",
    "create": "dbxtools create",
    "release": "dbxtools release",
    "tag": "dbxtools tag",
  },
}

Commands

| Command | What it does | | ------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | dbxtools format | syncpack format, regroup lifecycle hooks, then prettier --write. | | dbxtools build | Compile every publishable package with the shared tsdown config. | | dbxtools codegen | Regenerate each package's generated/ zod tree from the .d.ts inputs its package.json declares. | | dbxtools verify [--workspace-deps] | Workspace verify pass; --workspace-deps fails on undeclared sibling imports. | | dbxtools create [--plugin\|--shared] <slug> | Scaffold a new package under packages/<slug>/. | | dbxtools release [--dry-run] | Build, then publish each package with a stamped (complete) manifest. | | dbxtools tag [patch\|minor\|major] | Version bump, commit, tag, push, and create a GitHub Release. --notes-since v0.1.75 widens the notes baseline; default is the previous tag. --no-ai-notes skips Codex release notes. | | dbxtools agent [prompt] | Run ucode codex exec (-t / --timeout seconds). Prompt via args or stdin. Requires ucode codex --version. |

Typecheck stays a plain tsc call:

tsc --noEmit -p tsconfig.json

Configuration

Configuration is optional. Everything is auto-derived from the workspace; the only knobs live under a dbxtools key in the root package.json:

{
  "dbxtools": {
    "scope": "@acme", // npm scope used by `create` (default: most common scope in the workspace)
    "repo": "acme/widgets", // owner/name for release links (default: the `origin` git remote)
  },
}

Each package's optional codegen.inputs field is read by convention.

Library API

The same commands are exported as functions for projects that want to compose their own automation:

import { build, codegen, create, release, tag, verify } from "@dbx-tools/cli";

await build();
await codegen();
await verify();
await create({ slug: "example" });
await release({ dryRun: true });
await tag({ bump: "patch", publish: false });

Also exported: format, plus the workspace helpers (discoverPackages, discoverPackageJsons, writeJson, getProject, sh, git, ...).

License

Apache-2.0