Probably AGI
PX / agent evidence atlas
v0.1.172 / 345 actions
PX 0.1.172 · the evidence layer beneath coding agents

Coding agents can act. PX makes them show their work.

Cursor, Copilot, Sourcegraph, JetBrains, CodeQL, and Semgrep each solve valuable parts of coding with AI. PX addresses a different failure: an agent can retrieve plausible context, edit code, run tests—and still be wrong about what it searched, what it missed, or what the result actually proves.

PX is the model-agnostic control plane between a question and a code change: choose the evidence lane, preserve exact anchors, expose coverage, recover from weak results, and carry receipts forward.

345documented agent actions
116non-LLM capability families
90runnable CLI surfaces
229validated command transitions
11agent workflow groups
Live route field / deterministic first
  1. QuestionNatural language or an explicit structural intent.
  2. FramePreserve file, symbol, route, table, and action anchors.
  3. ArbitrateExact, graph, semantic, docs, runtime, and recovery lanes compete.
  4. ProveReturn source coordinates, coverage, weaknesses, and boundaries.
  5. ContinueHand the agent the next safe command instead of a dead end.
QUESTION → FRAME → ROUTE COURT
                  ├─ exact graph
                  ├─ composed flow
                  ├─ docs evidence
                  └─ typed recovery
                         ↓
              BRIEF → EDIT → VERIFY → RECEIPT
Origin 00The failures that created PX

We built it because agents kept being almost right.

The expensive failures were not syntax errors. They were confident partial answers: the correct symbol in the wrong repository, a clean zero from an incomplete index, an HTTP or SQL boundary that disappeared between languages, or a passing test presented as proof of a larger claim.

Failure 01 · repeated discovery

Every new agent pays to rediscover the same codebase.

File reading and semantic retrieval can eventually reconstruct a system, but the model repeatedly spends context and time finding the same definitions, callers, boundaries, and governing docs.

Failure 02 · false absence

A zero is displayed like a fact.

When an index is stale, an extractor is partial, or a target is ambiguous, “no results” may describe the tool’s coverage—not the repository. PX returns an evidence horizon and typed recovery instead of laundering that uncertainty.

Failure 03 · invisible seams

The call graph stops where the language changes.

Real systems cross TypeScript, Rust, SQL, shell, HTTP, messages, generated code, and FFI. PX normalizes specialized extractors into one evidence surface and records where each edge came from.

Failure 04 · proof inflation

“The test passed” quietly becomes “the feature works.”

PX separates source, index, docs, runtime, test, and receipt evidence. The agent can still decide—but it cannot honestly pretend that one proof class establishes every other one.

Contract 01How the agent enters

One front door. No evidence blender.

PX is built for agents rather than command-line tourism. It reduces uncertainty about what evidence lane should run next while keeping deterministic structural truth, semantic relevance, documentation, and runtime observations visibly distinct.

01Default to px askNatural-language entry. RouteCourt preserves file, symbol, endpoint, table, and flow anchors.
02Keep direct lanes directWhen the agent already knows it needs callers, impact, literal evidence, docs, or index health, run that exact command.
03Use px ai for recoveryThe AnswerEnvelope helps when deterministic lanes cannot close the question. It is not a mandatory tollbooth.
Industry 02Compared with the current AI coding stack

The market helps agents find, write, and scan. PX governs what they know.

This is not a fake winner-take-all chart. The products below are strong at the jobs they advertise. PX is designed to sit beside them: it turns retrieval, navigation, analysis, documentation, and runtime observations into an explicit evidence and recovery contract for any agent.

AI coding agentsExcellent at planning, editing, running tools, and producing working patches. Their final answer can still hide which retrieval path ran, where context ended, and whether a claim exceeded the evidence.
Code search + navigationExcellent at finding text, symbols, definitions, and references—sometimes across repositories with compiler-derived precision. They provide evidence primitives; PX turns multiple primitives into an agent-facing decision trail.
Semantic context enginesExcellent at finding relevant chunks for natural-language tasks. Similarity remains a relevance signal, not proof that every caller, effect, or boundary was covered.
Static analysisExcellent at purpose-built security and quality questions using queryable program models. PX does not replace those analyzers; it can place their findings beside code, docs, runtime, and change receipts.
PXRoutes among exact, graph, semantic, docs, runtime, and repair lanes; exposes coverage and weaknesses; preserves receipts; and hands the agent the next bounded command.
Industry surfaceWhat it is genuinely strong atThe remaining agent problemPX's role
Cursor / JetBrains AIProject-aware AI context. Cursor describes semantic codebase indexing; JetBrains Codebase Mode automatically gathers relevant project context.Retrieved context is optimized for answering or acting. The user still needs an explicit account of the evidence lane, coverage horizon, and what a zero or omission means.PX makes routing, target identity, coverage, weaknesses, and recovery machine-readable before the model turns context into a conclusion.
GitHub CopilotRepository research, implementation planning, code changes, tests, commits, and pull-request workflows in managed execution environments.Autonomous execution is not the same as an independent evidence contract. The agent still needs reusable proof about why it inspected those files and what its checks establish.PX is agent-independent: Codex, Copilot, Claude, or another client can consume the same route receipts, evidence horizons, briefs, and verification packets.
SourcegraphLarge-scale code search plus search-based and precise cross-repository code navigation; SCIP can provide compiler-derived definitions and references.Precise navigation is a powerful evidence source, but an agent task also crosses docs authority, current dirty bytes, SQL/HTTP/message seams, runtime observations, planning, and post-edit verification.PX composes those lanes and refuses to call a partial index complete. It complements precise navigation rather than pretending to outperform compiler truth.
CodeQL / SemgrepQueryable program representations, data/control flow, security rules, reachability, and vulnerability triage.These tools answer specialized analysis questions exceptionally well; they are not a general agent entry, recovery, workflow, or evidence-lineage layer.PX can route security work to the right analyzer, retain the result’s proof class, and connect it to impact, docs, tests, permits, and closeout.
PXQuestion framing, deterministic route arbitration, cross-lane evidence composition, current-tree coverage labels, typed recovery, and receipt-bearing agent workflows.PX does not write the patch, replace compilers, or magically prove runtime behavior. It is only as strong as the sources and courts connected to it.Make every agent faster to ground, harder to fool with partial evidence, easier to audit, and capable of handing the next agent a reusable proof packet.

Competitive honesty: PX combines ideas that exist elsewhere—code graphs, semantic retrieval, static analysis, documentation search, and agent tooling. The differentiator is the product contract around them: deterministic-first routing, explicit evidence horizons, typed failure recovery, model-agnostic packets, and continuity from question through verification. Independent head-to-head productivity and accuracy benchmarks remain unknown; this page does not manufacture them.

Our actual opinion

The next generation of coding agents will not win by reading more files. They will win by knowing which evidence deserves trust, noticing when that evidence is incomplete, and carrying the proof forward after the model’s context is gone.

Change 03What becomes different in practice

From clever sessions to cumulative engineering.

Most agent workflows optimize the current answer. PX optimizes the handoff between questions, tools, models, sessions, and changes so the next step starts from evidence instead of folklore.

01 · Grounding

The agent stops guessing which search to run.

Industry default

Prompt → semantic search, grep, or file reading chosen implicitly by the agent.

With PX

Question → preserved anchors → scored deterministic routes → explicit winner, runner-up, weaknesses, and next step.

02 · Absence

“Nothing found” stops pretending to mean “nothing exists.”

Industry default

A zero result is often displayed without the index age, extractor coverage, target ambiguity, or dirty-tree gap that produced it.

With PX

Every structural answer can expose its evidence horizon; incomplete coverage triggers typed repair or current-tree overlay rather than confident absence.

03 · Change

Understanding and verification become one chain.

Industry default

The research transcript, edit plan, test output, and final summary live in separate places and decay when the session ends.

With PX

Brief → plan → simulate → verify → closeout carries target identity, proof references, risk, and result lineage across agents and time.

04 · Learning

Tool failure becomes product telemetry.

Industry default

When a search misses, the agent quietly switches to grep and the maintainers never learn that the tool failed its real customer.

With PX

Route receipts, miss packets, transition outcomes, and adoption measures turn agent behavior into an observable surface that PX itself can improve.

Proof 04What this page establishes—and what it does not

Receipts before superlatives.

The registry and generated atlas prove that the surfaces exist. Validation proves machine contracts about registered command relationships. Neither alone proves that PX beats every product, improves every task, or has complete coverage for every language and repository.

Source-proven

The product surface is generated, not hand-counted.

The capability inventory, registration state, runnable examples, and workflow groups are generated from px commands --all --json at build time.

Packaged

The agent entry contract exists as machine-readable output.

px ask --json emits question framing, route receipts, target identity, results, recovery, and evidence-horizon metadata where supported.

Held

Coverage remains conditional.

Language families, extractors, index generations, runtime sources, and dirty-tree overlays can be partial. PX is designed to disclose that boundary; it cannot erase it.

Unknown

Market superiority needs independent courts.

No externally controlled benchmark yet proves a universal accuracy, speed, token, or cost advantage over Cursor, Copilot, Sourcegraph, JetBrains, CodeQL, or Semgrep.

Technical reference · generated from the live registryOpen the complete 116-capability atlas. Explore every command
No PX capabilities match this filter.
Plate 0115 capabilities
Core evidence lane

Start, Route, Recover

Gets a new agent oriented, chooses the right evidence lane, and turns weak answers into deterministic recovery instead of manual repo wandering.

What agents use nowThe agent guesses a tool, runs broad grep or vector search, reads several files, and silently changes strategy when the first result is weak.

Why PX is differentPX frames the question, preserves hard anchors, chooses a typed lane, exposes why it chose it, and emits the next recovery command.

ask px ask Ask a natural language question — auto-routes to the right operation Runnable
What it does

Ask a natural language question — auto-routes to the right operation

When the agent reaches for it

any code question you'd type in natural language; use --json for question_frame/route_receipt and --with-docs --json before agents answer process, architecture, or status questions

Without PX

The agent guesses a tool, runs broad grep or vector search, reads several files, and silently changes strategy when the first result is weak.

Why PX changes the work

Ask a natural language question — auto-routes to the right operation PX frames the question, preserves hard anchors, chooses a typed lane, exposes why it chose it, and emits the next recovery command.

Run it
px ask --space myrepo --json "How does CheckoutService write an accounting receipt?"

AccessRun px ask.

JSONAuto-run safeRead-onlyLocal cache

ai px ai Unified AI question surface — auto-routes via QueryLane and emits an AnswerEnvelope JSON. PRD `px-intent-v1` PART 2 Phase 3 Runnable
What it does

Unified AI question surface — auto-routes via QueryLane and emits an AnswerEnvelope JSON. PRD `px-intent-v1` PART 2 Phase 3

When the agent reaches for it

AI-first question surface — auto-routes via QueryLane and emits a typed AnswerEnvelope JSON for agent consumption

Without PX

The agent guesses a tool, runs broad grep or vector search, reads several files, and silently changes strategy when the first result is weak.

Why PX changes the work

Unified AI question surface — auto-routes via QueryLane and emits an AnswerEnvelope JSON. PRD `px-intent-v1` PART 2 Phase 3 PX frames the question, preserves hard anchors, chooses a typed lane, exposes why it chose it, and emits the next recovery command.

Run it
px ai --space myrepo --json "Resolve the checkout receipt flow and report coverage gaps"

AccessRun px ai.

JSONAuto-run safeRead-only

commands px commands --for-question "<question>" --space <space> --json Route a concrete agent question to the best PX command trail without requiring the agent to memorize the CLI. Runnable
What it does

Route a concrete agent question to the best PX command trail without requiring the agent to memorize the CLI.

When the agent reaches for it

the agent has a task or question but does not know which exact PX lane should answer it

Without PX

The agent guesses a tool, runs broad grep or vector search, reads several files, and silently changes strategy when the first result is weak.

Why PX changes the work

