CLI Commands

The Sherpi CLI is published as @sherpi/cli. All commands run in your shell.

Auth

sherpi login

`sherpi logout`

Clear stored credentials.

sherpi logout

`sherpi whoami`

Show the currently authenticated user, org, role, plan, and usage.

sherpi whoami

Setup

`sherpi setup --editor <editor>`

Configure your AI editor. Installs Sherpi context (rules file) and the quickstart skill at user level so your agent knows about Sherpi on every session.

sherpi setup --editor claude

Valid editors: claude, cursor, codex, windsurf, copilot, gemini.

Does not require login — you can run setup before or after sherpi login.

`sherpi web [target]`

Open the Sherpi web app in your browser.

sherpi web                    # skills library
sherpi web review             # review queue
sherpi web settings           # org settings
sherpi web invoice-maker      # specific skill page

Skills

All authoring, discovery, install, and review commands live under sherpi skills.

Discovery

`sherpi skills search [query]`

Search the org's skill library.

sherpi skills search invoice                 # text search
sherpi skills search --tags finance,pdf      # filter by tags
sherpi skills search --tags                  # list all tags
sherpi skills search --authors               # list all authors
sherpi skills search --author alex           # filter by author
sherpi skills search --status in_review      # filter by status (admin)
sherpi skills search --public                # search public skills (no login needed)

`sherpi skills info <spec>`

Show details for a skill — description, tags, version, files.

sherpi skills info invoice-maker
sherpi skills info invoice-maker@v1          # specific version
sherpi skills info @bonnard/deploy-checklist # public skill

`sherpi skills installed`

Show skills currently installed locally (project + user scopes).

sherpi skills installed

`sherpi skills history <name>`

Show version history — date, author, and size for each version.

sherpi skills history invoice-maker

Install

`sherpi skills install <spec>`

Install a skill into your editor's skills directory.

sherpi skills install invoice-maker                    # from org (latest)
sherpi skills install invoice-maker --user             # user scope (all projects)
sherpi skills install invoice-maker --force            # overwrite existing
sherpi skills install @bonnard/deploy-checklist        # public skill (no login needed)
sherpi skills install --token x7k9m2p4                 # from share link
sherpi skills install invoice-maker --editor cursor    # set editor preference

Scope:

Project (default) — ./<editor>/skills/<name>, available in this project only
User (--user) — ~/.<editor>/skills/<name>, available in every project

`sherpi skills uninstall <name>`

Remove an installed skill from both project and user scopes.

sherpi skills uninstall invoice-maker

Authoring

`sherpi skills create [name]`

Scaffold a new skill locally with SKILL.md, assets/, and scripts/.

sherpi skills create invoice-maker
sherpi skills create shared-utils --user       # user scope

`sherpi skills check <name>`

Validate a local skill before publishing. Runs frontmatter and file layout checks. Nothing is uploaded.

sherpi skills check invoice-maker

`sherpi skills publish <name>`

Publish a skill — uploads, validates, and creates a new version.

sherpi skills publish invoice-maker                           # to default space
sherpi skills publish invoice-maker --space engineering       # to specific space
sherpi skills publish invoice-maker --personal                # personal (auto-publishes)

Tag behavior on publish:

Omit tags: line → server preserves existing tags
tags: [] → clears tags
tags: [a, b] → replaces with listed tags

`sherpi skills edit <spec>`

Edit skill properties.

sherpi skills edit general/invoice-maker --description "New description"
sherpi skills edit general/invoice-maker --tags "finance,pdf"
sherpi skills edit general/invoice-maker --tags ""            # clear tags
sherpi skills edit general/invoice-maker --public             # make publicly visible
sherpi skills edit general/invoice-maker --public --listed    # public + discoverable
sherpi skills edit general/invoice-maker --private            # remove from public
sherpi skills edit general/invoice-maker --listed             # show in public search
sherpi skills edit general/invoice-maker --unlisted           # hide from public search

`sherpi skills mine`

List skills you've authored — drafts, in review, published, and rejected.

sherpi skills mine

Review (admin)

`sherpi skills pending`

List skills in the review queue.

sherpi skills pending

`sherpi skills approve <spec>`

Approve a skill in review — publishes it to the org.

sherpi skills approve general/invoice-maker

`sherpi skills reject <spec>`

Reject a skill in review with a reason.

sherpi skills reject general/invoice-maker --comment "Missing error handling"

`sherpi skills delete <name>`

Permanently delete a skill and all its versions. Admin only.

sherpi skills delete invoice-maker --force

Share a skill — internally by email or externally via link.

sherpi skills share general/invoice-maker alex@team.com              # internal share
sherpi skills share general/invoice-maker --link                     # generate share link
sherpi skills share general/invoice-maker --link friend@other.com    # link + email
sherpi skills share general/invoice-maker --list                     # list all shares
sherpi skills share general/invoice-maker --revoke x7k9m2p4          # revoke a link
sherpi skills share public/invoice-maker                             # print public URL

`sherpi skills publish-public <spec>`

Publish or update a skill in the public space. Admin only.

sherpi skills publish-public general/invoice-maker --listed
sherpi skills publish-public general/invoice-maker --unlisted

`sherpi skills copy <spec>`

Copy a published skill to another space. Creates an independent copy.

sherpi skills copy general/invoice-maker --space public --listed     # to public
sherpi skills copy engineering/invoice-maker                         # to personal

`sherpi skills move <spec>`

Move a skill to another space. Keeps version history.

sherpi skills move general/invoice-maker --space engineering
sherpi skills move general/invoice-maker --space public --listed

Versioning

`sherpi skills restore <spec>`

Re-publish an older version as the new latest. Does not delete anything.

sherpi skills restore invoice-maker@v2

Spaces

Manage org spaces — containers that organise skills and control access.

`sherpi spaces`

List all spaces you have access to.

sherpi spaces

`sherpi spaces info <slug>`

Show space details — type, visibility, members, settings.

sherpi spaces info engineering

`sherpi spaces create <slug>`

Create a new team space.

sherpi spaces create engineering --name "Engineering"

`sherpi spaces edit <slug>`

Update space settings.

sherpi spaces edit engineering --visibility open
sherpi spaces edit engineering --visibility private
sherpi spaces edit engineering --auto-publish true

`sherpi spaces delete <slug>`

Delete a space and archive its skills.

sherpi spaces delete old-space --force

`sherpi spaces members <slug>`

List members of a space.

sherpi spaces members engineering

`sherpi spaces join <slug>`

Join an open space.

sherpi spaces join engineering

`sherpi spaces leave <slug>`

Leave a space.

sherpi spaces leave engineering

`sherpi spaces add <slug> <email>`

Add a member to a space.

sherpi spaces add engineering max@team.com
sherpi spaces add engineering max@team.com --role admin

`sherpi spaces remove <slug> <email>`

Remove a member from a space.

sherpi spaces remove engineering max@team.com

`sherpi spaces role <slug> <email> <role>`

Change a member's role in a space.

sherpi spaces role engineering max@team.com admin

Org Settings

`sherpi org settings get`

Show current org settings.

sherpi org settings get

`sherpi org settings set <key> <value>`

Update an org setting. Admin only.

sherpi org settings set auto-publish false
sherpi org settings set auto-publish true
sherpi org settings set allow-public-domains true

On this page