Command reference

Every command is a thin wrapper over one HTTP endpoint under /api/cli, so anything the CLI does can also be done with curl from a script or CI job.

add

Downloads a public prompt's files into prompts/<org>/<name>/ and records the version in rubricary.lock.json. Without a version it installs the current one. To install a specific version, add @ and the label shown on the prompt's Versions tab. No account is needed.

1npx rubricary add support/refund-request
2npx rubricary add support/refund-request@v1.4 --dir src/prompts

1✓ support/refund-request@v1.4 (8cf85ac, MIT)
2  score   88/100 on openai/gpt-5-mini, judged by typesafe/jev-1.13
3  files   prompts/support/refund-request/
4          · LICENSE
5          · README.md
6          · evals.yaml
7          · prompt.md

--dir changes the folder; the default is prompts. If a file on disk differs from the downloaded version, add stops and lists the file, so it never overwrites a local edit. Pass --force to overwrite. Running add again on a newer version updates the files and the lockfile:

1{
2  "prompts": {
3    "support/refund-request": {
4      "version": "v1.4",
5      "commit": "8cf85ac4c17d5efc824a505f9f609b8aee5fc976",
6      "path": "prompts/support/refund-request",
7      "url": "https://app.rubricary.com/prompt/support/refund-request"
8    }
9  }
10}

The same call over HTTP. This is also what the “Fetch at runtime” snippet on each prompt uses:

1curl "https://app.rubricary.com/api/cli/add?prompt=support/refund-request@v1.4"

1{
2  "name": "support/refund-request",
3  "version": "v1.4",
4  "current": true,
5  "commit": "8cf85ac4c17d…",
6  "license": "MIT",
7  "locale": "en-US",
8  "score": { "value": 88, "model": "openai/gpt-5-mini", "judge": "typesafe/jev-1.13-20260917", "ranAt": "…" },
9  "url": "https://app.rubricary.com/prompt/support/refund-request",
10  "files": {
11    "prompt.md": "…",
12    "evals.yaml": "…",
13    "README.md": "…",
14    "LICENSE": "…"
15  }
16}

score is the latest eval run of that version, or null if it has not been evaluated yet. Methodology explains how scores are computed. A malformed name returns 400. A version that does not exist returns 404 and lists the versions that do, and a private prompt returns the same 404 as one that does not exist. Responses allow any origin (CORS), so a browser app can call the endpoint directly.

info

Prints the current version, its score, the license and the latest versions with their scores.

1npx rubricary info support/refund-request

login and push

These will let you publish new versions from the terminal, once API keys are available. Both endpoints already exist and return 501 with a message saying what to do instead. Until then, sign in on the web: owners and admins of a prompt's organization can commit and publish from the Edit button on the prompt page. The editor runs the same lint a push will.