@duvoai/cli 0.0.1 → 0.1.1

package/README.md

@@ -0,0 +1,72 @@
+# @duvoai/cli
+
+Command-line interface for the [Duvo](https://duvo.ai) public API.
+
+## Install
+
+```bash
+npm install -g @duvoai/cli
+```
+
+Requires Node.js ≥ 22.22.0.
+
+## Quick start
+
+```bash
+# 1. Log in (prompts for your API key and saves it to a profile)
+duvo login --name default
+
+# 2. Verify you're logged in
+duvo whoami
+
+# 3. Create your first agent (interactive)
+duvo agents create
+
+# ...or create one non-interactively with flags
+duvo agents create --name "My agent" --input "What this agent should do"
+
+# 4. Kick off a run
+duvo runs start --agent <agent-id>
+```
+
+Grab an API key from your team settings: <https://app.duvo.ai/settings/api-keys>.
+
+## Authentication
+
+You can keep multiple profiles and switch between them:
+
+```bash
+duvo login --name acme         # prompts for the API key
+duvo login --name team-2       # prompts for the API key
+
+duvo profiles list             # show saved profiles
+duvo profiles use acme         # set the default profile
+duvo --profile team-2 whoami   # one-off override for a single command
+```
+
+## Commands
+
+| Command                                             | Description                                             |
+| --------------------------------------------------- | ------------------------------------------------------- |
+| `duvo login`                                        | Store an API key under a named profile                  |
+| `duvo logout`                                       | Remove a profile                                        |
+| `duvo whoami`                                       | Show the active profile, API key owner, and masked key  |
+| `duvo profiles <subcmd>`                            | `list`, `use`, `rename`, `remove`                       |
+| `duvo agents list`                                  | List agents on your team                                |
+| `duvo agents get <id>`                              | Show details for one agent                              |
+| `duvo agents create`                                | Create a new agent                                      |
+| `duvo agents update <id>`                           | Update an agent's name or settings                      |
+| `duvo agent-folders list`                           | List agent folders for your team                        |
+| `duvo agent-folders create`                         | Create an agent folder                                  |
+| `duvo agent-folders update <id>`                    | Rename or move an agent folder                          |
+| `duvo agent-folders delete <id>`                    | Delete an agent folder                                  |
+| `duvo agent-folders move-agents`                    | Move agents into a folder or to root                    |
+| `duvo runs start --agent <id>`                      | Start a new run for the given agent                     |
+| `duvo runs list`                                    | List runs for your team (filter by agent, status, etc.) |
+| `duvo sandboxes create`                             | Create a sandbox for staging files                      |
+| `duvo sandboxes files <id>`                         | List files in a sandbox directory                       |
+| `duvo sandboxes upload <id> <file>`                 | Upload a local file (max 10MB)                          |
+| `duvo sandboxes prepare-upload-url <id> --path <p>` | Get a presigned upload URL                              |
+| `duvo api <method> <path>`                          | Make a raw authenticated API request                    |
+
+Run `duvo <command> --help` for full flags on any command.