@usenaive-sdk/vetta-cli 0.1.0

package/README.md

@@ -0,0 +1,66 @@
+# @usenaive-sdk/vetta-cli
+
+The `vetta` command line — drive the whole Vetta API from a terminal or a script: agents, sessions,
+computers, skills, files, identities, vaults, comms, deployments, webhooks and credits.
+
+It is built on [`@usenaive-sdk/vetta`](https://www.npmjs.com/package/@usenaive-sdk/vetta), the same typed
+client the dashboard uses, so the CLI and the API never drift apart.
+
+## Install
+
+```bash
+npm i -g @usenaive-sdk/vetta-cli
+```
+
+## First run
+
+```bash
+vetta login --api-key sk_…      # or: vetta login --email … --password …
+vetta whoami
+```
+
+Credentials are stored on a named profile, so several organizations can be driven from one machine
+with `--profile`.
+
+## Shape
+
+```
+vetta <group> <command> [flags]
+```
+
+Groups: `agent` `audit` `auth` `computer` `connections` `credits` `deploy` `domain` `email` `file`
+`identity` `keys` `login` `logout` `models` `org` `phone` `run` `session` `skill` `vault` `webhook`
+`whoami`.
+
+`vetta <group> --help` lists a group's commands.
+
+Global flags: `--json` (the default) · `--human` · `--profile <name>` · `--api-key <key>` ·
+`--org <org_id>` · `--api-base-url <url>`
+
+## Example
+
+```bash
+# Create an agent, run one task, and read what it cost.
+vetta agent create \
+  --name summariser \
+  --model openai/gpt-oss-120b \
+  --system "Answer in one sentence." \
+  --budget-usd 2.00 --max-task-usd 0.10 --budget-period day
+
+vetta session run --agent agt_… --message "What is 17 times 3?"
+vetta session get ses_… --human
+```
+
+
+## Output
+
+`--json` is the default because the CLI is meant to be piped. Every command writes a single JSON
+document to stdout and nothing else; diagnostics go to stderr. `--human` switches to a readable
+table when you are driving it yourself.
+
+Exit codes follow the API's error taxonomy, so a script can branch on the failure rather than
+parsing a message.
+
+## License
+
+MIT