Route a concrete agent question to the best PX command trail without requiring the agent to memorize the CLI. PX frames the question, preserves hard anchors, chooses a typed lane, exposes why it chose it, and emits the next recovery command.

Run it
px commands --for-question "What calls CheckoutService?" --space myrepo --json

AccessRun px commands --for-question "<question>" --space <space> --json.

JSONAuto-run safeRead-only

init px init Scan a newly cloned repo and print the exact PX setup path Runnable
What it does

Scan a newly cloned repo and print the exact PX setup path

When the agent reaches for it

first command in a newly cloned repo: diagnose Git/HEAD/space/index readiness and show step-by-step setup commands

Without PX

The agent guesses a tool, runs broad grep or vector search, reads several files, and silently changes strategy when the first result is weak.

Why PX changes the work

Scan a newly cloned repo and print the exact PX setup path PX frames the question, preserves hard anchors, chooses a typed lane, exposes why it chose it, and emits the next recovery command.

Run it
px init --repo . --space myrepo --json

AccessRun px init.

JSONAuto-run safeRead-only

explore px explore Cold-start orientation packet for a fresh agent in an unfamiliar repo Runnable
What it does

Cold-start orientation packet for a fresh agent in an unfamiliar repo

When the agent reaches for it

first command for a fresh model in an unfamiliar repo: return init/onboarding/doctor/audit/c4/xref command trails plus live index and agent-surface hints

Without PX

The agent guesses a tool, runs broad grep or vector search, reads several files, and silently changes strategy when the first result is weak.

Why PX changes the work

Cold-start orientation packet for a fresh agent in an unfamiliar repo PX frames the question, preserves hard anchors, chooses a typed lane, exposes why it chose it, and emits the next recovery command.

Run it
px explore --repo . --space myrepo --json

AccessRun px explore.

JSONAuto-run safeRead-only

onboard px onboard Aliases for onboarding flows Runnable
What it does

Aliases for onboarding flows

When the agent reaches for it

run `px onboard repo` as a memorable alias for `px agent init`

Without PX

The agent guesses a tool, runs broad grep or vector search, reads several files, and silently changes strategy when the first result is weak.

Why PX changes the work

Aliases for onboarding flows PX frames the question, preserves hard anchors, chooses a typed lane, exposes why it chose it, and emits the next recovery command.

Run it
px onboard --repo . --space myrepo --dry-run --json

AccessRun px onboard.

Auto-run safeRead-only

about px about Structured agent-facing docs for a px verb Runnable
What it does

Structured agent-facing docs for a px verb

When the agent reaches for it

learn the signature, return shape, examples, scoring, coverage, and pitfalls for a px command

Without PX

The agent guesses a tool, runs broad grep or vector search, reads several files, and silently changes strategy when the first result is weak.

Why PX changes the work

Structured agent-facing docs for a px verb PX frames the question, preserves hard anchors, chooses a typed lane, exposes why it chose it, and emits the next recovery command.

Run it
px about impact

AccessRun px about.

Auto-run safeRead-only

products px products Report product boundaries that agents might otherwise infer from proof artifacts or historical names Runnable
What it does

Report product boundaries that agents might otherwise infer from proof artifacts or historical names

When the agent reaches for it

verify whether names such as PX Lite identify an agent-accessible product, a proof-only boundary, or a retired alias

Without PX

The agent guesses a tool, runs broad grep or vector search, reads several files, and silently changes strategy when the first result is weak.

Why PX changes the work

Report product boundaries that agents might otherwise infer from proof artifacts or historical names PX frames the question, preserves hard anchors, chooses a typed lane, exposes why it chose it, and emits the next recovery command.

Run it
px products --json

AccessRun px products.

JSONAuto-run safeRead-only

mistakes px mistakes Show common PX query mistakes and recent miss context Runnable
What it does

Show common PX query mistakes and recent miss context

When the agent reaches for it

show common zero-result causes for a query shape, diagnose a symbol, or inspect the most recent cached miss

Without PX

The agent guesses a tool, runs broad grep or vector search, reads several files, and silently changes strategy when the first result is weak.

Why PX changes the work

Show common PX query mistakes and recent miss context PX frames the question, preserves hard anchors, chooses a typed lane, exposes why it chose it, and emits the next recovery command.

Run it
px mistakes query who-uses

AccessRun px mistakes.

JSONAuto-run safeRead-only

next px next Recommend next PX commands for an observed outcome Runnable
What it does

Recommend next PX commands for an observed outcome

When the agent reaches for it

ask what to run next after a specific command outcome, such as query who-uses returning zero results

Without PX

The agent guesses a tool, runs broad grep or vector search, reads several files, and silently changes strategy when the first result is weak.

Why PX changes the work

Recommend next PX commands for an observed outcome PX frames the question, preserves hard anchors, chooses a typed lane, exposes why it chose it, and emits the next recovery command.

Run it
px next --after "query who-uses returned zero" --space myrepo --json

AccessRun px next.

JSONAuto-run safeRead-only

explain-miss px explain-miss Explain whether a structural zero result looks real or like an index miss Runnable
What it does

Explain whether a structural zero result looks real or like an index miss

When the agent reaches for it

when who-uses/callers returns zero but the symbol exists, inspect source-churn freshness, graph refs, literal matches, and likely resolver/index causes before declaring unused

Without PX

The agent guesses a tool, runs broad grep or vector search, reads several files, and silently changes strategy when the first result is weak.

Why PX changes the work

Explain whether a structural zero result looks real or like an index miss PX frames the question, preserves hard anchors, chooses a typed lane, exposes why it chose it, and emits the next recovery command.

Run it
px explain-miss CheckoutService --space myrepo --json

AccessRun px explain-miss.

JSONAuto-run safeRead-onlyLocal cache

report-miss px report-miss Bundle a reproducible bug packet for a suspected PX miss Runnable
What it does

Bundle a reproducible bug packet for a suspected PX miss

When the agent reaches for it

package the command, doctor-lite context, symbol resolution, literal matches, suspected causes, repo head, expected evidence, and notes for a tool-builder bug report

Without PX

The agent guesses a tool, runs broad grep or vector search, reads several files, and silently changes strategy when the first result is weak.

Why PX changes the work

Bundle a reproducible bug packet for a suspected PX miss PX frames the question, preserves hard anchors, chooses a typed lane, exposes why it chose it, and emits the next recovery command.

Run it
px report-miss who-uses CheckoutService --space myrepo --json

AccessRun px report-miss.

Auto-run safeRead-only

report-last-miss px report-last-miss Re-render the most recent cached miss packet Runnable
What it does

Re-render the most recent cached miss packet

When the agent reaches for it

after explain-miss or a zero-result query cached a miss, attach expected evidence or notes without retyping the whole repro

Without PX

The agent guesses a tool, runs broad grep or vector search, reads several files, and silently changes strategy when the first result is weak.

Why PX changes the work

Re-render the most recent cached miss packet PX frames the question, preserves hard anchors, chooses a typed lane, exposes why it chose it, and emits the next recovery command.

Run it
px report-last-miss --json

AccessRun px report-last-miss.

JSONAuto-run safeRead-only

report-last-route px report-last-route Emit the last cached ask route receipt as a repro packet Runnable
What it does

Emit the last cached ask route receipt as a repro packet

When the agent reaches for it

after px ask chose a surprising route, inspect the question frame, winner, runner-up, execution recipe, and suggested steps

Without PX

The agent guesses a tool, runs broad grep or vector search, reads several files, and silently changes strategy when the first result is weak.

Why PX changes the work

Emit the last cached ask route receipt as a repro packet PX frames the question, preserves hard anchors, chooses a typed lane, exposes why it chose it, and emits the next recovery command.

Run it
px report-last-route --json

AccessRun px report-last-route.

JSONAuto-run safeRead-only

report-last-deep px report-last-deep Emit the last cached ask --deep execution packet Runnable
What it does

Emit the last cached ask --deep execution packet

When the agent reaches for it

after px ask --deep ran follow-up trails, inspect captured exit codes, stdout, stderr, and route receipt without rerunning

Without PX

The agent guesses a tool, runs broad grep or vector search, reads several files, and silently changes strategy when the first result is weak.

Why PX changes the work

Emit the last cached ask --deep execution packet PX frames the question, preserves hard anchors, chooses a typed lane, exposes why it chose it, and emits the next recovery command.

Run it
px report-last-deep --json

AccessRun px report-last-deep.

JSONAuto-run safeRead-only

Plate 0216 capabilities
Core evidence lane

Exact Code And Graph

Resolves definitions, callers, callees, effects, types, tests, and blast radius at source coordinates so an agent opens the right bytes first.

What agents use nowThe agent greps a name, follows imports by hand, asks an LSP one language at a time, and spends tokens reconstructing relationships.

Why PX is differentPX returns source coordinates plus indexed relationships, identity diagnostics, and a bounded current-tree cross-check in one evidence surface.

xray px xray Unified inspector — one call emits every signal an agent prompt needs Runnable
What it does

Unified inspector — one call emits every signal an agent prompt needs

When the agent reaches for it

full situational snapshot for an agent prompt (callers + callees + impact + naming + diagnostics + arch + recent edits)

Without PX

The agent greps a name, follows imports by hand, asks an LSP one language at a time, and spends tokens reconstructing relationships.

Why PX changes the work

Unified inspector — one call emits every signal an agent prompt needs PX returns source coordinates plus indexed relationships, identity diagnostics, and a bounded current-tree cross-check in one evidence surface.

Run it
px xray CheckoutService

AccessRun px xray.

JSONAuto-run safeRead-only

query px query Query the reference index Runnable
What it does

Query the reference index

When the agent reaches for it

fast exact/BM25 symbol and SQL-substrate search after health checks, or when an agent needs deterministic hits before xray/impact; query search --json flags weak/substrate-only hits when bounded literal repo evidence exists

Without PX

The agent greps a name, follows imports by hand, asks an LSP one language at a time, and spends tokens reconstructing relationships.

Why PX changes the work

Query the reference index PX returns source coordinates plus indexed relationships, identity diagnostics, and a bounded current-tree cross-check in one evidence surface.

Run it
px query who-uses CheckoutService --space myrepo --json

AccessRun px query.

Auto-run safeRead-only

callers px callers Show callers of a symbol — "who calls this?" Runnable
What it does

Show callers of a symbol — "who calls this?"

When the agent reaches for it

who calls this symbol? (ranked caller list)

Without PX

The agent greps a name, follows imports by hand, asks an LSP one language at a time, and spends tokens reconstructing relationships.

Why PX changes the work

Show callers of a symbol — "who calls this?" PX returns source coordinates plus indexed relationships, identity diagnostics, and a bounded current-tree cross-check in one evidence surface.

Run it
px callers CheckoutService --space myrepo --json

AccessRun px callers.

JSONAuto-run safeRead-only

callees px callees Show callees of a symbol — "what does this call?" Runnable
What it does

Show callees of a symbol — "what does this call?"

When the agent reaches for it

what does this symbol call? (outbound call graph)

Without PX

The agent greps a name, follows imports by hand, asks an LSP one language at a time, and spends tokens reconstructing relationships.

Why PX changes the work

Show callees of a symbol — "what does this call?" PX returns source coordinates plus indexed relationships, identity diagnostics, and a bounded current-tree cross-check in one evidence surface.

Run it
px callees CheckoutService --space myrepo --json

AccessRun px callees.

JSONAuto-run safeRead-only

impact px impact Impact analysis — "what breaks if I change this symbol?" Runnable
What it does

Impact analysis — "what breaks if I change this symbol?"

When the agent reaches for it

what breaks if I change this symbol? (structural impact, ranked)

Without PX

The agent greps a name, follows imports by hand, asks an LSP one language at a time, and spends tokens reconstructing relationships.

Why PX changes the work

Impact analysis — "what breaks if I change this symbol?" PX returns source coordinates plus indexed relationships, identity diagnostics, and a bounded current-tree cross-check in one evidence surface.

Run it
px impact CheckoutService --runtime-vs-type

AccessRun px impact.

JSONAuto-run safeRead-only

