# NVIDIA Brev

> NVIDIA Brev provides streamlined access to cloud GPU and CPU instances for AI development, training, inference, notebooks, remote IDE workflows, and compute management.

This file is intended for AI agents and assistants using Brev. It should be served from `https://brev.nvidia.com/llms.txt`. The file name `llms.txt` and root-path placement follow the common llms.txt convention: a Markdown-formatted text file at `/llms.txt` with an H1 title, a blockquote summary, concise context, and curated links.

Important Brev CLI guidance for agents:

- Inspect before mutation with `brev ls`; use `brev search` before creating when the user has not chosen an instance type; also run `brev org ls` when organization context matters.
- Treat `brev create` and repo/path-style `brev start` as GPU/billable by default. Confirm expected cost, GPU type, org, and instance name before creating. Use `brev create --dry-run` when previewing matching GPU types.
- Require explicit user approval before `brev create`, `brev start` when it may create, `brev delete`, `brev stop`, `brev stop --all`, `brev reset`, or any GPU/multi-instance spend.
- `brev shell`, `brev open`, and `brev copy` can auto-start stopped instances. Confirm before using them on stopped resources.
- Before create/start actions, state the instance name, repo/path if any, org, and exact GPU/CPU intent. Use `brev search cpu` for CPU-only discovery.
- Prefer `brev exec <instance> <command>` for non-interactive remote commands and `brev shell <instance>` for interactive work.
- Do not invent commands from development branches or source snapshots. If a command is not present in `brev --help`, treat it as unavailable for the installed CLI.

Recommended first workflow:

- `brev login`
- `brev org ls`
- `brev ls`
- If the user names an org, run `brev org set <org-name>` and then `brev ls`.

Core command map:

- Login/logout: `brev login`, `brev logout`
- Discovery: `brev search`, `brev ls`, `brev ls --all`, `brev ls --org <org>`
- Instance lifecycle: `brev create <name>`, `brev create <name> --type <instance-type>`, `brev start <repo-or-instance>`, `brev stop <instance>`, `brev reset <instance>`, `brev delete <instance>`
- Instance access: `brev open <instance> <code|cursor|windsurf|terminal|tmux>`, `brev shell <instance>`, `brev ssh <instance>`, `brev exec <instance> <command>`, `brev copy <src> <dst>`, `brev port-forward <instance> --port <local>:<remote>`
- Org context: `brev org ls`, `brev org set <org>`, `brev set <org>`, `brev invite`, `brev redeem <code>`
- Device and SSH configuration: `brev refresh`, `brev ssh-key`, `brev register`, `brev deregister`, `brev enable-ssh`, `brev grant-ssh`, `brev revoke-ssh`
- Agent support: `brev agent-skill`
- Optional/provider-dependent commands: verify availability with `brev --help` before use.

When exact command names or flags matter, run `brev --help` or `brev <command> --help` against the installed CLI.

## Primary Documentation

- [Brev product site](https://brev.nvidia.com): Main Brev website where this file should be served from `/llms.txt`.
- [Brev user documentation](https://docs.nvidia.com/brev/latest/): User-facing Brev documentation.
- [Brev CLI README](https://github.com/brevdev/brev-cli/blob/main/README.md): Installation and high-level CLI usage.
- [Brev CLI contributor notes](https://github.com/brevdev/brev-cli/blob/main/docs/CONTRIBUTING.md): Development, build, and contribution guidance for the CLI repository.

## Optional

- [Brev CLI repository](https://github.com/brevdev/brev-cli): Source repository for the Brev CLI.