List configured repositories, their paths, and architecture metadata.

Get branch, dirty state, and ahead/behind for every configured repo.

Search code across repos. mode=locations (default) omits line text; mode=context includes context.

List available named tasks for a repository, including metadata and warnings.

Run a configured task in a repository.

Build/test tasks are routed by NPU availability: with NPUs reachable they run on the host (allowed by policy); without NPUs they are re-routed into the sim Docker image for the repo (see _SIM_RUN), or refused with guidance when the repo has no sim image (e.g. PTOAS).

Run an ad-hoc shell command in a repository. Prefer run_task for known tasks or git_log/git_diff/read_file for read-only operations.

When no NPU is reachable, build/test commands (cmake, make, ninja, pip install, pytest, …) are refused — those must run inside the sim Docker images, never on the local repo. Read-only commands are unaffected.

Show the exact command and metadata configured for a named task.

Return the last N commits for a repository as structured data (sha, author, date, message).

Return the git diff for a repository (stat + optional patch). Prefer stat_only=True for orientation.

Read an arbitrary source file from a repository without shelling out.

Return all valid task_type values with one-line descriptions for use with bootstrap_session and route_task.

Return read-first docs, rules, entrypoints, and verify tasks for a compiler workflow.

List available task routes, MCP resources, notes topics, and bootstrap prompts.

Read a workspace document with tier labeling. Optional section extracts a markdown heading.

Explain a stack abstraction. If the name matches several layers, returns candidates instead of picking one.

Search the abstraction index by keyword. Results are ranked by relevance and grouped by layer.

Docs, skills, and rules for one framework layer, read live from that repo.

Explain a simpler scheduler level (L0–L6), engine, or concrete implementation tree.

List pypto-lib model workloads, or one model's kernels split into prefill and decode.

Read-only task-submit queue guide: which hosts require it, how to join, and the failure rules. Does not submit a job.

Search open, closed, and merged GitHub issues and PRs. Read-only.

Explain a pass in the Default pipeline: order, phase, neighbors, verify tasks.

Structured PR/plan status from status_prs.md (open PRs, blockers, plan cross-index).

Collective-comm feature parity status (merged/planned/gap) from the parity matrix in pypto-3.0-notes/distributed/current_status.md. Read-only -- never writes to the source doc.

Suggest minimal verify tasks for a set of changed file paths.

Returns static_checks (e.g. ["clang-tidy"]) when a changed path is a C/C++ file in a C++ repo — run those before the pytest tasks (see tools/clang_tidy_workflow).

Locate generated-code artifacts across the workspace: pass dumps, .pto MLIR, kernel/orchestration C++, dfx outputs.

Scans each repo's build_output/outputs/build roots (read-only) and classifies what it finds. Combine with the debug/codegen-inspection resource to know which stage each artifact belongs to.

List the agent-skill corpus per repo (pypto, pypto-lib, simpler, PTOAS, pto-isa, pypto-* plugins, pypto-tooling).

Find the agent skill that matches a task across all repos' skill corpus.

Summarize a pypto-profiling campaign directory (results.json, anomalies).

Full cross-layer trace: stack location + contract triangle + cross-layer verify tasks + active-PR links.

This is the enriched trace. Use trace_in_stack for a lightweight stack-location-only lookup.

Find code entrypoints for a repo and optional area (e.g. pypto, codegen_orch).

Lightweight stack location: matched abstraction card or path-prefix pipeline stage only.

No contract artifacts or PR links. Use trace_contract for the enriched cross-layer trace.

Check knowledge config health: missing paths, stale enriched docs, Ascend corpus, index build time.

Read-only Ascend/CANN environment check: devices, HCCL preload, Docker hints.

Generate markdown handoff for developer NPU verification in a container.

Single-call session bootstrap: route metadata, read_plan, health, program hints.

Generate a bash script for the safe rebase->pre-commit->sim-Docker-tests->squash->push gate workflow.