effects px effects Side-effect facts for a symbol from the `code_effects` table Runnable
What it does

Side-effect facts for a symbol from the `code_effects` table

When the agent reaches for it

what real-world side effects does this symbol have? (DB writes, external APIs, env reads)

Without PX

The agent greps a name, follows imports by hand, asks an LSP one language at a time, and spends tokens reconstructing relationships.

Why PX changes the work

Side-effect facts for a symbol from the `code_effects` table PX returns source coordinates plus indexed relationships, identity diagnostics, and a bounded current-tree cross-check in one evidence surface.

Run it
px effects CheckoutService --space myrepo --json

AccessRun px effects.

JSONAuto-run safeRead-only

context px context Agent context — render markdown for coder/reviewer agents Runnable
What it does

Agent context — render markdown for coder/reviewer agents

When the agent reaches for it

render markdown context for a symbol or file to inject into an agent prompt

Without PX

The agent greps a name, follows imports by hand, asks an LSP one language at a time, and spends tokens reconstructing relationships.

Why PX changes the work

Agent context — render markdown for coder/reviewer agents PX returns source coordinates plus indexed relationships, identity diagnostics, and a bounded current-tree cross-check in one evidence surface.

Run it
px context symbol CheckoutService --space myrepo

AccessRun px context.

Auto-run safeRead-only

plan-change px plan-change Generate a safe phased edit plan for changing a symbol Runnable
What it does

Generate a safe phased edit plan for changing a symbol

When the agent reaches for it

produce a safe phased edit order before refactoring a shared symbol

Without PX

The agent greps a name, follows imports by hand, asks an LSP one language at a time, and spends tokens reconstructing relationships.

Why PX changes the work

Generate a safe phased edit plan for changing a symbol PX returns source coordinates plus indexed relationships, identity diagnostics, and a bounded current-tree cross-check in one evidence surface.

Run it
px plan-change CheckoutService --space myrepo --json

AccessRun px plan-change.

JSONAuto-run safeRead-only

impact-rename px impact-rename Semantic impact of a rename — "is this a mechanical rename or a role change?" Runnable
What it does

Semantic impact of a rename — "is this a mechanical rename or a role change?"

When the agent reaches for it

before any rename: is this a mechanical rename or a semantic role change?

Without PX

The agent greps a name, follows imports by hand, asks an LSP one language at a time, and spends tokens reconstructing relationships.

Why PX changes the work

Semantic impact of a rename — "is this a mechanical rename or a role change?" PX returns source coordinates plus indexed relationships, identity diagnostics, and a bounded current-tree cross-check in one evidence surface.

Run it
px impact-rename LegacyCheckout CheckoutService --space myrepo --json

AccessRun px impact-rename.

Auto-run safeRead-only

estimate-refactor-loc px estimate-refactor-loc Estimate refactor LOC for a symbol — rough blast-radius measurement Runnable
What it does

Estimate refactor LOC for a symbol — rough blast-radius measurement

When the agent reaches for it

self-check 'this refactor is small' claims before dispatching a worker against an under-estimated scope

Without PX

The agent greps a name, follows imports by hand, asks an LSP one language at a time, and spends tokens reconstructing relationships.

Why PX changes the work

Estimate refactor LOC for a symbol — rough blast-radius measurement PX returns source coordinates plus indexed relationships, identity diagnostics, and a bounded current-tree cross-check in one evidence surface.

Run it
px estimate-refactor-loc CheckoutService --space myrepo --json

AccessRun px estimate-refactor-loc.

JSONAuto-run safeRead-only

types px types Source-coordinate type and scope lookup Catalog only
What it does

Source-coordinate type and scope lookup

When the agent reaches for it

verify the type of a local expression at a file:line before deciding whether a text/macro/callsite match is real

Without PX

The agent greps a name, follows imports by hand, asks an LSP one language at a time, and spends tokens reconstructing relationships.

Why PX changes the work

Source-coordinate type and scope lookup PX returns source coordinates plus indexed relationships, identity diagnostics, and a bounded current-tree cross-check in one evidence surface.

Run it
px ask --space myrepo --json "What is the type of checkout at src/checkout/service.rs:42?"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

Read-onlyHuman review

test-coverage px test-coverage Test coverage evidence for a symbol from indexed test references Catalog only
What it does

Test coverage evidence for a symbol from indexed test references

When the agent reaches for it

is this symbol tested, by which test files, and is coverage direct or indirect?

Without PX

The agent greps a name, follows imports by hand, asks an LSP one language at a time, and spends tokens reconstructing relationships.

Why PX changes the work

Test coverage evidence for a symbol from indexed test references PX returns source coordinates plus indexed relationships, identity diagnostics, and a bounded current-tree cross-check in one evidence surface.

Run it
px ask --space myrepo --json "What tests cover CheckoutService?"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

Read-onlyHuman review

taint px taint Conservative taint-spine evidence from a seed to indexed sinks Catalog only
What it does

Conservative taint-spine evidence from a seed to indexed sinks

When the agent reaches for it

does this symbol/route/input touch DB writes, messages, or external APIs? explain with code_effects + code_references evidence

Without PX

The agent greps a name, follows imports by hand, asks an LSP one language at a time, and spends tokens reconstructing relationships.

Why PX changes the work

Conservative taint-spine evidence from a seed to indexed sinks PX returns source coordinates plus indexed relationships, identity diagnostics, and a bounded current-tree cross-check in one evidence surface.

Run it
px ask --space myrepo --json "Trace CheckoutService to database and HTTP sinks"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

JSONRead-onlyHuman review

reachable px reachable SQL reachability evidence lookup Route only
What it does

SQL reachability evidence lookup

When the agent reaches for it

is this SQL function reachable via pg_trigger/literals/migrations?

Without PX

The agent greps a name, follows imports by hand, asks an LSP one language at a time, and spends tokens reconstructing relationships.

Why PX changes the work

SQL reachability evidence lookup PX returns source coordinates plus indexed relationships, identity diagnostics, and a bounded current-tree cross-check in one evidence surface.

Run it
px ask --space myrepo --json "What is reachable from CheckoutService?"

AccessAccess through px ask or the command router; it is not a top-level CLI verb.

Read-onlyHuman review

type-signature px type-signature Type complexity signature lookup (from code_types) Route only
What it does

Type complexity signature lookup (from code_types)

When the agent reaches for it

what are this symbol's type parameters / complexity?

Without PX

The agent greps a name, follows imports by hand, asks an LSP one language at a time, and spends tokens reconstructing relationships.

Why PX changes the work

Type complexity signature lookup (from code_types) PX returns source coordinates plus indexed relationships, identity diagnostics, and a bounded current-tree cross-check in one evidence surface.

Run it
px ask --space myrepo --json "Show the full type signature of CheckoutService"

AccessAccess through px ask or the command router; it is not a top-level CLI verb.

Read-onlyHuman review

file-claims px file-claims fox_file_claim registry status for a path Route only
What it does

fox_file_claim registry status for a path

When the agent reaches for it

who claimed this file? any stomps?

Without PX

The agent greps a name, follows imports by hand, asks an LSP one language at a time, and spends tokens reconstructing relationships.

Why PX changes the work

fox_file_claim registry status for a path PX returns source coordinates plus indexed relationships, identity diagnostics, and a bounded current-tree cross-check in one evidence surface.

Run it
px ask --space myrepo --json "What files are claimed for the CheckoutService work?"

AccessAccess through px ask or the command router; it is not a top-level CLI verb.

Read-onlyHuman review

Plate 035 capabilities
Core evidence lane

Docs And Evidence

Joins code truth with documentation, observed tool runs, and provenance receipts while keeping code, docs, and runtime evidence horizons separate.

What agents use nowThe agent searches prose separately, trusts whichever document sounds current, and mixes design claims with source or runtime truth.

Why PX is differentPX binds docs to code subjects, ranks focused semantic sections, reports conflicts and coverage gaps, and preserves provenance.

docs px docs Documentation atlas, Oracle checks, context packs, and Markdown LSP Runnable
What it does

Documentation atlas, Oracle checks, context packs, and Markdown LSP

When the agent reaches for it

visualize and validate docs as live projections of repo facts, or reconcile the doc graph against files that no longer exist (`docs fs-check`, read-only unless `--write`)

Without PX

The agent searches prose separately, trusts whichever document sounds current, and mixes design claims with source or runtime truth.

Why PX changes the work

Documentation atlas, Oracle checks, context packs, and Markdown LSP PX binds docs to code subjects, ranks focused semantic sections, reports conflicts and coverage gaps, and preserves provenance.

Run it
px docs context "accounting receipt verification" --space myrepo --budget 1200 --json

AccessRun px docs.

Auto-run safeRead-only

evidence px evidence Inspect and ingest normalized observed tool-run evidence Runnable
What it does

Inspect and ingest normalized observed tool-run evidence

When the agent reaches for it

you have SARIF or imported tool observations and need freshness, provenance, locations, and explainable findings

Without PX

The agent searches prose separately, trusts whichever document sounds current, and mixes design claims with source or runtime truth.

Why PX changes the work

Inspect and ingest normalized observed tool-run evidence PX binds docs to code subjects, ranks focused semantic sections, reports conflicts and coverage gaps, and preserves provenance.

Run it
px evidence current --file src/checkout/service.rs --space myrepo --json

AccessRun px evidence.

Auto-run safeRead-only

extract-docs px extract docs Parse Markdown docs into canonical doc graph rows. Read-only by default; persist to doc tables with --write-db Runnable
What it does

Parse Markdown docs into canonical doc graph rows. Read-only by default; persist to doc tables with --write-db

When the agent reaches for it

preview or refresh section/link/binding rows for `px docs atlas` and Oracle checks; pass `--write-db` only when intentionally updating docs tables

Without PX

The agent searches prose separately, trusts whichever document sounds current, and mixes design claims with source or runtime truth.

Why PX changes the work

Parse Markdown docs into canonical doc graph rows. Read-only by default; persist to doc tables with --write-db PX binds docs to code subjects, ranks focused semantic sections, reports conflicts and coverage gaps, and preserves provenance.

Run it
px extract docs [REPO_PATH]

AccessRun px extract docs.

JSONAuto-run safeRead-only

witness px witness FDAG V3 Code Witness receipts and graph packets for code changes Runnable
What it does

FDAG V3 Code Witness receipts and graph packets for code changes

When the agent reaches for it

capture commit/staged/unstaged diffs as proof_refs plus native code_witness graph rows

Without PX

The agent searches prose separately, trusts whichever document sounds current, and mixes design claims with source or runtime truth.

Why PX changes the work

FDAG V3 Code Witness receipts and graph packets for code changes PX binds docs to code subjects, ranks focused semantic sections, reports conflicts and coverage gaps, and preserves provenance.

Run it
px witness graph --project myrepo --repo . --max-impacts 200 --json

AccessRun px witness.

Auto-run safeRead-only

fdag-v3 px fdag-v3 FDAG V3 replay evidence and agent-memory inspection surfaces Runnable
What it does

FDAG V3 replay evidence and agent-memory inspection surfaces

When the agent reaches for it

hydrate Router/workflow evidence, inspect organ boundaries, arm action hooks, search retained memory, or inspect immune adapter health/readiness/proposals/trials

Without PX

The agent searches prose separately, trusts whichever document sounds current, and mixes design claims with source or runtime truth.

Why PX changes the work

FDAG V3 replay evidence and agent-memory inspection surfaces PX binds docs to code subjects, ranks focused semantic sections, reports conflicts and coverage gaps, and preserves provenance.

Run it
px fdag-v3 health --json

AccessRun px fdag-v3.

Auto-run safeRead-only

Plate 0413 capabilities
High evidence lane

Plan, Simulate, Verify

Builds an evidence-backed edit packet, predicts affected sites and tests, verifies the result, and preserves receipt lineage across the whole agent loop.

What agents use nowThe agent plans from memory, edits first, discovers collateral damage in CI, and writes a retrospective summary with no machine-checkable lineage.

