@dsh-fish/cli

Install dsh.fish artifacts from a terminal. The command on an artifact page is this binary; it applies the same install plan the website renders and the dsh-hub plugin executes.

Command names follow the skills CLI (add, find, list, remove, update, init) so the vocabulary is the one people already use to install agent skills. This CLI writes into DeepSeek Harness ($DSH_HOME), not into .claude/skills or other agent trees.

Install an artifact

npx @dsh-fish/cli add release-notes
npx @dsh-fish/cli add https://dsh.fish/a/release-notes --profile web
npx @dsh-fish/cli add acme/notes

add resolves a hub id, a dsh.fish URL, or owner/repo against the catalog, then runs the plan: files under $DSH_HOME, package-manager adds, and profile patch rows.

Git packages that build from source are refused until you pass --allow-build-scripts. That flag is permission to run the package's prepare script on this machine, outside the agent sandbox — the CLI will not grant it because you passed --yes.

Other commands

| Command | What it does | |---|---| | find [query] | Search the catalog (--kind restricts to one type). | | show <source> | One artifact and the commands installing it would run. | | list | Artifacts this machine installed through the CLI or the hub plugin. | | remove <id> | Reverse the recorded files, patch rows and packages. | | update [id] | Re-apply the current plan. | | init [name] | Write a SKILL.md the hub indexer will accept. | | login / logout / whoami | Device-grant account, same token as the hub plugin. | | rate <source> <1-5> [comment...] | Rate an artifact; replaces your previous rating. Needs login. | | reviews <source> | Average rating, 5-to-1 distribution and recent comments. |

npx @dsh-fish/cli find postgres --kind mcp-server
npx @dsh-fish/cli list --json
npx @dsh-fish/cli remove release-notes
npx @dsh-fish/cli init my-skill
npx @dsh-fish/cli rate dsh-postgres-mcp 5 "installed and queried in minutes"
npx @dsh-fish/cli reviews dsh-postgres-mcp

Ratings and reviews

The site uses a 1–5 star scale: 1 is broken or misleading, 5 is excellent. reviews is anonymous; rate needs login and always speaks for the signed-in account — rating again overwrites the earlier one, never stacks. What the CLI writes is exactly what the artifact page renders, so a rating lands on the site the moment the command returns.

An agent driving this CLI should follow the same rule the hub plugin's hub_rate tool states: rate only what it actually installed and used, from firsthand evidence, and tell its user when it leaves a rating.

Options

| Option | Description | |---|---| | --profile, -p | Harness profile (default $DSH_PROFILE or web). | | --registry | Hub origin (default $DSH_FISH_URL or https://dsh.fish). | | --kind, -k | Restrict find to one artifact kind. | | --allow-build-scripts | Permit a git package to run its prepare script. | | --json | Machine-readable output. | | --yes, -y | Skip confirmation prompts. Does not grant build scripts. |

License

MIT