arcanon
Cross-repo service dependency scanner for Claude Code — maps your architecture, detects drift, and syncs to Arcanon Hub
Component Overview
Install
npx claudepluginhub arcanon-hub/arcanon --plugin arcanonSetup Configuration
This plugin requires configuration values that are prompted when the plugin is enabled. Sensitive values are stored in your system keychain.
hub_urlBase URL of the Arcanon Hub API. Defaults to https://api.arcanon.dev
${user_config.hub_url}api_tokenBearer token starting with arc_. Get one at https://app.arcanon.dev/settings/api-keys
${user_config.api_token}auto_uploadUpload scan findings to Arcanon Hub automatically after every /arcanon:map. Requires api_token.
${user_config.auto_upload}project_slugProject slug on Arcanon Hub (only required when using an org-scoped API key).
${user_config.project_slug}Component Details
Commands (9)
Check cross-repo impact of current changes using the service dependency map (when available) or grep-based symbol scanning (fallback). Use when the user invokes /arcanon:cross-impact, asks about breaking changes, or wants to know what services are affected before merging.
Detect drift — service-graph changes across scans + version/type/OpenAPI drift across linked repos.
Export the local service graph as Mermaid, DOT, or a self-contained HTML viewer.
Query cross-repo consumers and downstream impact for a service, endpoint, or schema.
Store your Arcanon Hub API key so scans can sync to the cloud.
Build or refresh the service dependency map by scanning linked repos with Claude agents. Use when the user runs /arcanon:map to build the impact map for the first time or re-scan after changes.
One-line health check — worker, hub credentials, upload queue, config.
Drain the offline upload queue — retry scans that couldn't sync earlier.
Upload the latest local scan for the current repo to Arcanon Hub.
Hooks (1)
MCP Servers (1)
README
Arcanon
Cross-repo service dependency scanner for Claude Code. Map your architecture, detect drift, and sync to Arcanon Hub — all from inside your editor.
Arcanon is a Claude Code plugin that discovers services, endpoints, connections, and schemas across all your repositories, then helps you reason about cross-repo impact before you merge. The plugin works fully offline; when connected to Arcanon Hub, findings sync to a cloud service graph that powers org-wide drift detection and impact analysis.
Why Arcanon?
Most dependency tools stop at package.json and Cargo.toml. Arcanon traces the runtime graph — the HTTP calls, gRPC streams, message-bus topics, and shared schemas that actually couple your services together — across repository boundaries.
| Pillar | What it means |
|---|---|
| Discover | Agents walk each repo, emit a structured JSON findings file. |
| Reconcile | Findings are stitched into a single cross-repo graph in local SQLite. |
| Detect drift | Compare a live scan against the last uploaded snapshot from the hub. |
| Sync to hub | Upload findings to api.arcanon.dev so your team, CI, and other repos can query them. |
Quick start
# 1. Install the plugin marketplace (one-time)
claude plugin marketplace add https://github.com/Arcanon-hub/arcanon
claude plugin install arcanon@arcanon --scope user
# 2. In your repo, run your first scan
/arcanon:map
# 3. (Optional) Connect to Arcanon Hub
/arcanon:login # paste your arc_... API key
/arcanon:upload # push the latest scan
/arcanon:status # check sync state + queue
Full walkthroughs live in docs/getting-started.md.
Commands
| Command | What it does |
|---|---|
/arcanon:map | Scan repos, build or refresh the local service graph. |
/arcanon:drift | Diff the live scan against the last uploaded hub snapshot. |
/arcanon:impact | Query cross-repo consumers of a service/endpoint. |
/arcanon:cross-impact | Legacy alias for repo-local transitive impact. |
/arcanon:login | Store your Arcanon Hub API key. |
/arcanon:upload | Upload the latest scan to the hub. |
/arcanon:sync | Drain the offline upload queue. |
/arcanon:status | One-line health: worker + hub + queue. |
/arcanon:export | Emit Mermaid / DOT / self-contained HTML graph from the latest scan. |
See docs/commands.md for the full reference.
Configuration
Arcanon reads arcanon.config.json from the repo root. Legacy ligamen.config.json is still honored — rename it when convenient.
{
"project-name": "my-project",
"linked-repos": ["../sibling-service", "../shared-lib"],
"hub": {
"auto-upload": true,
"url": "https://api.arcanon.dev"
}
}
Hub credentials can live in the plugin's userConfig (preferred, stored in the system keychain), the ARCANON_API_KEY environment variable, or ~/.arcanon/config.json. See docs/hub-integration.md.
How it works
repo(s) ──▶ Claude agent ──▶ findings.json ──▶ local SQLite (~/.arcanon/)
│
┌──── query/MCP tools ────┤
▼ ▼
/arcanon:impact /arcanon:drift
│
Arcanon Hub (api.arcanon.dev)
│
cross-repo, cross-org graph
The plugin is offline-first: no network required to scan, query, or map. Hub sync is opt-in and retries through a local SQLite-backed queue when the network blips.
Related repos
| Repo | Role |
|---|---|
| arcanon-hub | FastAPI + Postgres service graph backend. |
| arcanon-scanner | Standalone Rust CLI for CI/non-Claude flows. |
| arcanon-plugin | CVE-lookup plugin for Claude Code (separate product). |
| arcanon-skills | Markdown skill packs for the Rust CLI. |
License
AGPL-3.0-only. See LICENSE.
Arcanon was formerly known as Ligamen — see the migration guide if you're upgrading from v5.x.
Similar Plugins
nanobanana
Standalone image generation plugin using Nano Banana MCP server. Generates and edits images, icons, diagrams, patterns, and visual assets via Gemini image models. No Gemini CLI dependency required.
Admin access level
Server config contains admin-level keywords
Modifies files
Hook triggers on file write and edit operations
Runs pre-commands
Contains inline bash commands via ! syntax