Skip to content

cli.md

Latest commit

 

History

History
189 lines (147 loc) · 5.48 KB

cli.md

File metadata and controls

189 lines (147 loc) · 5.48 KB

CLI

smp is the command-line companion for Skills-Manager-Plus. It uses the same central repository, database, preset model, Global Workspace services, and Git backup lifecycle as the desktop app.

The CLI is useful for scripted checks, backup automation, repository recovery, and bulk workspace operations.

Install

CLI binaries are published as direct release assets with each app version. Download the matching asset from the latest release, put it on PATH, and make it executable on macOS/Linux.

# Linux x64
curl -L -o smp \
  https://github.com/arch3rPro/Skills-Manager-Plus/releases/latest/download/smp-linux-x64
chmod +x smp
sudo mv smp /usr/local/bin/smp

# macOS arm64
curl -L -o smp \
  https://github.com/arch3rPro/Skills-Manager-Plus/releases/latest/download/smp-macos-arm64
chmod +x smp
sudo mv smp /usr/local/bin/smp

Available release assets:

  • smp-macos-arm64
  • smp-macos-x64
  • smp-linux-x64
  • smp-windows-x64.exe

Each asset also has a .sha256 checksum file.

Core Options

smp --json repo status
smp --skills-root /path/to/skills repo status
  • --json prints compact JSON for automation.
  • --skills-root points the CLI at an external skills repository instead of the app's default central repository.

Repository And Tools

smp repo status
smp repo set-path ~/SkillsManagerPlus
smp repo reset-path
smp tools list
smp tools enable codex
smp tools disable codex
smp tools set-path codex ~/.codex/skills
smp tools reset-path codex
smp tools set-sync-mode codex symlink
smp tools add-custom my_agent "My Agent" ~/.my-agent/skills --project-dir .my-agent/skills
smp tools remove-custom my_agent

repo commands inspect or change the central repository path. tools list shows installed and enabled agents, their global skills directory, and custom-tool metadata.

Skills

smp skills list
smp skills show rss-ai-digest
smp skills install ./my-skill --local --sync
smp skills install https://github.com/user/repo.git --git --sync-preset "Default"
smp skills search obsidian
smp skills check --all
smp skills update --all
smp skills export rss-ai-digest --dest /tmp/rss-ai-digest
smp skills adopt ~/.agents/skills --dry-run
smp skills remove old-skill --yes

Install and update commands reuse the same source metadata as the desktop app. Git, skills.sh, ClawHub, plugin-backed Git skills, and local skills follow the shared update paths where available.

Local Skill Discovery

smp local scan
smp local import ~/.codex/skills/rss-ai-digest
smp local import-all

Local commands reuse the desktop local-discovery workflow for importing existing agent-global skills into the Skills Center.

Plugin Marketplace

smp plugins markets
smp plugins add-market https://github.com/user/plugin-market.git
smp plugins refresh market-id
smp plugins list
smp plugins search obsidian
smp plugins install market-id plugin-name
smp plugins installed
smp plugins remove-market market-id

Plugin commands expose the same Git-backed marketplace flow as the desktop Skills Store, including plugin-packaged skill installation and installed-skill listing.

ClawHub

smp clawhub browse --sort downloads --limit 20
smp clawhub search obsidian --limit 20
smp clawhub detail openclaw/example
smp clawhub install openclaw/example
smp clawhub validate-key
smp clawhub star openclaw/example
smp clawhub unstar openclaw/example

ClawHub commands use the configured desktop ClawHub API key and proxy settings. Network and authenticated actions still require valid local configuration.

Presets

smp presets list
smp presets current
smp presets preview "Default"
smp presets apply "Default"
smp presets deactivate "Default"
smp presets add-skill "Default" rss-ai-digest
smp presets remove-skill "Default" rss-ai-digest

Presets are still backed by the desktop app's compatible scenario-shaped storage internally, but the CLI exposes the product-facing Preset model.

Global Workspace

smp workspace agents
smp workspace skills codex
smp workspace document codex rss-ai-digest
smp workspace add codex rss-ai-digest
smp workspace remove codex rss-ai-digest
smp workspace import codex local-only-skill
smp workspace pull codex rss-ai-digest
smp workspace delete-local codex local-only-skill --yes

Aliases are also available:

smp global-workspace agents
smp global agents

Workspace commands operate on real agent-global skills directories, the same surface used by the desktop Global Workspace page.

Git Lifecycle

smp git status
smp git init
smp git clone https://github.com/user/skills-backup.git
smp git set-remote https://github.com/user/skills-backup.git
smp git pull
smp git commit -m "backup: sync skills library"
smp git push
smp git versions --limit 10
smp git restore sm-v-20260522-120000

Git commands use the same snapshot and recovery helpers as the desktop Git Backup feature.

Data Backup And WebDAV

smp backup create
smp backup list
smp backup export /tmp/skills-manager-plus.sql
smp backup import /tmp/skills-manager-plus.sql
smp backup restore 20260522-120000.db
smp backup rename 20260522-120000.db "Before WebDAV restore"
smp backup delete 20260522-120000.db

smp webdav settings
smp webdav save --enabled --base-url https://example.com/dav --username user --password your-password
smp webdav test
smp webdav upload
smp webdav remote-info
smp webdav download

Backup and WebDAV commands use the same database snapshots, SQL export/import, sync manifests, and safety checks as the desktop recovery surfaces.