Why PX is differentPX turns understanding, planning, simulation, verification, and closeout into a connected evidence trail before and after mutation.

brief px brief Build a paste-ready worker briefing for one or more owned targets Runnable
What it does

Build a paste-ready worker briefing for one or more owned targets

When the agent reaches for it

before dispatching a worker: package each owned symbol/file with callers, impact, contracts, diagnostics, and current-tree provenance

Without PX

The agent plans from memory, edits first, discovers collateral damage in CI, and writes a retrospective summary with no machine-checkable lineage.

Why PX changes the work

Build a paste-ready worker briefing for one or more owned targets PX turns understanding, planning, simulation, verification, and closeout into a connected evidence trail before and after mutation.

Run it
px brief CheckoutService src/checkout/service.rs --space myrepo --json

AccessRun px brief.

JSONAuto-run safeRead-only

understand px understand Understand a target — produce an `Observation` value (canonical symbols + call-graph + impact + cochange + recent_edits + typed caller detail). Phase B1 Wave γ wires the `Understand` trait (α + β) into the CLI surface with optional receipt persistence and `callers_detailed` enrichment. Mirrors the `Commands::Plan` dispatch shape Runnable
What it does

Understand a target — produce an `Observation` value (canonical symbols + call-graph + impact + cochange + recent_edits + typed caller detail). Phase B1 Wave γ wires the `Understand` trait (α + β) into the CLI surface with optional receipt persistence and `callers_detailed` enrichment. Mirrors the `Commands::Plan` dispatch shape

When the agent reaches for it

collect canonical symbols, callers, impact, cochange, and recent edits

Without PX

The agent plans from memory, edits first, discovers collateral damage in CI, and writes a retrospective summary with no machine-checkable lineage.

Why PX changes the work

Understand a target — produce an `Observation` value (canonical symbols + call-graph + impact + cochange + recent_edits + typed caller detail). Phase B1 Wave γ wires the `Understand` trait (α + β) into the CLI surface with optional receipt persistence and `callers_detailed` enrichment. Mirrors the `Commands::Plan` dispatch shape PX turns understanding, planning, simulation, verification, and closeout into a connected evidence trail before and after mutation.

Run it
px understand symbol CheckoutService --space myrepo --json

AccessRun px understand.

Auto-run safeRead-only

plan px plan Plan an agent-contract edit — produce an `EditPlan` value (ordered sites + steps + rationale + risks + required_doc_updates). Phase B0 Wave γ wires the `Plan` trait (Waves α + β) into the CLI surface so agents can fetch a typed plan + doc-drift survey without touching code. Mirrors the `Commands::Simulate` dispatch shape Runnable
What it does

Plan an agent-contract edit — produce an `EditPlan` value (ordered sites + steps + rationale + risks + required_doc_updates). Phase B0 Wave γ wires the `Plan` trait (Waves α + β) into the CLI surface so agents can fetch a typed plan + doc-drift survey without touching code. Mirrors the `Commands::Simulate` dispatch shape

When the agent reaches for it

turn an intended contract edit into ordered steps, risks, and required docs

Without PX

The agent plans from memory, edits first, discovers collateral damage in CI, and writes a retrospective summary with no machine-checkable lineage.

Why PX changes the work

Plan an agent-contract edit — produce an `EditPlan` value (ordered sites + steps + rationale + risks + required_doc_updates). Phase B0 Wave γ wires the `Plan` trait (Waves α + β) into the CLI surface so agents can fetch a typed plan + doc-drift survey without touching code. Mirrors the `Commands::Simulate` dispatch shape PX turns understanding, planning, simulation, verification, and closeout into a connected evidence trail before and after mutation.

Run it
px plan rename LegacyCheckout CheckoutService --space myrepo --json

AccessRun px plan.

Auto-run safeRead-only

simulate px simulate Simulate an agent-contract change — produce a `Simulation` value (affected sites + predicted failing tests + risk score) without touching the code. Phase A Inc 2 Wave E wires the `Simulate` trait (Waves C+D) into the CLI surface Runnable
What it does

Simulate an agent-contract change — produce a `Simulation` value (affected sites + predicted failing tests + risk score) without touching the code. Phase A Inc 2 Wave E wires the `Simulate` trait (Waves C+D) into the CLI surface

When the agent reaches for it

predict affected sites, failing tests, and risk before editing

Without PX

The agent plans from memory, edits first, discovers collateral damage in CI, and writes a retrospective summary with no machine-checkable lineage.

Why PX changes the work

Simulate an agent-contract change — produce a `Simulation` value (affected sites + predicted failing tests + risk score) without touching the code. Phase A Inc 2 Wave E wires the `Simulate` trait (Waves C+D) into the CLI surface PX turns understanding, planning, simulation, verification, and closeout into a connected evidence trail before and after mutation.

Run it
px simulate rename LegacyCheckout CheckoutService --space myrepo --json

AccessRun px simulate.

Auto-run safeRead-only

verify px verify Verify an edit against the FoxRef index (and optionally a prior plan receipt) — produce a `Verification` value (effect_diff + predicted fails + risks + verdict + fresh receipt). Phase B2 Wave γ wires the `Verify` trait (α + β) into the CLI surface with optional receipt persistence and Option-B `referenced_plan` pre-check against `execution_receipts`. Mirrors the `Commands::Understand` dispatch shape Runnable
What it does

Verify an edit against the FoxRef index (and optionally a prior plan receipt) — produce a `Verification` value (effect_diff + predicted fails + risks + verdict + fresh receipt). Phase B2 Wave γ wires the `Verify` trait (α + β) into the CLI surface with optional receipt persistence and Option-B `referenced_plan` pre-check against `execution_receipts`. Mirrors the `Commands::Understand` dispatch shape

When the agent reaches for it

check a patch's effects, predicted failures, risks, and verdict

Without PX

The agent plans from memory, edits first, discovers collateral damage in CI, and writes a retrospective summary with no machine-checkable lineage.

Why PX changes the work

Verify an edit against the FoxRef index (and optionally a prior plan receipt) — produce a `Verification` value (effect_diff + predicted fails + risks + verdict + fresh receipt). Phase B2 Wave γ wires the `Verify` trait (α + β) into the CLI surface with optional receipt persistence and Option-B `referenced_plan` pre-check against `execution_receipts`. Mirrors the `Commands::Understand` dispatch shape PX turns understanding, planning, simulation, verification, and closeout into a connected evidence trail before and after mutation.

Run it
px verify patch /tmp/checkout.patch --space myrepo --json

AccessRun px verify.

Auto-run safeRead-only

flow px flow Orchestrated contract-chain flows — compose Understand → Plan → Simulate → Verify into a single call with receipt lineage threaded across every step. Phase C0 Wave α opens the consumer layer on top of the substrate proven 4× by Simulate / Plan / Understand / Verify Runnable
What it does

Orchestrated contract-chain flows — compose Understand → Plan → Simulate → Verify into a single call with receipt lineage threaded across every step. Phase C0 Wave α opens the consumer layer on top of the substrate proven 4× by Simulate / Plan / Understand / Verify

When the agent reaches for it

run the contract-chain inspection flow with receipt lineage

Without PX

The agent plans from memory, edits first, discovers collateral damage in CI, and writes a retrospective summary with no machine-checkable lineage.

Why PX changes the work

Orchestrated contract-chain flows — compose Understand → Plan → Simulate → Verify into a single call with receipt lineage threaded across every step. Phase C0 Wave α opens the consumer layer on top of the substrate proven 4× by Simulate / Plan / Understand / Verify PX turns understanding, planning, simulation, verification, and closeout into a connected evidence trail before and after mutation.

Run it
px flow rename LegacyCheckout CheckoutService --space myrepo --json

AccessRun px flow.

Auto-run safeRead-only

session px session Session contracts, worker transition gates, and dispatch preflight Runnable
What it does

Session contracts, worker transition gates, and dispatch preflight

When the agent reaches for it

decide next legal session action or preflight worker scopes before dispatch

Without PX

The agent plans from memory, edits first, discovers collateral damage in CI, and writes a retrospective summary with no machine-checkable lineage.

Why PX changes the work

Session contracts, worker transition gates, and dispatch preflight PX turns understanding, planning, simulation, verification, and closeout into a connected evidence trail before and after mutation.

Run it
px session preflight --repo . --space myrepo --json

AccessRun px session.

Auto-run safeRead-only

session-prep px session-prep Main-Claude worker briefing packet for active sessions Route only
What it does

Main-Claude worker briefing packet for active sessions

When the agent reaches for it

prepare a blank session template with px research commands, worker topology, contract, and prompt suffix

Without PX

The agent plans from memory, edits first, discovers collateral damage in CI, and writes a retrospective summary with no machine-checkable lineage.

Why PX changes the work

Main-Claude worker briefing packet for active sessions PX turns understanding, planning, simulation, verification, and closeout into a connected evidence trail before and after mutation.

Run it
px ask --space myrepo --json "Prepare an agent session for the CheckoutService change"

AccessAccess through px ask or the command router; it is not a top-level CLI verb.

Read-onlyHuman review

transitions px transitions Inspect or record suggested-next transition outcomes Catalog only
What it does

Inspect or record suggested-next transition outcomes

When the agent reaches for it

see which next-tool recommendations are being suggested, how often, whether learned transition rows are accumulating, or append an accepted/failed/skipped outcome after a follow-up runs

Without PX

The agent plans from memory, edits first, discovers collateral damage in CI, and writes a retrospective summary with no machine-checkable lineage.

Why PX changes the work

Inspect or record suggested-next transition outcomes PX turns understanding, planning, simulation, verification, and closeout into a connected evidence trail before and after mutation.

Run it
px ask --space myrepo --json "Which PX command transitions are helping agents after a zero result?"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

Read-onlyHuman review

mission-pack px mission-pack Read-only advisory mission pack for agent execution control Catalog only
What it does

Read-only advisory mission pack for agent execution control

When the agent reaches for it

brief a weaker or parallel agent with target scope, boundaries, evidence commands, verification hints, and confidence-budget stop conditions before it edits

Without PX

The agent plans from memory, edits first, discovers collateral damage in CI, and writes a retrospective summary with no machine-checkable lineage.

Why PX changes the work

Read-only advisory mission pack for agent execution control PX turns understanding, planning, simulation, verification, and closeout into a connected evidence trail before and after mutation.

Run it
px ask --space myrepo --json "Build a mission pack for changing CheckoutService"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

Read-onlyHuman review

permit px permit Read-only boundary permit report for proposed agent edits Catalog only
What it does

Read-only boundary permit report for proposed agent edits

When the agent reaches for it

verify declared edit files against forbidden generated/cache/VCS paths, required evidence, and required tests before an agent edits

Without PX

The agent plans from memory, edits first, discovers collateral damage in CI, and writes a retrospective summary with no machine-checkable lineage.

Why PX changes the work

Read-only boundary permit report for proposed agent edits PX turns understanding, planning, simulation, verification, and closeout into a connected evidence trail before and after mutation.

Run it
px ask --space myrepo --json "Is the CheckoutService edit permitted by current evidence?"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

Read-onlyHuman review

confidence-budget px confidence-budget Read-only operational confidence verdict from explicit agent risk inputs Catalog only
What it does

Read-only operational confidence verdict from explicit agent risk inputs

When the agent reaches for it

convert observed API-change, DB-write, superseded-evidence, cross-language, untested-symbol, and receipt-gap risks into proceed, auditor, or stop guidance

Without PX

The agent plans from memory, edits first, discovers collateral damage in CI, and writes a retrospective summary with no machine-checkable lineage.

Why PX changes the work

Read-only operational confidence verdict from explicit agent risk inputs PX turns understanding, planning, simulation, verification, and closeout into a connected evidence trail before and after mutation.

Run it
px ask --space myrepo --json "What confidence budget should gate the CheckoutService edit?"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

Read-onlyHuman review

contradiction-court px contradiction-court Read-only contradiction check for agent claims against explicit evidence Catalog only
What it does

