git:20260515.327083b to git:20260521.71af4f2

11 added, 0 removed. Audit A to A.

---

name: metagit-gitnexus

description: Run gitnexus analysis for a target workspace and selected project repositories before graph-dependent tasks. Use when index staleness is detected or cross-repo graph results are needed.

---

# Running GitNexus Analysis

Use this skill whenever GitNexus context is stale or missing for target repositories.

## Local Wrapper (Use First)

- `zsh ./skills/metagit-gitnexus/scripts/analyze-targets.zsh <workspace_root> [project_name]`

## Workflow

1. Analyze the current repository where the command is run.

2. Resolve target project repositories from `.metagit.yml`.

3. Run `npx gitnexus analyze` in each local repository path found.

4. Report per-repository success/failure and next actions.

+ ## Manual workspace graph (`.metagit.yml` → Cypher)

+ Export manifest `graph.relationships` for GitNexus overlay ingest:

+ ```bash

+ metagit config graph export -c .metagit.yml --format tool-calls

+ # or MCP: metagit_export_workspace_graph_cypher

+ ```

+ Run returned `gitnexus_cypher` tool calls against the umbrella repo index (`--gitnexus-repo` when names differ). Schema DDL (`MetagitEntity` / `MetagitLink`) runs once per index.

## Output Contract

Return:

- analyzed repositories

- failures and reasons

- whether graph queries are safe to run now

## Safety

- Skip repositories that do not exist locally.

- Do not mutate repo content; analysis should be read-only indexing.