openclaw

mirror of https://github.com/openclaw/openclaw.git synced 2026-07-10 00:11:19 +00:00

History

joshavant 8e95e56e2d chore(ios): generate release artifacts locally		2026-07-01 22:05:26 -05:00
..
clawdock
dev	fix(qa): reject duplicate gateway smoke options	2026-06-23 14:52:37 +02:00
docker	fix(docker): reduce local build memory pressure	2026-07-01 03:58:21 -07:00
docs-i18n	refactor(docs-i18n): remove unreachable chunk helpers	2026-06-23 04:58:21 +08:00
e2e	fix(parallels): stabilize Windows beta smoke transport	2026-06-30 15:54:11 -07:00
fixtures
github	fix(test): route release ref resolver	2026-06-21 17:27:29 +02:00
k8s	docs: add existing-solutions preflight guardrail (#86608 )	2026-06-22 17:17:48 +00:00
lib	chore(ios): generate release artifacts locally	2026-07-01 22:05:26 -05:00
mantis
perf	fix(qa): reject duplicate model resolution perf controls	2026-06-23 17:24:41 +02:00
podman
pr-lib	fix(maint): keep PR landing on squash	2026-06-24 09:28:03 +08:00
pre-commit	fix(scripts): clamp audit request timer	2026-06-22 03:30:19 +02:00
qa	test(qa): expand docker lane adapter (#97937 )	2026-06-29 17:08:43 -07:00
repro	test: fold webchat auto tts proof into qa (#97632 )	2026-06-28 23:20:13 -07:00
secrets
systemd
AGENTS.md	Target changed lint checks (#94708 )	2026-06-24 12:18:57 -07:00
analyze-plugin-sdk-usage.ts
android-app-i18n.ts	chore(android): prepare 2026.6.11 Play release	2026-07-01 17:26:11 -05:00
android-pin-version.ts
android-release-signing.mjs	fix(scripts): reject short flag values in release docs parsers	2026-06-21 21:39:41 +02:00
android-release-upload.sh
android-release.sh
android-screenshots.sh
android-sync-versioning.ts
android-version.ts
anthropic-prompt-probe.ts
apple-app-i18n.ts	fix(apple): preserve localized static labels	2026-07-01 05:19:12 -07:00
audit-seams.mjs
auth-monitor.sh
bench-cli-startup.ts	fix(qa): reject duplicate cli bench controls	2026-06-23 17:01:42 +02:00
bench-gateway-restart.ts	fix(qa): reject duplicate gateway restart controls	2026-06-23 17:13:39 +02:00
bench-gateway-startup.ts	fix(qa): reject duplicate gateway startup controls	2026-06-23 17:08:08 +02:00
bench-model.ts	fix(qa): reject duplicate model bench controls	2026-06-23 17:18:47 +02:00
bench-sqlite-state.ts	fix(qa): reject duplicate sqlite bench controls	2026-06-23 16:41:01 +02:00
bench-test-changed.mjs	fix(qa): reject duplicate single-value flags	2026-06-23 14:01:29 +02:00
build-all.mjs
build-and-run-mac.sh
build-diffs-viewer-runtime.mjs
build-docs-list.mjs
build-stamp.d.mts
build-stamp.mjs
build_icon.sh
bundle-a2ui.mjs
bundle-a2ui.sh
bundled-plugin-assets.mjs
changed-lanes.mjs	chore(ios): generate release artifacts locally	2026-07-01 22:05:26 -05:00
changelog-to-html.sh
check-architecture-smells.mjs
check-changed.mjs	Target changed lint checks (#94708 )	2026-06-24 12:18:57 -07:00
check-changelog-attributions.mjs
check-channel-agnostic-boundaries.mjs
check-cli-bootstrap-imports.mjs
check-cli-startup-memory.mjs	perf(cli): speed up precomputed command help startup	2026-06-22 21:27:47 +08:00
check-codex-app-server-protocol.ts
check-composite-action-input-interpolation.py
check-database-first-legacy-stores.mjs
check-deadcode-unused-files.mjs
check-dependency-pins.mjs
check-deprecated-api-usage.mjs
check-deprecated-jsdoc.mjs
check-docker-e2e-boundaries.mjs
check-docs-i18n-glossary.mjs	fix(test): reject diff ref flag values	2026-06-21 19:59:55 +02:00
check-docs-mdx.mjs	fix(scripts): reject short flag values in release docs parsers	2026-06-21 21:39:41 +02:00
check-duplicates.mjs
check-dynamic-import-warts.mjs
check-extension-package-tsc-boundary.mjs	fix(scripts): clamp boundary check timers	2026-06-22 02:54:30 +02:00
check-extension-plugin-sdk-boundary.mjs
check-extension-wildcard-reexports.mjs
check-file-utils.ts
check-gateway-cpu-scenarios.mjs	fix(qa): reject duplicate gateway cpu controls	2026-06-23 17:30:37 +02:00
check-gateway-watch-regression.mjs
check-import-cycles.ts
check-ingress-agent-owner-context.mjs
check-kysely-guardrails.mjs	fix: allow sqlite user version guardrail (#95857 )	2026-06-22 13:36:42 -07:00
check-live-cache.ts
check-madge-import-cycles.ts
check-media-download-helper-roundtrip.mjs
check-memory-fd-repro.mjs	fix(qa): reject missing memory fd args	2026-06-23 15:58:33 +02:00
check-no-conflict-markers.mjs
check-no-deprecated-channel-access.ts
check-no-extension-src-imports.ts
check-no-extension-test-core-imports.ts
check-no-monolithic-plugin-sdk-entry-imports.ts
check-no-pairing-store-group-auth.mjs
check-no-random-messaging-tmp.mjs
check-no-raw-channel-fetch.mjs
check-no-raw-http2-imports.mjs
check-no-raw-window-open.mjs
check-no-register-http-handler.mjs
check-no-runtime-action-load-config.mjs
check-openclaw-package-tarball.mjs
check-package-dist-imports.mjs
check-package-patches.mjs
check-pairing-account-scope.mjs
check-plugin-extension-import-boundary.mjs
check-plugin-gateway-gauntlet.mjs	fix(qa): reject duplicate plugin gauntlet controls	2026-06-23 17:37:53 +02:00
check-plugin-npm-runtime-builds.mjs	fix(scripts): reject short flag values in helper CLIs	2026-06-21 22:19:54 +02:00
check-plugin-sdk-exports.mjs
check-plugin-sdk-subpath-exports.mjs
check-plugin-sdk-wildcard-reexports.mjs	fix(scripts): catch namespace plugin sdk wildcard exports	2026-06-23 10:35:28 +02:00
check-policy-config-coverage.ts	test(policy): add config coverage report (#87081 )	2026-06-26 18:28:35 -07:00
check-release-metadata-only.mjs	chore(ios): generate release artifacts locally	2026-07-01 22:05:26 -05:00
check-runtime-sidecar-loaders.mjs
check-sdk-package-extension-import-boundary.mjs
check-session-accessor-boundary.mjs	fix(whatsapp): route group activation through session accessor (#96530 )	2026-06-24 13:46:26 -07:00
check-session-transcript-reader-boundary.mjs
check-src-extension-import-boundary.mjs
check-telegram-grammy-types-imports.mjs
check-temp-path-guardrails.ts
check-test-helper-extension-import-boundary.mjs
check-timed.mjs
check-ts-max-loc.ts
check-tsgo-core-boundary.mjs
check-web-fetch-provider-boundaries.mjs
check-web-search-provider-boundaries.mjs
check-webhook-auth-body-order.mjs
check-workflows.mjs	fix(ci): report missing workflow pre-commit runtime	2026-06-23 17:27:32 +08:00
check.mjs
ci-changed-scope.d.mts	fix(i18n): route native inventory checks narrowly	2026-07-01 03:28:23 -07:00
ci-changed-scope.mjs	fix(ci): route native locale refresh checks	2026-07-01 03:28:23 -07:00
ci-docker-login-ghcr.sh
ci-docker-pull-retry.sh
ci-hydrate-live-auth.sh
ci-hydrate-testbox-env.sh	fix(test): route testbox env hydration	2026-06-21 18:04:47 +02:00
ci-live-command-retry.sh
ci-run-timings.mjs	fix(scripts): run gh without terminal formatting	2026-06-22 18:44:21 +08:00
claude-auth-status.sh
CLAUDE.md
clawlog.sh
clawtributors-map.json	docs: map guanbear clawtributor emails (#90547 )	2026-06-28 17:22:26 -07:00
close-duplicate-prs-after-merge.mjs
codesign-mac-app.sh
codespell-dictionary.txt
codespell-ignore.txt	docs: fix docs metadata spellcheck (#93502 )	2026-06-22 17:17:35 +00:00
committer
control-ui-i18n-report.ts	feat(i18n): add Hindi and Russian docs and Control UI locales	2026-06-26 15:01:15 -07:00
control-ui-i18n.ts	fix(i18n): name Swedish in translation prompts	2026-07-01 06:16:30 -07:00
control-ui-mock-dev.ts
copy-bundled-plugin-metadata.d.mts
copy-bundled-plugin-metadata.mjs
copy-export-html-templates.ts
copy-hook-metadata.ts
copy-plugin-sdk-root-alias.mjs
crabbox-wrapper.mjs	fix: surface delegated Testbox proof status	2026-06-27 23:53:53 +01:00
create-dmg.sh	fix(release): validate DMG resize slack	2026-06-23 09:51:38 +02:00
deadcode-unused-files.allowlist.mjs	chore(deadcode): remove unused speech contract registry	2026-06-22 10:19:01 +08:00
debug-claude-usage.ts
dependency-changes-report.mjs	fix(qa): reject ambiguous dependency report inputs	2026-06-23 13:43:44 +02:00
dependency-ownership-surface-report.mjs	fix(qa): reject ambiguous dependency report inputs	2026-06-23 13:43:44 +02:00
dependency-vulnerability-gate.mjs
diffs-shiki-curated.ts
docker-e2e-rerun.mjs	fix(qa): isolate docker rerun artifact downloads	2026-06-23 12:55:05 +02:00
docker-e2e-timings.mjs	fix(qa): reject unknown docker timing options	2026-06-23 16:26:42 +02:00
docker-e2e.mjs
docs-link-audit.d.mts
docs-link-audit.mjs
docs-list.js	fix docs-list-mdx-pages (#95230 )	2026-07-01 01:51:50 -07:00
docs-spellcheck.sh
docs-sync-publish.mjs	feat(i18n): add Hindi and Russian docs and Control UI locales	2026-06-26 15:01:15 -07:00
embedded-run-abort-leak.ts	fix(qa): reject duplicate abort leak controls	2026-06-23 16:46:39 +02:00
ensure-cli-startup-build.mjs
ensure-extension-memory-build.mjs
ensure-playwright-chromium.mjs	fix(qa): recover Playwright Chromium on Ubuntu 26	2026-06-24 13:24:43 +08:00
firecrawl-compare.ts	fix(codeql): clean OpenClaw quality findings	2026-06-22 19:11:46 +08:00
format-docs.mjs
full-release-validation-at-sha.mjs	fix(release): reject validation flag values	2026-06-21 20:05:22 +02:00
gateway-watch-tmux.d.mts
gateway-watch-tmux.mjs
generate-base-config-schema.ts
generate-bundled-channel-config-metadata.ts
generate-config-doc-baseline.ts
generate-dependency-release-evidence.mjs	fix(qa): reject duplicate dependency evidence options	2026-06-23 14:14:43 +02:00
generate-docs-map.mjs	docs: add generated docs map (#95954 )	2026-06-29 11:05:58 -07:00
generate-host-env-security-policy-swift.mjs
generate-kysely-types.mjs
generate-npm-shrinkwrap.mjs	fix(scripts): reject short flag shrinkwrap refs	2026-06-21 22:40:07 +02:00
generate-plugin-inventory-doc.mjs	feat(raft): add wake bridge channel	2026-06-22 14:36:12 +08:00
generate-plugin-sdk-api-baseline.ts
generate-prompt-snapshots.ts
generate-runtime-sidecar-paths-baseline.ts
generate-secretref-credential-matrix.ts
gh-read
gh-read.ts
ghsa-patch.mjs
install-cli.sh	Scope agent cron operations to the calling agent (#96883 )	2026-06-26 21:41:14 -05:00
install.ps1	Scope agent cron operations to the calling agent (#96883 )	2026-06-26 21:41:14 -05:00
install.sh	Scope agent cron operations to the calling agent (#96883 )	2026-06-26 21:41:14 -05:00
ios-app-review-notes-pdf.swift	build(ios): attach app review notes PDF	2026-06-23 19:18:51 -05:00
ios-app-store-connect-keychain-setup.sh
ios-configure-signing.sh	feat: wire ios push sandbox tooling	2026-06-22 21:07:57 -04:00
ios-release-archive.sh	Require explicit iOS release versions	2026-07-01 20:24:38 -05:00
ios-release-prepare.sh	chore(ios): generate release artifacts locally	2026-07-01 22:05:26 -05:00
ios-release-signing.mjs	fix(scripts): reject short flag values in release docs parsers	2026-06-21 21:39:41 +02:00
ios-release-upload.sh	Require explicit iOS release versions	2026-07-01 20:24:38 -05:00
ios-run.sh	chore(ios): generate release artifacts locally	2026-07-01 22:05:26 -05:00
ios-screenshots.sh
ios-sync-versioning.ts	chore(ios): generate release artifacts locally	2026-07-01 22:05:26 -05:00
ios-team-id.sh
ios-validate-app-store-ipa.sh	feat: harden ios app store push release mode	2026-06-23 00:01:20 -05:00
ios-version.ts	chore(ios): generate release artifacts locally	2026-07-01 22:05:26 -05:00
ios-write-swift-filelist.mjs	chore(ios): generate release artifacts locally	2026-07-01 22:05:26 -05:00
ios-write-version-xcconfig.sh	Require explicit iOS release versions	2026-07-01 20:24:38 -05:00
kova-ci-summary.mjs	fix(test): reject kova help value bypasses	2026-06-21 19:07:02 +02:00
label-open-issues.ts	fix(scripts): reject short flag values in helper CLIs	2026-06-21 22:19:54 +02:00
list-prod-store-packages.mjs
live-docker-normalize-config.ts
load-channel-config-surface.ts
make_appcast.sh
mcp-code-mode-gateway-e2e.ts	test: centralize mcp gateway env cleanup	2026-06-24 20:35:50 +01:00
measure-rpc-rtt.mjs	fix(qa): reject duplicate rpc rtt controls	2026-06-23 18:00:53 +02:00
mobile-reauth.sh
mobile-release-ref.ts	Track mobile release SHAs with refs	2026-06-26 18:54:45 -05:00
native-app-i18n.ts	feat(ios): modernize the app with iOS 26 Liquid Glass (#98452 )	2026-07-01 19:06:04 +01:00
notarize-mac-artifact.sh
npm-runner.d.mts
npm-runner.mjs
openclaw-cross-os-release-checks.ts
openclaw-npm-postpublish-verify.ts	fix(release): surface installed extension manifest errors	2026-06-23 10:26:10 +02:00
openclaw-npm-prepublish-verify.ts
openclaw-npm-publish.sh
openclaw-npm-release-check.ts
openclaw-performance-source-summary.mjs	fix(scripts): reject short flag performance summary paths	2026-06-21 22:02:05 +02:00
openclaw-prepack.ts	fix(release): preserve npm pack json output	2026-06-24 09:19:00 +02:00
openclaw-release-clawhub-plan.ts
openclaw-release-clawhub-runtime-state.ts
package-changelog.mjs
package-mac-app.sh	fix(macos): compile packaged localizations	2026-07-01 05:19:12 -07:00
package-mac-dist.sh	fix(macos): prefer repo pnpm for packaging	2026-06-21 15:39:17 +02:00
package-openclaw-for-docker.mjs	fix(qa): reject duplicate docker package options	2026-06-23 14:24:41 +02:00
plan-release-workflow-matrix.mjs
plan-targeted-docker-lane-groups.mjs
plugin-boundary-report.ts
plugin-clawhub-publish.sh
plugin-clawhub-release-check.ts
plugin-clawhub-release-plan.ts
plugin-npm-publish.sh
plugin-npm-release-check.ts
plugin-npm-release-plan.ts
plugin-prerelease-liveish-matrix.mjs
plugin-release-pretag-pack-check.ts	fix: bump ClawHub publish CLI pin (#98233 )	2026-06-30 11:26:51 -07:00
plugin-sdk-surface-report.mjs	refactor(auth): simplify codex login follow-up	2026-07-01 11:16:49 -07:00
pnpm-runner.d.mts
pnpm-runner.mjs
postinstall-bundled-plugins.mjs
pr	fix(scripts): run gh without terminal formatting	2026-06-22 18:44:21 +08:00
pr-merge
pr-prepare
pr-review
preinstall-package-manager-warning.mjs
prepare-codex-ci-auth.ts
prepare-codex-ci-config.ts
prepare-extension-package-boundary-artifacts.mjs	fix(scripts): clamp boundary artifact timers	2026-06-22 03:05:11 +02:00
prepare-git-hooks.mjs
prepush-ci.sh
print-cli-backend-live-metadata.ts
process-warning-filter.mjs
profile-extension-memory.mjs	fix(qa): avoid extension memory report collisions	2026-06-23 12:48:16 +02:00
profile-tsgo.mjs
prompt-snapshot-files.ts
proof-cron-on-exit.mts	feat(cron): on-exit cron schedule kind — fire a job when a watched command exits	2026-07-01 10:47:01 -07:00
proof-telegram-bound.mjs	fix(telegram): bound Bot API response reads to prevent OOM (#97271 )	2026-06-28 12:28:51 -07:00
proof-telegram-getchat-bound.mjs	fix(telegram): bound getChat Bot API response reads (#97274 )	2026-06-28 12:29:14 -07:00
protocol-gen-swift.ts	fix: page sessions_history beyond truncated tails (#97101 )	2026-06-27 15:30:49 -07:00
protocol-gen.ts
proxy-install-ca.mjs	fix(test): route proxy CA installer	2026-06-21 17:51:44 +02:00
prune-docker-plugin-dist.d.mts
prune-docker-plugin-dist.mjs
qa-coverage-report.ts
qa-e2e.ts	fix(qa): reject duplicate qa e2e outputs	2026-06-23 13:34:20 +02:00
qa-lab-up.ts	fix(qa): accept pnpm separator for lab up (#96246 )	2026-06-24 10:22:56 +08:00
qa-parity-report.ts
README.md	docs: add scripts directory index (#97250 )	2026-06-28 12:19:30 -07:00
recover-orphaned-processes.sh
release-beta-smoke.ts
release-candidate-checklist.mjs	fix(release): reject duplicate candidate checklist options	2026-06-23 14:30:29 +02:00
release-check.ts
release-fast-pretag-check.sh
release-preflight.mjs	fix(test): route release preflight script	2026-06-21 17:46:59 +02:00
release-verify-beta.ts
report-test-temp-creations.mjs	test: prefer auto-cleaning temp dir helper (#93209 )	2026-07-02 02:46:28 +00:00
resolve-openclaw-package-candidate.mjs	fix(qa): reject duplicate package candidate options	2026-06-23 14:19:42 +02:00
resolve-upgrade-survivor-baselines.mjs	fix(scripts): reject short flag values in helper CLIs	2026-06-21 22:19:54 +02:00
restart-mac.sh	fix(qa): preserve active mac restart locks	2026-06-23 13:02:39 +02:00
root-dependency-ownership-audit.mjs
run-additional-boundary-checks.mjs	fix(scripts): clamp additional boundary timers	2026-06-22 03:08:19 +02:00
run-android-gradle.mjs
run-bundled-extension-oxlint.mjs
run-extension-channel-oxlint.mjs
run-node-watch-paths.mjs
run-node.d.mts
run-node.mjs
run-openclaw-podman.sh
run-opengrep.sh	fix(ci): require OpenGrep SARIF artifacts	2026-06-23 14:08:20 +08:00
run-oxlint-shards.mjs
run-oxlint.mjs
run-tsgo.mjs
run-vitest-profile.mjs	fix(scripts): reject short flag vitest profile dirs	2026-06-21 21:53:58 +02:00
run-vitest.mjs
run-with-env.mjs	fix(scripts): clamp run-with-env kill timer	2026-06-22 03:15:26 +02:00
runtime-postbuild-shared.mjs
runtime-postbuild-stamp.mjs
runtime-postbuild.mjs	fix: keep text transform runtime imports hashed (#95081 )	2026-06-22 17:47:16 +00:00
sandbox-browser-entrypoint.sh
sandbox-browser-setup.sh
sandbox-common-setup.sh	fix(sandbox): install supported node in common image	2026-06-24 22:54:00 +08:00
sandbox-setup.sh
setup-auth-system.sh
sparkle-build.ts
sqlite-vec-smoke.mjs
stage-bundled-plugin-runtime.d.mts
stage-bundled-plugin-runtime.mjs
sync-codex-app-server-protocol.ts
sync-codex-model-prompt-fixture.ts
sync-labels.ts
sync-moonshot-docs.ts
sync-native-a2ui.mjs	fix(canvas): guard native A2UI resources	2026-06-23 13:44:14 +08:00
sync-openclaw-label-colors.mjs
sync-plugin-sdk-exports.mjs
sync-plugin-versions.ts
termux-auth-widget.sh
termux-quick-auth.sh
termux-sync-widget.sh
test-built-bundled-channel-entry-smoke.mjs
test-built-plugin-singleton.mjs
test-built-status-message-runtime.mjs
test-cleanup-docker.sh
test-cli-startup-bench-budget.mjs
test-docker-all.mjs	fix(scripts): clamp docker all timers	2026-06-22 02:44:00 +02:00
test-docker-all.sh
test-env-mutation-report.ts	fix(test): reject env report flag paths	2026-06-21 18:46:05 +02:00
test-extension-batch.mjs
test-extension.mjs
test-force.ts
test-group-report.mjs	fix(qa): reject duplicate test report controls	2026-06-23 14:06:41 +02:00
test-hotspots.mjs
test-install-sh-docker.sh
test-install-sh-e2e-docker.sh
test-live-acp-bind-docker.sh	Scope agent cron operations to the calling agent (#96883 )	2026-06-26 21:41:14 -05:00
test-live-acp-spawn-defaults-docker.sh
test-live-build-docker.sh
test-live-cli-backend-docker.sh	fix(test): keep Gemini CLI docker lane advisory	2026-06-22 04:32:34 +02:00
test-live-codex-harness-docker.sh
test-live-gateway-models-docker.sh
test-live-models-docker.sh
test-live-shard.mjs
test-live-subagent-announce-docker.sh
test-live.mjs
test-perf-budget.mjs
test-projects-imports.mjs
test-projects-max.mjs
test-projects-serial.mjs
test-projects.mjs	Scope agent cron operations to the calling agent (#96883 )	2026-06-26 21:41:14 -05:00
test-projects.test-support.d.mts
test-projects.test-support.mjs	Require explicit iOS release versions	2026-07-01 20:24:38 -05:00
test-report-utils.mjs	fix(qa): avoid vitest report path collisions	2026-06-23 12:40:25 +02:00
test-shell-completion.ts
test-skip-inventory.ts	fix: detect chained test modifiers	2026-06-29 00:06:04 +01:00
test-unit-fast-audit.mjs
test-update-cli-startup-bench.mjs
test-voicecall-closedloop.mjs
tool-display.ts
transitive-manifest-risk-report.mjs
ts-topology.ts
tsconfig.json
tsdown-build.mjs	fix(build): allow tsdown heap override	2026-06-22 20:36:42 +08:00
ui.js
update-clawtributors.ts
update-clawtributors.types.ts
validate-plugin-init-provider-scaffold.ts	feat: scaffold provider plugins from init (#94352 )	2026-06-26 16:43:51 -07:00
validate-release-publish-approval.mjs
verify-docker-attestations.mjs	fix(test): reject attestation platform flags	2026-06-21 18:43:05 +02:00
verify-plugin-npm-published-runtime.mjs
verify-pr-hosted-gates.mjs	fix(maint): protect pending hosted CI reruns	2026-06-23 21:49:36 +08:00
verify-stable-main-closeout.mjs	fix(scripts): reject short flag closeout values	2026-06-21 21:32:17 +02:00
verify.mjs
vitest-process-group.mjs
watch-node.d.mts
watch-node.mjs
windows-cmd-helpers.d.mts
windows-cmd-helpers.mjs
write-build-info.ts
write-cli-compat.ts
write-cli-startup-metadata.ts	perf(cli): speed up precomputed command help startup	2026-06-22 21:27:47 +08:00
write-official-channel-catalog.d.mts
write-official-channel-catalog.mjs
write-package-dist-inventory.ts
write-plugin-sdk-entry-dts.ts
zai-fallback-repro.ts

README.md

summary

read_when

title

Repository script entry points and compatibility notes

Looking for an existing script before adding a new one

Running repository checks, tests, docs, Docker, release, or GitHub helper scripts

Updating package scripts or CI workflow script references

Scripts Directory

The scripts/ directory contains repository tooling used by local development, CI, docs publishing, releases, Docker proof, and maintainer operations. Prefer the package-script entry points in package.json when one exists, then read the underlying script before running it directly.

Compatibility

Many scripts are stable paths referenced by package.json, GitHub Actions, docs, and maintainer runbooks. Do not move, rename, or regroup scripts only to improve taxonomy. A directory migration needs an explicit maintainer-approved compatibility plan for package scripts, workflows, docs snippets, and any raw script paths users may have copied.

This index is a discovery aid for the current flat layout. It does not define a new directory taxonomy.

Common Entry Points

Area	Prefer	Notes
Build	`pnpm build`	Runs `scripts/build-all.mjs`; use specific build scripts only when debugging a build stage.
Changed checks	`pnpm changed:lanes --json`, `pnpm check:changed`	Lane classification lives in `scripts/changed-lanes.mjs`; changed-file checks live in `scripts/check-changed.mjs`.
Docs	`pnpm docs:list`, `pnpm docs:check-mdx`, `pnpm docs:check-links`	Backed by `scripts/docs-list.js`, `scripts/check-docs-mdx.mjs`, and `scripts/docs-link-audit.mjs`.
Formatting docs	`pnpm format:docs:check`	Uses `scripts/format-docs.mjs`; use write mode only when intentionally formatting docs.
Lint	`pnpm lint`, `pnpm lint:core`, `pnpm lint:all`	Wrapper scripts keep oxlint behavior aligned with repo config.
Targeted tests	`pnpm test <path-or-filter>` or `node scripts/run-vitest.mjs <path-or-filter>`	Avoid bare `vitest`; it can start watch mode.
Changed tests	`pnpm test:changed`	Uses the repo's changed-test resolver instead of a broad Vitest run.
Docker proof	`pnpm test:docker:all`, `pnpm test:docker:rerun`, `pnpm test:docker:timings`	Use the planner/rerun helpers before launching broad Docker work.
Live proof	`pnpm test:live`	Live checks require the matching environment and credentials.
Release checks	`pnpm release:check`, `pnpm release:beta`, `pnpm release:candidate`	Release scripts are maintainer workflows; read release docs before use.
GitHub reads	`scripts/gh-read`	Uses a GitHub App read token when configured, leaving normal `gh` login for writes.
Commits	`scripts/committer "<message>" <files...>`	Preferred scoped commit helper for OpenClaw changes.
Remote proof	`node scripts/crabbox-wrapper.mjs ...`	Use for Crabbox/Testbox lanes when local proof would be too broad or environment-sensitive.

Script Families

check-*.mjs / check-*.ts: guardrails for architecture, docs, package contents, boundaries, workflows, and generated artifacts.
run-*.mjs: wrappers around repo runtimes or tools, such as Node, Vitest, oxlint, tsgo, and environment setup.
test-*.mjs / test-*.sh / test-*.ts: test planners, Docker lanes, live checks, and focused validation helpers.
docs-* and check-docs-*: docs listing, link auditing, MDX checks, spellcheck, sync, and i18n glossary checks.
release-*, openclaw-npm-*, and plugin-*-release-*: release preparation, package verification, and publishing helpers.
docker-*, test-docker-*, and test-live-*-docker.sh: Docker E2E planning, rerun, timing, and live/package lane helpers.
gh-read*, label-*, sync-labels.ts, and PR helpers: GitHub read, labeling, and maintainer workflow support.
generate-*, write-*, copy-*, and sync-*: generated docs, metadata, package surfaces, and build artifact support.
lib/: shared helpers imported by script entry points.

Maintenance Rules

Read scripts/AGENTS.md before changing scripts.
Keep package scripts, generators, generated-artifact checks, docs references, and workflow references aligned when touching a script path.
Prefer existing wrappers instead of introducing a raw tool invocation.
Add or update focused tests under test/scripts/ when changing script behavior.

See also Scripts for public-facing script guidance.