Read-only contradiction check for agent claims against explicit evidence

When the agent reaches for it

compare an agent claim or plan summary against px facts, diff summaries, test signals, and receipt notes before trusting the handoff

Without PX

The agent plans from memory, edits first, discovers collateral damage in CI, and writes a retrospective summary with no machine-checkable lineage.

Why PX changes the work

Read-only contradiction check for agent claims against explicit evidence PX turns understanding, planning, simulation, verification, and closeout into a connected evidence trail before and after mutation.

Run it
px ask --space myrepo --json "Court the claim that CheckoutService has no callers"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

Read-onlyHuman review

Plate 0526 capabilities
High evidence lane

Architecture, Risk, Quality

Finds coupling, graph-unreachable signals, naming drift, architecture motifs, dependency exposure, temporal risk, and refactor candidates without calling heuristics compiler proof.

What agents use nowThe agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX is differentPX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

audit px audit Project health audit — graph-unreferenced signals, hotspots, coupling, and score Runnable
What it does

Project health audit — graph-unreferenced signals, hotspots, coupling, and score

When the agent reaches for it

project health report: zero incoming refs, hotspots, coupling, overall score

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Project health audit — graph-unreferenced signals, hotspots, coupling, and score PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px audit

AccessRun px audit.

JSONAuto-run safeRead-only

audit-self px audit-self Self-audit px substrate decay signals Catalog only
What it does

Self-audit px substrate decay signals

When the agent reaches for it

check px phase coverage, extractor wiring, expired file claims, probe firings, and perf p95s in one AnswerEnvelope

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Self-audit px substrate decay signals PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px ask --space myrepo --json "Audit PX itself for command and graph integrity"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

Read-onlyHuman review

stats px stats Show index statistics Runnable
What it does

Show index statistics

When the agent reaches for it

show index statistics or run --adoption to measure whether agents are actually choosing PX over grep-class discovery

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Show index statistics PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px stats

AccessRun px stats.

JSONAuto-run safeRead-only

status px status Diagnostic status — repo path, binary index state, DB counts for a space Runnable
What it does

Diagnostic status — repo path, binary index state, DB counts for a space

When the agent reaches for it

diagnostic: repo path + binary index state + DB counts for a space

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Diagnostic status — repo path, binary index state, DB counts for a space PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px status

AccessRun px status.

JSONAuto-run safeRead-only

diagnostics px diagnostics LSP diagnostics — unified query over diagnostics from rust-analyzer, tsserver, eslint, etc Runnable
What it does

LSP diagnostics — unified query over diagnostics from rust-analyzer, tsserver, eslint, etc

When the agent reaches for it

compiler-verified issues from rust-analyzer / tsserver / eslint, or focused source-text bug classes like anyhow Error formatted with bare {}

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

LSP diagnostics — unified query over diagnostics from rust-analyzer, tsserver, eslint, etc PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px diagnostics

AccessRun px diagnostics.

JSONAuto-run safeRead-only

naming px naming Naming convention analysis — find symbols that break their module's local style Runnable
What it does

Naming convention analysis — find symbols that break their module's local style

When the agent reaches for it

code review: find symbols that break their module's local style

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Naming convention analysis — find symbols that break their module's local style PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px naming

AccessRun px naming.

Auto-run safeRead-only

arch-patterns px arch-patterns Architectural pattern detection — match motif clusters against a named pattern library Runnable
What it does

Architectural pattern detection — match motif clusters against a named pattern library

When the agent reaches for it

detect named design patterns (Repository, Observer, Builder, ...) in the codebase

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Architectural pattern detection — match motif clusters against a named pattern library PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px arch-patterns

AccessRun px arch-patterns.

Auto-run safeRead-only

recommend-refactors px recommend-refactors Proactive refactoring recommendations — combine all signals into a ranked action list Runnable
What it does

Proactive refactoring recommendations — combine all signals into a ranked action list

When the agent reaches for it

after changes: priority-ranked list aggregating naming + types + diagnostics + usage

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Proactive refactoring recommendations — combine all signals into a ranked action list PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px recommend-refactors

AccessRun px recommend-refactors.

JSONAuto-run safeRead-only

prospect px prospect Diamond prospecting — rank files, symbols, and clusters by mining fertility Runnable
What it does

Diamond prospecting — rank files, symbols, and clusters by mining fertility

When the agent reaches for it

rank files/symbols/clusters by diamond mining fertility

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Diamond prospecting — rank files, symbols, and clusters by mining fertility PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px prospect --help

AccessRun px prospect.

Auto-run safeRead-only

compare px compare Compare two projects — find how source capabilities enhance the target Runnable
What it does

Compare two projects — find how source capabilities enhance the target

When the agent reaches for it

find how one project's capabilities could enhance another

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Compare two projects — find how source capabilities enhance the target PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px compare --target CheckoutService

AccessRun px compare.

JSONAuto-run safeRead-only

adapt px adapt Scan target repos for source-pack adaptation opportunities Catalog only
What it does

Scan target repos for source-pack adaptation opportunities

When the agent reaches for it

treat one repo as a pattern library and rank concrete experiments across local projects

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Scan target repos for source-pack adaptation opportunities PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px ask --space myrepo --json "Adapt this repository's PX profile to its observed command needs"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

Read-onlyHuman review

pack px pack Verify portable packs for structure, safety, and Codex readiness Catalog only
What it does

Verify portable packs for structure, safety, and Codex readiness

When the agent reaches for it

validate pack portability, install safety, superseded tool naming, evidence, examples, and verification quality

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Verify portable packs for structure, safety, and Codex readiness PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px ask --space myrepo --json "Pack the CheckoutService evidence needed by a coding agent"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

Read-onlyHuman review

manifest px manifest Extract capability manifest — what this project offers Runnable
What it does

Extract capability manifest — what this project offers

When the agent reaches for it

extract the capability manifest — what this project offers

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Extract capability manifest — what this project offers PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px manifest --space myrepo --json

AccessRun px manifest.

JSONAuto-run safeRead-only

path-deps px path-deps Analyze path dependency surface — "how much of each dep do we actually use?" Runnable
What it does

Analyze path dependency surface — "how much of each dep do we actually use?"

When the agent reaches for it

how much of each Cargo dep do we actually use?

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Analyze path dependency surface — "how much of each dep do we actually use?" PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px path-deps

AccessRun px path-deps.

JSONAuto-run safeRead-only

c4 px c4 Generate C4-style architecture diagrams (Mermaid) Runnable
What it does

Generate C4-style architecture diagrams (Mermaid)

When the agent reaches for it

generate C4-style architecture diagrams (Mermaid)

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Generate C4-style architecture diagrams (Mermaid) PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px c4 --repo . --space myrepo --json

AccessRun px c4.

JSONAuto-run safeRead-only

c4-container px c4-container C4 container membership for a symbol/file Route only
What it does

C4 container membership for a symbol/file

When the agent reaches for it

which C4 container does this symbol belong to?

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

C4 container membership for a symbol/file PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px ask --space myrepo --json "Show the C4 container containing CheckoutService"

AccessAccess through px ask or the command router; it is not a top-level CLI verb.

Read-onlyHuman review

graph px graph Interactive code visualization (call graph, directory tree, architecture) Runnable
What it does

Interactive code visualization (call graph, directory tree, architecture)

When the agent reaches for it

interactive call-graph / directory / architecture visualization (HTML)

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Interactive code visualization (call graph, directory tree, architecture) PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px graph CheckoutService --space myrepo --json

AccessRun px graph.

JSONAuto-run safeRead-only

evolve px evolve Temporal risk report for a symbol or file from git history plus px impact Catalog only
What it does

Temporal risk report for a symbol or file from git history plus px impact

When the agent reaches for it

what is becoming risky around this symbol/file? combines recent commits, authors, churn, co-change, and indexed impact

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Temporal risk report for a symbol or file from git history plus px impact PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px ask --space myrepo --json "How has CheckoutService changed and co-changed recently?"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

Read-onlyHuman review

risk px risk Read-only supply-chain/dataflow risk cockpit workflow Catalog only
What it does

Read-only supply-chain/dataflow risk cockpit workflow

When the agent reaches for it

compose doctor, effects, taint, exposure, sbom, evidence, and invariant checks without writing evidence

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Read-only supply-chain/dataflow risk cockpit workflow PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px ask --space myrepo --json "What makes CheckoutService risky to change?"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

Read-onlyHuman review

risk-forecast px risk-forecast Forecast temporal risk for files changed since a git ref Catalog only
What it does

Forecast temporal risk for files changed since a git ref

When the agent reaches for it

before committing a patch: rank changed files by recent churn, authors, and co-change partners

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Forecast temporal risk for files changed since a git ref PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px ask --space myrepo --json "Forecast risk for the current checkout patch"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

Read-onlyHuman review

repair px repair Diagnose failing logs into a safe repair plan (no apply) Catalog only
What it does

Diagnose failing logs into a safe repair plan (no apply)

When the agent reaches for it

turn a failing test/build log into suspected files, symbols, px commands, and verification steps without editing code

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Diagnose failing logs into a safe repair plan (no apply) PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px ask --space myrepo --json "How should PX repair missing CheckoutService references?"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

Read-onlyHuman review

invariant px invariant Lightweight invariant checks over px fact rows Catalog only
What it does

Lightweight invariant checks over px fact rows

When the agent reaches for it

before trusting new extractor evidence or committing graph changes: check known fact-shape invariants such as js-truth row contracts

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Lightweight invariant checks over px fact rows PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px ask --space myrepo --json "Which indexed fact-shape invariants protect checkout references?"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

Read-onlyHuman review

sbom px sbom Reachable dependency inventory from manifests plus import/use evidence Catalog only
What it does

Reachable dependency inventory from manifests plus import/use evidence

When the agent reaches for it

which installed dependencies have static reachability evidence? use before dependency cleanup, exposure, or security review

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Reachable dependency inventory from manifests plus import/use evidence PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px ask --space myrepo --json "Which reachable dependencies expose CheckoutService?"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

Read-onlyHuman review

exposure px exposure Compose taint flow and reachable dependency evidence into exposure risk Catalog only
What it does

Compose taint flow and reachable dependency evidence into exposure risk

When the agent reaches for it

is this route/symbol exposed through both data-flow sinks and reachable dependency code? use after taint or sbom when you need one joined risk read

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Compose taint flow and reachable dependency evidence into exposure risk PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px ask --space myrepo --json "What is the reachable exposure of CheckoutService?"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

JSONRead-onlyHuman review

phase-coverage px phase-coverage Audit phase coverage P1-P6 (type intel / diagnostics / refactor recs) Route only
What it does

Audit phase coverage P1-P6 (type intel / diagnostics / refactor recs)

When the agent reaches for it

which phases (type intel / LSP diagnostics / refactor recs) are populated?

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Audit phase coverage P1-P6 (type intel / diagnostics / refactor recs) PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px ask --space myrepo --json "Which checkout implementation phases have evidence coverage?"

AccessAccess through px ask or the command router; it is not a top-level CLI verb.

Read-onlyHuman review

orphan-status px orphan-status Extractor orphan check (built but not wired to rebuild) Route only
What it does

Extractor orphan check (built but not wired to rebuild)

When the agent reaches for it

are any extractors unwired — code exists but rebuild doesn't invoke?

Without PX

The agent runs disconnected linters and scanners, then overstates heuristic counts as dead code, safety, or architectural fact.

Why PX changes the work

Extractor orphan check (built but not wired to rebuild) PX composes graph, source, dependency, temporal, and diagnostic evidence while labeling what is heuristic, partial, or unproven.

Run it
px ask --space myrepo --json "Which checkout symbols are graph-unreachable, and what does that prove?"

AccessAccess through px ask or the command router; it is not a top-level CLI verb.

Read-onlyHuman review

Plate 0610 capabilities
Maintainer evidence lane

Index Lifecycle And Truth

Keeps source, symbol, reference, and binary graph contracts current; detects partial coverage and refuses to publish a full replacement when extraction is incomplete.

