Nativelink Lre Debug
Testing & Qualitynativelink-lre-debugNativelink Lre Debug is an Agent Skill for testing & quality published in the TraceMachina/nativelink repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use when debugging NativeLink local remote execution, remote cache/executor self-tests, BEP event ingestion, worker scheduling, CAS misses, or Bazel remote execution behavior.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/TraceMachina/nativelink/blob/HEAD/.claude/skills/nativelink-lre-debug/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/nativelink-lre-debug, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
NativeLink Local Remote Execution Debugging
Use this skill when NativeLink is acting as a remote cache, remote executor, local remote execution server, or BEP target and something is missing, slow, or failing.
Identify The Mode
Start by recording the exact Bazel command and which NativeLink mode is involved:
- Remote cache self-test:
--config=self_test, usuallygrpc://127.0.0.1:50051. - Remote executor self-test:
--config=self_execute, usuallygrpc://127.0.0.1:50052. - Local remote execution overlays under
local-remote-execution/. - BEP ingestion or dashboard testing, which needs Build Event Protocol upload flags.
For rich action-level BEP data, include:
--build_event_publish_all_actions
This matters for helping users find build failures and slow actions faster.
First Checks
- Confirm the NativeLink server process is running.
- Confirm the expected ports aren't occupied by stale processes.
- Capture NativeLink logs and the exact Bazel stdout/stderr.
- Check whether the failure is CAS/AC storage, scheduler matching, worker execution, protocol, or client config.
Don't kill user services unless the user explicitly asks. Inspect ports and processes first.
Subsystem Map
- CAS/AC or cache misses: start in
nativelink-store/. - Worker execution failure: start in
nativelink-worker/. - Queueing, platform properties, or worker compatibility: start in
nativelink-scheduler/. - REAPI, bytestream, action cache, or BEP API behavior: start in
nativelink-service/. - Client templates and flags: start in
templates/andlocal-remote-execution/.
Useful Verification Commands
Inspect labels before running if unsure.
bazel build //:nativelink
bazel test //nativelink-store/...
bazel test //nativelink-scheduler/...
bazel test //nativelink-worker/...
bazel test //nativelink-service/...
For full confidence:
bazel test //...
Debug Output To Preserve
When reporting a failure, include:
- NativeLink server config path and relevant ports.
- Bazel remote cache/executor URL.
- Whether
--build_event_publish_all_actionswas set. - First server-side error and first client-side error.
- The failing target label and action mnemonic, if available.