Open-Source Wikis

/

CockroachDB

/

Applications

/

Other internal tools

cockroachdb/cockroach

Other internal tools

pkg/cmd/ contains roughly 70 distinct command directories. The major ones have their own pages; this page lists the rest with one-line descriptions and pointers.

Release engineering

Tool What it does
pkg/cmd/release/ Cut releases, publish artifacts, update changelogs
pkg/cmd/publish-artifacts/ Push binaries to S3 / Docker Hub
pkg/cmd/run-pgo-build/ Profile-guided optimization build pipeline
pkg/cmd/protoc-gen-gogoroach/ CRDB-specific protobuf compiler plugin
pkg/cmd/protoc-gen-go-drpc/ DRPC plugin

Code generation

Tool Output
pkg/cmd/sql-bootstrap-data/ Bootstrap data for new clusters (system table seeds)
pkg/cmd/generate-bazel-extra/ Extra Bazel rules generation
pkg/cmd/generate-spatial-ref-sys/ Spatial reference system tables
pkg/cmd/generate-import-fixtures/ IMPORT-test fixtures
pkg/cmd/generate-binary/ Stamp build metadata into binaries
pkg/cmd/generate-cgo/ Cgo helper generator
pkg/cmd/generate-distdir/ Distributable layout
pkg/cmd/generate-logictest/ Logic-test config files
pkg/cmd/generate-staticcheck/ Static-check config
pkg/cmd/generate-acceptance-tests/ Acceptance test wiring
pkg/cmd/generate-ash-inventory/ Active-session-history inventory
pkg/cmd/generate-metadata-tables/ pg_catalog metadata

CI and dev

Tool What it does
pkg/cmd/bazci/ Adapter that runs Bazel tests in CI
pkg/cmd/ci-stress/ Stress-test runner for CI
pkg/cmd/github-post/, pkg/cmd/github-pull-request-make/ CI ↔ GitHub integration
pkg/cmd/flaky-test-notifier/ Identify and notify on flaky tests
pkg/cmd/whoownsit/ CODEOWNERS lookup
pkg/cmd/urlcheck/ Validate links in repo docs
pkg/cmd/skip-test/ Mark tests to skip
pkg/cmd/skiperrs/ Skip lint errors temporarily
pkg/cmd/skipped-tests/ Audit skipped tests
pkg/cmd/testfilter/ Filter test output
pkg/cmd/testowner/ Map tests to teams
pkg/cmd/uptodate/ Check if generated code is current
pkg/cmd/wraprules/ Wrap rules for OPS/Datadog
pkg/cmd/gen-metric-owners/ Generate metric-owners table

Performance

Tool What it does
pkg/cmd/microbench-ci/ Microbench CI integration
pkg/cmd/roachprod-microbench/ Cross-revision benchmarks against roachprod clusters
pkg/cmd/roachprod-stress/ Stress harness using roachprod
pkg/cmd/zerosum/ Zero-sum data correctness probe
pkg/cmd/vecbench/ Vector-index benchmark

SQL fuzzing and comparison

Tool What it does
pkg/cmd/smith/ sqlsmith driver
pkg/cmd/smithcmp/ Compare CRDB vs Postgres SQL output
pkg/cmd/smithtest/ smith integration tests
pkg/cmd/cmp-sql/ Compare two SQL implementations
pkg/cmd/cmp-protocol/ Compare two pgwire implementations
pkg/cmd/cmpconn/ Reusable connection-comparison harness
pkg/cmd/cr2pg/ Copy CRDB schemas/data to Postgres
pkg/cmd/reduce/ SQL test-case reducer

Cluster tooling

Tool What it does
pkg/cmd/drt/, pkg/cmd/drt-run/, pkg/cmd/drtprod/ Deployment-replay tooling for long-running production-like clusters
pkg/cmd/allocsim/ Allocator simulator
pkg/cmd/gossipsim/ Gossip simulator
pkg/cmd/kv/ Old KV-only client (mostly historical)
pkg/cmd/tef/ Token expiration framework
pkg/cmd/tsdump2duck/ Convert tsdump to DuckDB for analysis

Misc

Tool What it does
pkg/cmd/docgen/ Generate SQL grammar diagrams and docs
pkg/cmd/geoviz/ Visualize a geometry library result
pkg/cmd/fuzz/ Fuzz harness
pkg/cmd/mirror/ Mirror an upstream Go module
pkg/cmd/prereqs/ Bazel prerequisites checker
pkg/cmd/returncheck/ Check Go return-value usage
pkg/cmd/roachvet/ CRDB-specific Go vet plugin
pkg/cmd/rpc_node_shutdown.go (in cli) Coordinated node shutdown helper

This list is intentionally non-exhaustive — see ls pkg/cmd for a full directory.

Built by Factory AutoWiki from public repository content. It is a generated preview for codebase exploration, not source-maintained documentation.

Other internal tools – CockroachDB wiki | Factory