What agents use nowA periodic full scan lags the tree, partial extraction is published as complete, and agents mistake zero indexed rows for absence.

Why PX is differentPX tracks index contracts, overlays changed files, classifies misses, validates mappings, and fails closed when replacement evidence is incomplete.

doctor px doctor Self-diagnostic — check if px is properly set up and up to date Runnable
What it does

Self-diagnostic — check if px is properly set up and up to date

When the agent reaches for it

index health diagnostic — run first when queries return nothing

Without PX

A periodic full scan lags the tree, partial extraction is published as complete, and agents mistake zero indexed rows for absence.

Why PX changes the work

Self-diagnostic — check if px is properly set up and up to date PX tracks index contracts, overlays changed files, classifies misses, validates mappings, and fails closed when replacement evidence is incomplete.

Run it
px doctor --lite --timeout-ms 2000

AccessRun px doctor.

JSONAuto-run safeRead-only

refresh px refresh Fast substrate refresh — update selected DB feeders without full LSP rebuild Runnable
What it does

Fast substrate refresh — update selected DB feeders without full LSP rebuild

When the agent reaches for it

update only the px substrates agents need without running the full slow LSP rebuild

Without PX

A periodic full scan lags the tree, partial extraction is published as complete, and agents mistake zero indexed rows for absence.

Why PX changes the work

Fast substrate refresh — update selected DB feeders without full LSP rebuild PX tracks index contracts, overlays changed files, classifies misses, validates mappings, and fails closed when replacement evidence is incomplete.

Run it
px refresh

AccessRun px refresh.

JSONMutates stateHuman review

rebuild px rebuild Adaptive rebuild — incrementally update Stage 1 when a valid prior index exists, then rebuild the Stage 2 binary index Runnable
What it does

Adaptive rebuild — incrementally update Stage 1 when a valid prior index exists, then rebuild the Stage 2 binary index

When the agent reaches for it

update symbols, embeddings, references, and the binary index after code changes; automatically use the prior indexed commit for small deltas

Without PX

A periodic full scan lags the tree, partial extraction is published as complete, and agents mistake zero indexed rows for absence.

Why PX changes the work

Adaptive rebuild — incrementally update Stage 1 when a valid prior index exists, then rebuild the Stage 2 binary index PX tracks index contracts, overlays changed files, classifies misses, validates mappings, and fails closed when replacement evidence is incomplete.

Run it
px rebuild

AccessRun px rebuild.

JSONMutates stateHuman review

snapshot px snapshot Take a file fingerprint snapshot for incremental rebuilds Runnable
What it does

Take a file fingerprint snapshot for incremental rebuilds

When the agent reaches for it

take a file fingerprint snapshot for incremental rebuilds

Without PX

A periodic full scan lags the tree, partial extraction is published as complete, and agents mistake zero indexed rows for absence.

Why PX changes the work

Take a file fingerprint snapshot for incremental rebuilds PX tracks index contracts, overlays changed files, classifies misses, validates mappings, and fails closed when replacement evidence is incomplete.

Run it
px snapshot --repo . --space myrepo --json

AccessRun px snapshot.

Auto-run safeRead-only

diff px diff Diff two snapshots to see what changed Runnable
What it does

Diff two snapshots to see what changed

When the agent reaches for it

diff two snapshots to see which files changed

Without PX

A periodic full scan lags the tree, partial extraction is published as complete, and agents mistake zero indexed rows for absence.

Why PX changes the work

Diff two snapshots to see what changed PX tracks index contracts, overlays changed files, classifies misses, validates mappings, and fails closed when replacement evidence is incomplete.

Run it
px diff --changed-since HEAD~1 --space myrepo --json

AccessRun px diff.

Auto-run safeRead-only

build px build Build artifacts from Postgres code_references table Runnable
What it does

Build artifacts from Postgres code_references table

When the agent reaches for it

Stage 2 only — build binary index from Postgres (prefer `rebuild`)

Without PX

A periodic full scan lags the tree, partial extraction is published as complete, and agents mistake zero indexed rows for absence.

Why PX changes the work

Build artifacts from Postgres code_references table PX tracks index contracts, overlays changed files, classifies misses, validates mappings, and fails closed when replacement evidence is incomplete.

Run it
px build --repo . --space myrepo

AccessRun px build.

Mutates stateHuman review

verify-index px verify-index Verify binary-index structural integrity (internal diagnostic) Runnable
What it does

Verify binary-index structural integrity (internal diagnostic)

When the agent reaches for it

verify binary index structural integrity

Without PX

A periodic full scan lags the tree, partial extraction is published as complete, and agents mistake zero indexed rows for absence.

Why PX changes the work

Verify binary-index structural integrity (internal diagnostic) PX tracks index contracts, overlays changed files, classifies misses, validates mappings, and fails closed when replacement evidence is incomplete.

Run it
px verify-index --repo . --space myrepo --json

AccessRun px verify-index.

Auto-run safeRead-only

extract px extract Extractors (ported from fox-codegraph). Run with `px extract <tool> --help` Runnable
What it does

Extractors (ported from fox-codegraph). Run with `px extract <tool> --help`

When the agent reaches for it

Stage 1 extractors (rarely invoked directly — `rebuild` runs these)

Without PX

A periodic full scan lags the tree, partial extraction is published as complete, and agents mistake zero indexed rows for absence.

Why PX changes the work

Extractors (ported from fox-codegraph). Run with `px extract <tool> --help` PX tracks index contracts, overlays changed files, classifies misses, validates mappings, and fails closed when replacement evidence is incomplete.

Run it
px extract call-refs . --space myrepo --write-db

AccessRun px extract.

Auto-run safeRead-only

index px extract index Index a repository into FoxGres code graph Runnable
What it does

Index a repository into FoxGres code graph

When the agent reaches for it

rebuild's Stage 1a — usually invoked by rebuild, not directly

Without PX

A periodic full scan lags the tree, partial extraction is published as complete, and agents mistake zero indexed rows for absence.

Why PX changes the work

Index a repository into FoxGres code graph PX tracks index contracts, overlays changed files, classifies misses, validates mappings, and fails closed when replacement evidence is incomplete.

Run it
px extract index --repo . --space myrepo

AccessRun px extract index.

Auto-run safeRead-only

references px extract references Extract references via LSP (rust-analyzer, typescript-language-server) for "who uses this symbol?" Read-only by default; persist reference rows with --write-db Runnable
What it does

Extract references via LSP (rust-analyzer, typescript-language-server) for "who uses this symbol?" Read-only by default; persist reference rows with --write-db

When the agent reaches for it

rebuild's Stage 1b — usually invoked by rebuild, not directly

Without PX

A periodic full scan lags the tree, partial extraction is published as complete, and agents mistake zero indexed rows for absence.

Why PX changes the work

Extract references via LSP (rust-analyzer, typescript-language-server) for "who uses this symbol?" Read-only by default; persist reference rows with --write-db PX tracks index contracts, overlays changed files, classifies misses, validates mappings, and fails closed when replacement evidence is incomplete.

Run it
px extract references --space myrepo .

AccessRun px extract references.

Auto-run safeRead-only

Plate 0718 capabilities
Advanced evidence lane

Languages And Runtime Boundaries

Adds structural edges that ordinary language servers miss: imports, scripts, SQL, HTTP, FFI, messages, Metal kernels, agent contracts, effects, and specialized languages.

What agents use nowEach language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX is differentPX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

rust-refs px extract rust-refs Scan Rust files for `use` statements and type annotations to create cross-file reference edges. Resolves crate/super/self paths. Read-only by default; persist rows with --write-db Runnable
What it does

Scan Rust files for `use` statements and type annotations to create cross-file reference edges. Resolves crate/super/self paths. Read-only by default; persist rows with --write-db

When the agent reaches for it

need finer ref coverage than rust-analyzer alone provides

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Scan Rust files for `use` statements and type annotations to create cross-file reference edges. Resolves crate/super/self paths. Read-only by default; persist rows with --write-db PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract rust-refs --space myrepo .

AccessRun px extract rust-refs.

Auto-run safeRead-only

metal-refs px extract metal-refs Scan Rust Metal host calls (`get_function("kernel")`) and create Rust-to-.metal kernel reference edges. Read-only by default; persist rows with --write-db Runnable
What it does

Scan Rust Metal host calls (`get_function("kernel")`) and create Rust-to-.metal kernel reference edges. Read-only by default; persist rows with --write-db

When the agent reaches for it

connect Rust `get_function("kernel")` calls to .metal kernel symbols

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Scan Rust Metal host calls (`get_function("kernel")`) and create Rust-to-.metal kernel reference edges. Read-only by default; persist rows with --write-db PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract metal-refs --space myrepo .

AccessRun px extract metal-refs.

Auto-run safeRead-only

agent-contracts px extract agent-contracts Scan tests, fixtures, schemas, goldens, migrations, snapshots, hooks, and runtime config files into agent contract reference edges. Read-only by default; persist rows with --write-db Runnable
What it does

Scan tests, fixtures, schemas, goldens, migrations, snapshots, hooks, and runtime config files into agent contract reference edges. Read-only by default; persist rows with --write-db

When the agent reaches for it

link tests/goldens/schemas/runtime fixtures to the commands and symbols they protect

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Scan tests, fixtures, schemas, goldens, migrations, snapshots, hooks, and runtime config files into agent contract reference edges. Read-only by default; persist rows with --write-db PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract agent-contracts --space myrepo .

AccessRun px extract agent-contracts.

Auto-run safeRead-only

call-refs px extract call-refs Scan source files for function/method call patterns, including Rust same-file edges. Heuristic: matches known symbol names followed by `(` in source code. Read-only by default; persist rows with --write-db using source='call_scan' Runnable
What it does

Scan source files for function/method call patterns, including Rust same-file edges. Heuristic: matches known symbol names followed by `(` in source code. Read-only by default; persist rows with --write-db using source='call_scan'

When the agent reaches for it

breadth-first call graph for polyglot repos

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Scan source files for function/method call patterns, including Rust same-file edges. Heuristic: matches known symbol names followed by `(` in source code. Read-only by default; persist rows with --write-db using source='call_scan' PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract call-refs --space myrepo .

AccessRun px extract call-refs.

Auto-run safeRead-only

esm-refs px extract esm-refs Scan JS/TS files for ESM/CJS import statements and create cross-file reference edges. Resolves relative imports (./ ../). Read-only by default; persist rows with --write-db Runnable
What it does

Scan JS/TS files for ESM/CJS import statements and create cross-file reference edges. Resolves relative imports (./ ../). Read-only by default; persist rows with --write-db

When the agent reaches for it

need TS/JS import edges in the ref graph

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Scan JS/TS files for ESM/CJS import statements and create cross-file reference edges. Resolves relative imports (./ ../). Read-only by default; persist rows with --write-db PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract esm-refs --space myrepo .

AccessRun px extract esm-refs.

Auto-run safeRead-only

js-truth px extract js-truth Scan JS/TS files for runtime and type-only import truths with resolver-backed module resolution. Read-only by default; persist rows with --write-db or record evidence with --emit-evidence Runnable
What it does

Scan JS/TS files for runtime and type-only import truths with resolver-backed module resolution. Read-only by default; persist rows with --write-db or record evidence with --emit-evidence

When the agent reaches for it

need resolver-backed JS/TS import edges with runtime-vs-type evidence

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Scan JS/TS files for runtime and type-only import truths with resolver-backed module resolution. Read-only by default; persist rows with --write-db or record evidence with --emit-evidence PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract js-truth --space myrepo .

AccessRun px extract js-truth.

JSONAuto-run safeRead-only

pascal-refs px extract pascal-refs Scan Pascal/Delphi files for `uses` clause imports and call-site references. Discovers cross-file dependencies from unit references and heuristic call matching. Read-only by default; persist rows with --write-db using source='pascal_scan' Runnable
What it does

Scan Pascal/Delphi files for `uses` clause imports and call-site references. Discovers cross-file dependencies from unit references and heuristic call matching. Read-only by default; persist rows with --write-db using source='pascal_scan'

