Quickstart

Get up and running with Agentver in under a minute.

1. Install the CLI

Install Agentver globally using Bun or npm:

terminal
$ bun add -g @agentver/cli

Or with npm: npm install -g @agentver/cli

2. Scan for agents

Agentver auto-detects which AI agents you have installed:

terminal
$ agentver scan
 found 3 agents:
 ✓ claude-code ~/.claude/
 ✓ cursor ~/.cursor/rules/
 ✓ windsurf ~/.windsurf/rules/

3. Install a skill

Install a skill from any Git repository. Agentver fetches the files, runs a security scan before anything touches your disk, installs to .agentver/skills/, connects it to all your detected agents, and records the source and integrity hash in your local manifest and lockfile:

terminal
$ agentver install github.com/acme/deploy-checker
 ↓ fetching deploy-checker@2.1.0
 ✓ security scan passed
 ✓ verified integrity
 ✓ installed to all detected agents

What just happened?

  1. 1. Fetched the skill files from the Git repository
  2. 2. Scanned every file against 28 security rules before writing to disk
  3. 3. Installed to .agentver/skills/deploy-checker/
  4. 4. Connected to all detected agents via symlinks (Claude Code, Cursor, Windsurf, etc.)
  5. 5. Recorded the source, version, and integrity hash in your local manifest and lockfile

This is a local operation. Nothing is published to the Agentver registry. Your agents can use the skill immediately.

4. Check what you have

List installed skills, check their status, or see if updates are available:

terminal
$ agentver list
 deploy-checker 2.1.0 github.com/acme/deploy-checker

$ agentver status
 ✓ deploy-checker up-to-date

5. Publish your own skills

Installing pulls skills from external sources. To publish your own skills to the Agentver registry so others can install them, use publish:

terminal
$ agentver init
 Created SKILL.md and manifest

 ... edit your SKILL.md ...

$ agentver publish --version 1.0.0
 ✓ security audit passed
 ✓ published my-skill@1.0.0

You can also use agentver save to commit working changes without creating a version, and agentver draft to manage draft branches.