arcgram plugin
Make AI agent reasoning visible and auditable as an interactive graph. Arcgram turns walls of prose into typed nodes and explicit edges you inspect and correct node by node. Use it as a visual agent harness: propose → draw → self-audit → fix, human in the loop. Outputs one standalone HTML file: no build step, no npm, no CDN, no runtime. Ships authoring plus Checkpoint (diagram structure), Reconcile (diagram vs code), and Validate self-checks. Framework-agnostic and agent-neutral.
How to install the arcgram plugin
Run both commands inside Claude Code. The first adds the marketplace once; the second installs the plugin.
/plugin marketplace add jovesun-lab/arcgram
/plugin install arcgram@arcgramWhat's inside arcgram
3 parts read from the plugin's own files.
Skills 3
Claude loads it when the task matches- checkpoint
Validate an Arcgram diagram as a logic spec: is the flow well-formed and coherent? Reads node/edge structure (id/f/t/kind/role/type), never geometry. Typed findings - dangling edge, orphan node, missing branch, disconnected island, duplicate id, missing schema, plus optional coherence (every action traces to a goal). Marks, never blocks. Run after authoring or editing a diagram. Agent-neutral. Sibling to Reconcile (Checkpoint = structure; Reconcile = values).
- reconcile
Check that an Arcgram diagram's @spec values still match the code that implements it. Reads each node's desc "@spec key=value" line, finds the same-named code constant (hold_ms matches HOLD_MS or holdMs), diffs the literals. Typed findings: drift, missing constant, non-literal, ambiguous. Reads only the @spec line + named constants, never geometry; marks, never blocks. Run after editing a diagram or its code. Agent-neutral. Sibling to Checkpoint (Checkpoint = structure; Reconcile = values).
- validate
Run both Arcgram self-checks in one call. A thin wrapper over Checkpoint (structure) and Reconcile (values): validate(diagram,{code}) runs Checkpoint always and Reconcile when code is supplied, then merges into one source-tagged result in the same {findings,summary,attestation,clean} contract. clean = checkpoint.clean && reconcile.clean. Adds no new check; marks, never blocks. Run after authoring or editing a diagram and its code. Agent-neutral. The single door over its two siblings.
Using arcgram in Claude Code
Skills need no command. Claude reads them when your request matches what they describe.
Update, turn off or remove
- Update the plugin (shell)
- claude plugin update arcgram@arcgram
- Refresh the marketplace
- /plugin marketplace update arcgram
- Turn it off for now
- /plugin disable arcgram@arcgram
- Remove it
- /plugin uninstall arcgram@arcgram
Skills in arcgram
- checkpointjovesun-lab/arcgram
Validate an Arcgram diagram as a logic spec: is the flow well-formed and coherent? Reads node/edge structure (id/f/t/kind/role/type), never geometry. Typed findings - dangling edge, orphan node, missing branch, disconnected island, duplicate id, missing schema, plus optional coherence (every action traces to a goal). Marks, never blocks. Run after authoring or editing a diagram. Agent-neutral. Sibling to Reconcile (Checkpoint = structure; Reconcile = values).
3 files13stars - reconcilejovesun-lab/arcgram
Check that an Arcgram diagram's @spec values still match the code that implements it. Reads each node's desc "@spec key=value" line, finds the same-named code constant (hold_ms matches HOLD_MS or holdMs), diffs the literals. Typed findings: drift, missing constant, non-literal, ambiguous. Reads only the @spec line + named constants, never geometry; marks, never blocks. Run after editing a diagram or its code. Agent-neutral. Sibling to Checkpoint (Checkpoint = structure; Reconcile = values).
4 files13stars - validatejovesun-lab/arcgram
Run both Arcgram self-checks in one call. A thin wrapper over Checkpoint (structure) and Reconcile (values): validate(diagram,{code}) runs Checkpoint always and Reconcile when code is supplied, then merges into one source-tagged result in the same {findings,summary,attestation,clean} contract. clean = checkpoint.clean && reconcile.clean. Adds no new check; marks, never blocks. Run after authoring or editing a diagram and its code. Agent-neutral. The single door over its two siblings.
3 files13stars
arcgram plugin questions
How do I install the arcgram plugin?
In Claude Code run /plugin marketplace add jovesun-lab/arcgram, then /plugin install arcgram@arcgram.
What does the arcgram plugin include?
arcgram bundles 3 skills.
How do I update or remove the arcgram plugin?
Update it with claude plugin update arcgram@arcgram in your shell, or from the Installed tab of /plugin. Remove it with /plugin uninstall arcgram@arcgram.
What license is the arcgram plugin under?
Apache-2.0, as stated in the plugin's manifest.