When the agent reaches for it

SAP-ATL or legacy Pascal codebases

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Scan Pascal/Delphi files for `uses` clause imports and call-site references. Discovers cross-file dependencies from unit references and heuristic call matching. Read-only by default; persist rows with --write-db using source='pascal_scan' PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract pascal-refs --space myrepo .

AccessRun px extract pascal-refs.

Auto-run safeRead-only

java-refs px extract java-refs Scan Java files for import statements and create cross-file reference edges. Resolves package imports to actual files. Read-only by default; persist rows with --write-db Runnable
What it does

Scan Java files for import statements and create cross-file reference edges. Resolves package imports to actual files. Read-only by default; persist rows with --write-db

When the agent reaches for it

Java codebases

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Scan Java files for import statements and create cross-file reference edges. Resolves package imports to actual files. Read-only by default; persist rows with --write-db PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract java-refs --space myrepo .

AccessRun px extract java-refs.

Auto-run safeRead-only

atl-refs px extract atl-refs Scan SAP BODS ATL files for cross-symbol references via the tree-sitter-atl grammar. Emits `qualified_name` usages (table.column, schema.table, Query.COL) and BODS built-in calls (lookup_ext, sql, decode, …). Read-only by default; persist rows with --write-db using source='atl_scan' Runnable
What it does

Scan SAP BODS ATL files for cross-symbol references via the tree-sitter-atl grammar. Emits `qualified_name` usages (table.column, schema.table, Query.COL) and BODS built-in calls (lookup_ext, sql, decode, …). Read-only by default; persist rows with --write-db using source='atl_scan'

When the agent reaches for it

proven-etl / SAP BODS conversion work

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Scan SAP BODS ATL files for cross-symbol references via the tree-sitter-atl grammar. Emits `qualified_name` usages (table.column, schema.table, Query.COL) and BODS built-in calls (lookup_ext, sql, decode, …). Read-only by default; persist rows with --write-db using source='atl_scan' PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract atl-refs --space myrepo .

AccessRun px extract atl-refs.

Auto-run safeRead-only

sql-refs px extract sql-refs Scan SQL DDL files and find heuristic references from source code to SQL objects. Read-only by default; persist reference rows with --write-db. Discovers CREATE TABLE/VIEW/FUNCTION definitions and matches them against string references in .rs/.ts/.tsx/.js/.jsx files Runnable
What it does

Scan SQL DDL files and find heuristic references from source code to SQL objects. Read-only by default; persist reference rows with --write-db. Discovers CREATE TABLE/VIEW/FUNCTION definitions and matches them against string references in .rs/.ts/.tsx/.js/.jsx files

When the agent reaches for it

SQL-heavy repos with stored procs

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Scan SQL DDL files and find heuristic references from source code to SQL objects. Read-only by default; persist reference rows with --write-db. Discovers CREATE TABLE/VIEW/FUNCTION definitions and matches them against string references in .rs/.ts/.tsx/.js/.jsx files PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract sql-refs --space myrepo .

AccessRun px extract sql-refs.

Auto-run safeRead-only

pg-functions px extract pg-functions Extract SQL function definitions and cross-references from PostgreSQL pg_proc. Introspects plpgsql/sql routines in selected schemas (default `public`), dumps definitions to disk, and discovers function-to-function and function-to-table references Runnable
What it does

Extract SQL function definitions and cross-references from PostgreSQL pg_proc. Introspects plpgsql/sql routines in selected schemas (default `public`), dumps definitions to disk, and discovers function-to-function and function-to-table references

When the agent reaches for it

pg-connected repos — introspects deployed functions

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Extract SQL function definitions and cross-references from PostgreSQL pg_proc. Introspects plpgsql/sql routines in selected schemas (default `public`), dumps definitions to disk, and discovers function-to-function and function-to-table references PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract pg-functions .

AccessRun px extract pg-functions.

Auto-run safeRead-only

type-extract px extract type-extract Extract type-aware signatures from every function/method in the repo Runnable
What it does

Extract type-aware signatures from every function/method in the repo

When the agent reaches for it

feeds `px audit` Phase 3 signals (type complexity scoring)

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Extract type-aware signatures from every function/method in the repo PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract type-extract --space myrepo .

AccessRun px extract type-extract.

Auto-run safeRead-only

extract-effects px extract effects Extract static Rust/JS/TS/Python side-effect facts. Read-only by default; persist to code_effects with --write-db or record evidence with --emit-evidence Runnable
What it does

Extract static Rust/JS/TS/Python side-effect facts. Read-only by default; persist to code_effects with --write-db or record evidence with --emit-evidence

When the agent reaches for it

preview side-effect facts for `px effects` and `px impact --with-effects`; use it for bounded literal/model evidence, but keep runtime dynamic access as a known gap unless typed evidence exists

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Extract static Rust/JS/TS/Python side-effect facts. Read-only by default; persist to code_effects with --write-db or record evidence with --emit-evidence PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract effects --space myrepo .

AccessRun px extract effects.

JSONAuto-run safeRead-only

script-refs px extract script-refs Scan every indexed file for shell-script-path references (e.g. `scripts/foo.sh`, `.claude/hooks/bar.sh`) and emit path-to-path edges. Read-only by default; persist rows with --write-db using source='script_scan' Runnable
What it does

Scan every indexed file for shell-script-path references (e.g. `scripts/foo.sh`, `.claude/hooks/bar.sh`) and emit path-to-path edges. Read-only by default; persist rows with --write-db using source='script_scan'

When the agent reaches for it

preview or refresh shell-script edges for `px callers` and `px impact`; pass `--write-db` only when intentionally updating code_references

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Scan every indexed file for shell-script-path references (e.g. `scripts/foo.sh`, `.claude/hooks/bar.sh`) and emit path-to-path edges. Read-only by default; persist rows with --write-db using source='script_scan' PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract script-refs --space myrepo .

AccessRun px extract script-refs.

Auto-run safeRead-only

cross-lang-http px extract cross-lang-http Scan Rust axum routers + TS fetch/axios callsites and pair them on canonical URL patterns to produce cross-language HTTP-boundary edges. Writes to code_references with source='cross_lang_http_scan', target_kind='cross_lang_http', ref_type='http_call'. Lights up `px callers <axum_handler>` with TS UI-side callers (Phase 2.2.1) Runnable
What it does

Scan Rust axum routers + TS fetch/axios callsites and pair them on canonical URL patterns to produce cross-language HTTP-boundary edges. Writes to code_references with source='cross_lang_http_scan', target_kind='cross_lang_http', ref_type='http_call'. Lights up `px callers <axum_handler>` with TS UI-side callers (Phase 2.2.1)

When the agent reaches for it

find TS UI consumers of a Rust axum handler (or Rust↔Rust HTTP edges); inspect impact/callers with --cross-lang after the boundary rows exist

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Scan Rust axum routers + TS fetch/axios callsites and pair them on canonical URL patterns to produce cross-language HTTP-boundary edges. Writes to code_references with source='cross_lang_http_scan', target_kind='cross_lang_http', ref_type='http_call'. Lights up `px callers <axum_handler>` with TS UI-side callers (Phase 2.2.1) PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract cross-lang-http --space myrepo .

AccessRun px extract cross-lang-http.

Mutates stateHuman review

cross-lang-sql px extract cross-lang-sql Scan Rust `sqlx::query!`/`query_as!` macros + TS `pool.query` / Drizzle `sql\`...\`` template literals and pair them with plpgsql/sql functions in `pg_proc` to produce cross-language SQL-boundary edges. Writes to code_references with source='cross_lang_sql_scan', target_kind='cross_lang_sql', ref_type='sql_call'. Lights up `px callers <plpgsql_fn>` with Rust + TS app-side callers (Phase 2.2.3) Runnable
What it does

Scan Rust `sqlx::query!`/`query_as!` macros + TS `pool.query` / Drizzle `sql\`...\`` template literals and pair them with plpgsql/sql functions in `pg_proc` to produce cross-language SQL-boundary edges. Writes to code_references with source='cross_lang_sql_scan', target_kind='cross_lang_sql', ref_type='sql_call'. Lights up `px callers <plpgsql_fn>` with Rust + TS app-side callers (Phase 2.2.3)

When the agent reaches for it

find Rust + TS application callers of a plpgsql/sql function; inspect impact/callers with --cross-lang after the boundary rows exist

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Scan Rust `sqlx::query!`/`query_as!` macros + TS `pool.query` / Drizzle `sql\`...\`` template literals and pair them with plpgsql/sql functions in `pg_proc` to produce cross-language SQL-boundary edges. Writes to code_references with source='cross_lang_sql_scan', target_kind='cross_lang_sql', ref_type='sql_call'. Lights up `px callers <plpgsql_fn>` with Rust + TS app-side callers (Phase 2.2.3) PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract cross-lang-sql --space myrepo .

AccessRun px extract cross-lang-sql.

Mutates stateHuman review

cross-lang-ffi px extract cross-lang-ffi Scan Rust `#[napi]`-decorated functions + TS `loadNativeModule()` consumers and pair them on the canonical NAPI export name (snake_case ↔ camelCase normalized). Writes to code_references with source='cross_lang_ffi_scan', target_kind='cross_lang_ffi', ref_type='napi_call'. Lights up `px callers <#[napi]_function>` with TS UI-side callers (Phase 2.2.2) Runnable
What it does

Scan Rust `#[napi]`-decorated functions + TS `loadNativeModule()` consumers and pair them on the canonical NAPI export name (snake_case ↔ camelCase normalized). Writes to code_references with source='cross_lang_ffi_scan', target_kind='cross_lang_ffi', ref_type='napi_call'. Lights up `px callers <#[napi]_function>` with TS UI-side callers (Phase 2.2.2)

When the agent reaches for it

find TS bridge consumers of a Rust NAPI export (snake↔camel normalized)

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Scan Rust `#[napi]`-decorated functions + TS `loadNativeModule()` consumers and pair them on the canonical NAPI export name (snake_case ↔ camelCase normalized). Writes to code_references with source='cross_lang_ffi_scan', target_kind='cross_lang_ffi', ref_type='napi_call'. Lights up `px callers <#[napi]_function>` with TS UI-side callers (Phase 2.2.2) PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract cross-lang-ffi --space myrepo .

AccessRun px extract cross-lang-ffi.

Mutates stateHuman review

cross-lang-message px extract cross-lang-message Scan `pg_notify('<channel>', ...)` producers (plpgsql / SQL / Rust / TS) + `LISTEN <channel>` / `pool.listen("<channel>")` consumers and pair them by literal channel name. Writes to code_references with source='cross_lang_message_scan', target_kind='cross_lang_message', ref_type='message_publish' or 'message_subscribe'. Closes the Phase 2.2 cross-language series — best-effort coverage; dynamic channel names (variables, format strings) are out-of-scope for V0 (Phase 2.2.4) Runnable
What it does

Scan `pg_notify('<channel>', ...)` producers (plpgsql / SQL / Rust / TS) + `LISTEN <channel>` / `pool.listen("<channel>")` consumers and pair them by literal channel name. Writes to code_references with source='cross_lang_message_scan', target_kind='cross_lang_message', ref_type='message_publish' or 'message_subscribe'. Closes the Phase 2.2 cross-language series — best-effort coverage; dynamic channel names (variables, format strings) are out-of-scope for V0 (Phase 2.2.4)

When the agent reaches for it

find publishers/subscribers of a pg_notify channel across languages (best-effort: dynamic channel names skipped)

Without PX

Each language or boundary gets a bespoke grep, and cross-language calls disappear between API strings, SQL, scripts, generated code, and FFI.

Why PX changes the work

