Installation

AgenTopology ships as a single CLI tool. Install it with npm, then optionally add the interactive Claude Code skill.

Install via npm

Global install (recommended)

npm install -g agentopology

This gives you the agentopology command everywhere on your system.

Local install

If you prefer per-project installs:

npm install --save-dev agentopology

Then run commands through npx:

npx agentopology validate topology.at

Verify installation

agentopology --version

You should see output like:

agentopology v1.0.0

Claude Code skill installation

The /at skill lets you build topologies interactively inside Claude Code. Install it by symlinking:

agentopology skill install

This creates a symlink in your Claude Code skills directory. Once installed, open Claude Code and type /at to start building topologies conversationally.

What's next

You have the CLI ready. Head to the Quickstart to write and scaffold your first topology.