docs: Document runpodctl model commands with add, list, and remove

docs.json

@@ -438,6 +438,7 @@
               "runpodctl/reference/runpodctl-serverless",
               "runpodctl/reference/runpodctl-template",
               "runpodctl/reference/runpodctl-hub",
+              "runpodctl/reference/runpodctl-model",
               "runpodctl/reference/runpodctl-network-volume",
               "runpodctl/reference/runpodctl-registry",
               "runpodctl/reference/runpodctl-gpu",

runpodctl/overview.mdx

@@ -1,12 +1,12 @@
 ---
 title: "Overview"
 sidebarTitle: "Overview"
 description: "Use Runpod CLI to manage Pods, Serverless endpoints, templates, and more from your local machine. Review commands and usage guidance for the Runpod CLI."
 ---
 
 import { PodsTooltip, PodTooltip } from "/snippets/tooltips.jsx";
 
 Runpod CLI is an [open source](https://github.com/runpod/runpodctl) command-line tool for managing your Runpod resources from your local machine. You can manage Pods, Serverless endpoints, templates, network volumes, and models, transfer files between your system and Runpod, diagnose issues, and view account information.
 
 ## Quick start
 
@@ -20,7 +20,7 @@
 runpodctl pod list                  # List your Pods
 ```
 
 ## Install Runpod CLI locally
 
 Every <PodTooltip /> you deploy comes preinstalled with `runpodctl` and a Pod-scoped API key. You can also install it on your local machine to manage resources remotely.
 
@@ -149,7 +149,7 @@
 runpodctl doctor
 ```
 
 This command guides you through first-time setup, including API key configuration and SSH key setup.
 
 Alternatively, you can manually configure your API key:
 
@@ -162,7 +162,7 @@
 saved apiKey into config file: /Users/runpod/.runpod/config.toml
 ```
 
 ### Step 3: Verify installation
 
 To verify that `runpodctl` installed successfully, run this command:
 
@@ -170,7 +170,7 @@
 runpodctl version
 ```
 
 You should see which version is installed:
 
 ```bash
 runpodctl v2.0
@@ -178,14 +178,15 @@
 
 ## Command groups
 
 Runpod CLI organizes commands into groups based on the resource type:
 
 | Command | Alias | Description |
 |---------|-------|-------------|
 | `runpodctl pod` | | Manage Pods (create, list, start, stop, delete) |
 | `runpodctl serverless` | `sls` | Manage Serverless endpoints |
 | `runpodctl template` | `tpl` | List, search, and manage templates |
 | `runpodctl hub` | | Browse and deploy from the Runpod Hub |
+| `runpodctl model` | | List available models |
 | `runpodctl network-volume` | `nv` | Manage network volumes |
 | `runpodctl registry` | `reg` | Manage container registry authentications |
 | `runpodctl gpu` | | List available GPUs |
@@ -196,7 +197,7 @@
 
 ## Help and reference
 
 Learn how to use Runpod CLI commands by browsing the CLI reference using the sidebar to the left, or by running the `help` command:
 
 ```bash
 runpodctl help
@@ -215,6 +216,6 @@
 runpodctl completion
 ```
 
 This command auto-detects your shell and adds the appropriate source command to your shell configuration file (`~/.bashrc` or `~/.zshrc`). The command is idempotent—running it again skips installation if completion is already configured.
 
 Restart your shell or source the configuration file for changes to take effect.

runpodctl/reference/runpodctl-model.mdx

@@ -0,0 +1,151 @@
+---
+title: "model"
+sidebarTitle: "model"
+---
+
+Manage models in the Model Repo, including adding, uploading, listing, and removing models.
+
+```bash
+runpodctl model <subcommand> [flags]
+```
+
+## Subcommands
+
+### Add a model
+
+Register a new model with the Model Repo:
+
+```bash
+runpodctl model add --name "my-model"
+```
+
+To upload model files from a local directory:
+
+```bash
+runpodctl model add --name "my-model" --model-path ./model-files
+```
+
+#### Add flags
+
+<ResponseField name="--name" type="string" required>
+Model name.
+</ResponseField>
+
+<ResponseField name="--owner" type="string">
+Model owner namespace (user or team owner ID). Use this to add models to a team account.
+</ResponseField>
+
+<ResponseField name="--model-status" type="string">
+Initial model status.
+</ResponseField>
+
+<ResponseField name="--credential-type" type="string">
+Credential type (if required for model access).
+</ResponseField>
+
+<ResponseField name="--credential-reference" type="string">
+Credential reference (if required for model access).
+</ResponseField>
+
+<ResponseField name="--model-path" type="string">
+Directory containing model files to upload. When specified, all files in the directory are uploaded to the Model Repo.
+</ResponseField>
+
+<ResponseField name="--create-upload" type="bool">
+Create an upload session without uploading files. Use this to get upload URLs for manual file uploads.
+</ResponseField>
+
+<ResponseField name="--file-name" type="string">
+File name for single-file upload.
+</ResponseField>
+
+<ResponseField name="--file-size" type="string">
+File size in bytes for single-file upload.
+</ResponseField>
+
+<ResponseField name="--part-size" type="string">
+Multipart upload part size in bytes.
+</ResponseField>
+
+<ResponseField name="--content-type" type="string">
+Content type for the upload.
+</ResponseField>
+
+<ResponseField name="--graphql-timeout" type="duration">
+GraphQL request timeout. Defaults to 30 minutes for model upload operations.
+</ResponseField>
+
+### List models
+
+List models in your account:
+
+```bash
+runpodctl model list
+```
+
+Filter by provider or name:
+
+```bash
+runpodctl model list --provider huggingface
+runpodctl model list --name "llama"
+```
+
+#### List flags
+
+<ResponseField name="--provider" type="string">
+Filter by model provider.
+</ResponseField>
+
+<ResponseField name="--name" type="string">
+Filter by model name.
+</ResponseField>
+
+### Remove a model
+
+Remove a model from the Model Repo:
+
+```bash
+runpodctl model remove <model-id>
+```
+
+You can specify the model by ID or name:
+
+```bash
+runpodctl model remove my-model
+```
+
+<Warning>
+
+Removing a model permanently deletes it and all associated versions from the Model Repo. This action cannot be undone.
+
+</Warning>
+
+## Environment variables
+
+<ResponseField name="RUNPOD_GRAPHQL_URL" type="string">
+Override the GraphQL API endpoint URL. Defaults to `https://api.runpod.io/graphql`.
+</ResponseField>
+
+## Output format
+
+The `model add`, `model list`, and `model remove` subcommands return structured output, formatted as JSON by default. To get YAML instead, use runpodctl's global output flag, `-o` (or `--output`), which accepts `json` or `yaml`:
+
+```bash
+runpodctl model list -o yaml
+```
+
+## Using model version hashes
+
+To create a Serverless endpoint that uses a model from the Model Repo, reference the model by its version hash:
+
+```bash
+runpodctl serverless create --template-id "tpl_abc123" --name "my-endpoint" \
+  --model-reference "abc123def456"
+```
+
+Run `runpodctl model list` to find the version hash for your model. The hash appears as a field in the command's structured output.
+
+## Related commands
+
+- [`runpodctl serverless create`](/runpodctl/reference/runpodctl-serverless)
+- [`runpodctl hub`](/runpodctl/reference/runpodctl-hub)