Scan `pg_notify('<channel>', ...)` producers (plpgsql / SQL / Rust / TS) + `LISTEN <channel>` / `pool.listen("<channel>")` consumers and pair them by literal channel name. Writes to code_references with source='cross_lang_message_scan', target_kind='cross_lang_message', ref_type='message_publish' or 'message_subscribe'. Closes the Phase 2.2 cross-language series — best-effort coverage; dynamic channel names (variables, format strings) are out-of-scope for V0 (Phase 2.2.4) PX normalizes many extractors into one graph and records exactly which extractor produced each kind of structural evidence.

Run it
px extract cross-lang-message --space myrepo .

AccessRun px extract cross-lang-message.

Mutates stateHuman review

Plate 086 capabilities
Enterprise evidence lane

Multi-Repo, Fleet, Database

Lets agents compare repositories, query across spaces, select the correct database truth source, and see host/index/version readiness before trusting fleet-wide conclusions.

What agents use nowThe agent opens repositories one by one, guesses which local or remote database is authoritative, and manually reconciles versions.

Why PX is differentPX gives the fleet a common space model, cross-repo query lane, host/version inventory, and readiness receipts.

xref px xref Cross-repo query — search across all spaces via Postgres code_references Runnable
What it does

Cross-repo query — search across all spaces via Postgres code_references

When the agent reaches for it

cross-repo query across ALL indexed spaces

Without PX

The agent opens repositories one by one, guesses which local or remote database is authoritative, and manually reconciles versions.

Why PX changes the work

Cross-repo query — search across all spaces via Postgres code_references PX gives the fleet a common space model, cross-repo query lane, host/version inventory, and readiness receipts.

Run it
px xref search "checkout receipt" --limit 10

AccessRun px xref.

Auto-run safeRead-only

fleet px fleet Cross-machine PX host and repo readiness packets Runnable
What it does

Cross-machine PX host and repo readiness packets

When the agent reaches for it

decide whether this Mac/Linux/WSL/Windows host can run PX, and whether a target repo/head/index is ready for fleet sharing

Without PX

The agent opens repositories one by one, guesses which local or remote database is authoritative, and manually reconciles versions.

Why PX changes the work

Cross-machine PX host and repo readiness packets PX gives the fleet a common space model, cross-repo query lane, host/version inventory, and readiness receipts.

Run it
px fleet sync --repo . --space myrepo --json

AccessRun px fleet.

Auto-run safeRead-only

db-profiles px db-profiles List app database truth-source profiles for SQL substrate extraction Runnable
What it does

List app database truth-source profiles for SQL substrate extraction

When the agent reaches for it

before running pg-functions or cross-lang-sql against an app database; choose the correct Railway/local/Docker truth source and copy the labeled extraction command

Without PX

The agent opens repositories one by one, guesses which local or remote database is authoritative, and manually reconciles versions.

Why PX changes the work

List app database truth-source profiles for SQL substrate extraction PX gives the fleet a common space model, cross-repo query lane, host/version inventory, and readiness receipts.

Run it
px db-profiles --repo . --json

AccessRun px db-profiles.

JSONAuto-run safeRead-only

foxgres-fleet px foxgres-fleet Read FoxGres fleet/version index and upgrade planning guidance Runnable
What it does

Read FoxGres fleet/version index and upgrade planning guidance

When the agent reaches for it

before changing FoxGres Docker/Railway/Linux/WSL deployments; inspect target extension version, image drift, upgrade path, and non-secret target registry

Without PX

The agent opens repositories one by one, guesses which local or remote database is authoritative, and manually reconciles versions.

Why PX changes the work

Read FoxGres fleet/version index and upgrade planning guidance PX gives the fleet a common space model, cross-repo query lane, host/version inventory, and readiness receipts.

Run it
px foxgres-fleet --json

AccessRun px foxgres-fleet.

JSONAuto-run safeRead-only

benchmark px benchmark Benchmark suites for px quality signals (Wave 2v-2x, 2026-04-20) Runnable
What it does

Benchmark suites for px quality signals (Wave 2v-2x, 2026-04-20)

When the agent reaches for it

run acceptance and quality benchmarks such as FDAG recall/MRR fixtures

Without PX

The agent opens repositories one by one, guesses which local or remote database is authoritative, and manually reconciles versions.

Why PX changes the work

Benchmark suites for px quality signals (Wave 2v-2x, 2026-04-20) PX gives the fleet a common space model, cross-repo query lane, host/version inventory, and readiness receipts.

Run it
px benchmark agent-lift CheckoutService --space myrepo --json

AccessRun px benchmark.

Auto-run safeRead-only

calibrate px calibrate Self-calibrate routing recipes from the index's own graph ground truth Runnable
What it does

Self-calibrate routing recipes from the index's own graph ground truth

When the agent reaches for it

after indexing a new space or when ask/who-uses lanes return suspicious zeros for a language: probe class-vs-unit granularity and table-symbol-vs-literal lanes, then --write the recipes the router consumes

Without PX

The agent opens repositories one by one, guesses which local or remote database is authoritative, and manually reconciles versions.

Why PX changes the work

Self-calibrate routing recipes from the index's own graph ground truth PX gives the fleet a common space model, cross-repo query lane, host/version inventory, and readiness receipts.

Run it
px calibrate --space myrepo --json

AccessRun px calibrate.

JSONAuto-run safeRead-only

Plate 093 capabilities
Advanced evidence lane

Agent Learning And Adoption

Captures whether PX actually helped, records repair outcomes, measures agent adoption, and turns repeated misses into maintainable tool improvements.

What agents use nowTool failures vanish into chat transcripts, agents quietly return to grep, and maintainers cannot measure whether fixes changed behavior.

Why PX is differentPX records outcomes, transitions, misses, adoption, and improvement receipts so agent behavior becomes an observable product metric.

agent px agent Generate or read repo-specific PX agent briefings Runnable
What it does

Generate or read repo-specific PX agent briefings

When the agent reaches for it

initialize or read a repo-specific command profile and agent cheatsheet for fresh sessions

Without PX

Tool failures vanish into chat transcripts, agents quietly return to grep, and maintainers cannot measure whether fixes changed behavior.

Why PX changes the work

Generate or read repo-specific PX agent briefings PX records outcomes, transitions, misses, adoption, and improvement receipts so agent behavior becomes an observable product metric.

Run it
px agent brief --repo . --space myrepo --json

AccessRun px agent.

JSONAuto-run safeRead-only

feedback px feedback Collect and inspect agent feedback about PX command usefulness Runnable
What it does

Collect and inspect agent feedback about PX command usefulness

When the agent reaches for it

record what helped or confused an agent, inspect recent repo-specific feedback, and export feedback packets

Without PX

Tool failures vanish into chat transcripts, agents quietly return to grep, and maintainers cannot measure whether fixes changed behavior.

Why PX changes the work

Collect and inspect agent feedback about PX command usefulness PX records outcomes, transitions, misses, adoption, and improvement receipts so agent behavior becomes an observable product metric.

Run it
px feedback ask --space myrepo --json

AccessRun px feedback.

Auto-run safeRead-only

tools px tools Record and inspect PX tool improvement memory in FDAG V3 Runnable
What it does

Record and inspect PX tool improvement memory in FDAG V3

When the agent reaches for it

snapshot PX command/skill state into FDAG V3, record tool outcomes or improvement events, and check maintainer skill/docs sync

Without PX

Tool failures vanish into chat transcripts, agents quietly return to grep, and maintainers cannot measure whether fixes changed behavior.

Why PX changes the work

Record and inspect PX tool improvement memory in FDAG V3 PX records outcomes, transitions, misses, adoption, and improvement receipts so agent behavior becomes an observable product metric.

Run it
px tools init --repo . --space myrepo --mode consumer --brief --json

AccessRun px tools.

Auto-run safeRead-only

Plate 103 capabilities
Platform evidence lane

Automation And API

Makes the same evidence lanes callable from shells, remote agents, and services without rebuilding PX behavior in every client.

What agents use nowEvery agent host wraps the CLI differently, parses prose, and reimplements routing, batching, authentication, and output contracts.

Why PX is differentPX exposes stable machine-readable surfaces, completion metadata, batch execution, and a service boundary around the same evidence engine.

serve px serve Start HTTP server — expose FoxRef as a JSON API for remote queries Runnable
What it does

Start HTTP server — expose FoxRef as a JSON API for remote queries

When the agent reaches for it

start HTTP JSON API server for remote px queries — external surface for agents/tools

Without PX

Every agent host wraps the CLI differently, parses prose, and reimplements routing, batching, authentication, and output contracts.

Why PX changes the work

Start HTTP server — expose FoxRef as a JSON API for remote queries PX exposes stable machine-readable surfaces, completion metadata, batch execution, and a service boundary around the same evidence engine.

Run it
px serve --repo . --space myrepo

AccessRun px serve.

Auto-run safeRead-only

completions px completions Emit shell completion script for the given shell (bash, zsh, fish, elvish, powershell) Runnable
What it does

Emit shell completion script for the given shell (bash, zsh, fish, elvish, powershell)

When the agent reaches for it

emit shell completion script (bash, zsh, fish, elvish, powershell)

Without PX

Every agent host wraps the CLI differently, parses prose, and reimplements routing, batching, authentication, and output contracts.

Why PX changes the work

Emit shell completion script for the given shell (bash, zsh, fish, elvish, powershell) PX exposes stable machine-readable surfaces, completion metadata, batch execution, and a service boundary around the same evidence engine.

Run it
px completions zsh

AccessRun px completions.

Auto-run safeRead-only

batch px batch Multi-call batching — execute N px verbs in one call, eliminates per-call subprocess overhead Catalog only
What it does

Multi-call batching — execute N px verbs in one call, eliminates per-call subprocess overhead

When the agent reaches for it

AI knows up-front what 5-10 things it wants — pass a JSON array of {verb,args} specs, get one envelope per call back; per-call failure isolation, optional --parallel

Without PX

Every agent host wraps the CLI differently, parses prose, and reimplements routing, batching, authentication, and output contracts.

Why PX changes the work

Multi-call batching — execute N px verbs in one call, eliminates per-call subprocess overhead PX exposes stable machine-readable surfaces, completion metadata, batch execution, and a service boundary around the same evidence engine.

Run it
px ask --space myrepo --json "How should an agent use batch for CheckoutService?"

AccessAdvisory capability memory; do not invoke it as a CLI command until a registered wrapper exists.

Read-onlyHuman review

Plate 111 capabilities
Specialized evidence lane

Additional Registered Surfaces

Capabilities present in the live command registry that have not yet been promoted into a primary agent workflow group.

What agents use now

Why PX is different

investigate px investigate Investigate a broad architecture, subsystem, or flow question with composed FoxRef steps Runnable
What it does

Investigate a broad architecture, subsystem, or flow question with composed FoxRef steps

When the agent reaches for it

broad architecture/flow questions or exact current-tree file inspection (add --with-docs for documented truth/drift)

Without PX

The agent stitches together shell searches, source reads, and memory without one evidence contract.

Why PX changes the work

Investigate a broad architecture, subsystem, or flow question with composed FoxRef steps The result stays machine-readable and connected to the next evidence step.

Run it
px investigate --space myrepo --with-docs --json "Trace checkout through receipt persistence"

AccessRun px investigate.

JSONAuto-run safeRead-only

PROBAGI / SOURCE PROOF

The page keeps its evidence attached.

source-proven

PX capability inventory

The 116-capability atlas is generated from the PX command registry at source commit 76f7c344cf2f685540c119c6a181424996647f83.

sha256:a744e05beab2be706dd353942b507b7f7c4e0b43d073ea81572b8588cb484c04
source-proven

Registered command relationships

The generator validated 229 registered related-command transitions with zero invalid or missing Clap entries.

px-related-validation:229-of-229
packaged

Industry comparison

Competitor capabilities are framed from their official documentation and separated from PX interpretation.

official-docs:cursor-jetbrains-copilot-sourcegraph-codeql-semgrep
unknown

Independent productivity superiority

No independent controlled benchmark yet proves universal accuracy, speed, token, or cost superiority.

px:independent-head-to-head-benchmark
held

Public reachability

This state advances only after Ghost publication and public rendering readback.

probagi:px-agent-feature-atlas:live-readback