omni-link

omni-link

Local-first multi-repo engineering control plane for Claude Code -- semantic cross-repo analysis, PR/MR intelligence, bounded automation, policy enforcement, and ecosystem-level evolution.

What it does

omni-link scans up to 10 repositories, builds a branch-aware ecosystem graph of APIs, types, dependencies, ownership, runtime signals, and policy state, then uses that graph to drive scans, impact analysis, health scoring, PR/MR review artifacts, provider publishing, and bounded execution planning.

This is not just a repo scanner. In max-tier mode, omni-link behaves like a local-first ecosystem control plane:

• It keeps warm state in a SQLite-backed daemon instead of rescanning everything on every command.
• It combines parser coverage with compiler-backed semantic analysis for TypeScript, Go, Python, Java, and Swift, plus AST-backed GraphQL analysis.
• It generates branch-aware review artifacts with risk, owners, policy decisions, and rollback-aware execution plans.
• It publishes or replays provider-native review output for GitHub and GitLab with live metadata negotiation and idempotent comment updates.
• It keeps automation bounded: branch and PR oriented, policy gated, and auditable.

Why it is different

• Cross-repo truth, not single-repo guesses -- omni-link reasons over the ecosystem graph, not just one working directory.
• Semantic where it matters -- compiler-backed analysis is used where available, with structured fallback where necessary.
• Operationally safe -- direct protected-branch mutation is blocked, execution is policy-gated, and rollback plans are always generated.
• Provider-aware -- GitHub and GitLab publishing is capability-aware, metadata-aware, and proven against live sandbox PR/MR targets.
• Proven, not hypothetical -- the repo ships with contract fixtures, smoke tests, stress tests, packaged-install tests, and live-provider gates.

Features

• Hybrid truth layer -- Tree-sitter fallback plus compiler-backed TypeScript, Go, Python, Java, and Swift analyzers, plus GraphQL AST analysis with provenance and confidence.
• Branch-aware daemon state -- SQLite-backed warm graph snapshots keyed by config and branch/worktree signature.
• Cross-repo API and type graphing -- Routes, procedures, contracts, imports, symbol references, type lineage, dependency edges, and impact paths.
• Runtime-aware ranking -- Coverage, test, OpenAPI, GraphQL, telemetry, and trace artifacts can influence health and prioritization.
• Ownership and policy engine -- Repo, path, API, and package-level ownership plus protected-branch and risk gating.
• Review artifact pipeline -- review-pr emits risk, owners, policy decisions, contract mismatches, and execution plans.
• Provider publishing -- publish-review supports dry-run, replay, GitHub, and GitLab transports with capability negotiation and live metadata hydration.
• Idempotent provider comments -- repeated publish runs update the existing omni-link review comment instead of spraying duplicates.
• Bounded execution -- apply and rollback stay branch-oriented, emit rollback plans, and now produce an execution ledger for auditability.
• Contract-locked CLI surface -- JSON and markdown outputs are pinned by fixture tests so public command drift is deliberate.
• Packaged artifact validation -- the built tarball is installed into a temp project and exercised from node_modules.
• Polyglot stress coverage -- the comprehensive stress harness exercises TypeScript, Go, Python, GraphQL, Java, and Swift together.

Verification

The current repository state is validated by npm run verify:stress, which includes lint, typecheck, unit/integration tests, coverage, build, CLI smoke, max-tier smoke, contract fixtures, package-install smoke, full stress, and live-provider gates when credentials are configured.

Current proof points from the verified state:

• 488 core tests passing, plus live GitHub and GitLab provider tests executed in sandbox PR/MR flows
• 90.6% statement coverage
• 0 moderate-or-higher audit vulnerabilities
• Live GitHub and GitLab metadata fetch plus publish validated through sandbox review targets
• Cleanup verified: sandbox PRs/MRs are closed and temporary branches are deleted
• Polyglot stress harness validated across 8 repos and 6 languages in one engine run

Installation

From the marketplace

claude plugin install omni-link

Manual installation

git clone https://github.com/Sebdysart/omni-link.git
cd omni-link
npm install
npm run build

Configuration