feat: add readme

Author: stainless-app[bot]

README.md

@@ -1,136 +1,33 @@
-# Stainless API CLI
+# Stainless V0 CLI
 
-A command-line interface for interacting with the Stainless API to manage projects, builds, and SDK generation.
+The official CLI for the Stainless V0 REST API.
 
-## Installation
-
-```bash
-go install github.com/stainless-api/stainless-api-cli@latest
-```
-
-## Authentication
-
-Before using the CLI, you need to authenticate with the Stainless API.
-
-```bash
-# Log in using OAuth device flow
-stainless-api-cli auth login
-
-# Check authentication status
-stainless-api-cli auth status
-
-# Log out and remove saved credentials
-stainless-api-cli auth logout
-```
-
-You can also authenticate by setting the `STAINLESS_API_KEY` environment variable, which takes precedence over saved credentials.
-
-## Projects
-
-Manage your Stainless projects.
-
-```bash
-# Retrieve a project
-stainless-api-cli projects retrieve --project-name <project-name>
-
-# Update a project
-stainless-api-cli projects update --project-name <project-name> --display-name "New Project Name"
-```
-
-### Project Branches
-
-```bash
-# Create a new branch
-stainless-api-cli projects:branches create --project <project-name> --branch <branch-name> --branch-from main
-
-# Retrieve a branch
-stainless-api-cli projects:branches retrieve --project <project-name> --branch <branch-name>
-```
-
-### Project Configs
+It is generated with [Stainless](https://www.stainless.com/).
 
-```bash
-# Retrieve project configuration
-stainless-api-cli projects:configs retrieve --project <project-name> --branch <branch-name>
-
-# Guess project configuration based on OpenAPI spec
-stainless-api-cli projects:configs guess --project <project-name> --spec <path-to-spec>
-```
-
-## Builds
-
-Create and manage builds for your projects.
-
-```bash
-# Create a new build
-stainless-api-cli builds create --project <project-name> --revision <revision> --openapi-spec <path-to-spec> --stainless-config <path-to-config>
-
-# Create a build and wait for completion
-stainless-api-cli builds create --project <project-name> --revision <revision> --openapi-spec <path-to-spec> --wait
-
-# Create a build, wait for completion, and pull outputs
-stainless-api-cli builds create --project <project-name> --revision <revision> --openapi-spec <path-to-spec> --wait --pull
-
-# Retrieve a build
-stainless-api-cli builds retrieve --build-id <build-id>
-
-# List builds for a project
-stainless-api-cli builds list --project <project-name> --branch <branch-name>
-```
-
-## Build Target Outputs
+## Installation
 
-Retrieve and pull build target outputs.
+### Installing with Go
 
-```bash
-# Retrieve build target output
-stainless-api-cli build_target_outputs retrieve --build-id <build-id> --target <target> --type <type> --output <output>
+<!-- x-release-please-start-version -->
 
-# Pull build target output
-stainless-api-cli build_target_outputs pull --build-id <build-id> --target <target> --type <type> --output <output>
+```sh
+go install 'github.com/stainless-api/stainless-api-cli'
 ```
 
-## Environment Variables
-
-- `STAINLESS_API_KEY`: API key for authentication (takes precedence over saved credentials)
-- `NO_COLOR`: Disable colored output
-- `FORCE_COLOR`: Force colored output (`1` to enable, `0` to disable)
+<!-- x-release-please-end -->
 
-## Examples
+## Usage
 
-```bash
-# Generate a TypeScript SDK for your API
-stainless-api-cli builds create --project my-project --branch main --openapi-spec ./openapi.yml --wait --pull --targets typescript
+The CLI follows a resource-based command structure:
 
-# Generate multiple SDKs at once
-stainless-api-cli builds create --project my-project --branch main --openapi-spec ./openapi.yml --wait --pull --targets typescript,python,go
+```sh
+stainless-api-cli [resource] [command] [flags]
 ```
 
-## Shell Completion
-
-The CLI supports shell completion. To enable it:
-
-```bash
-# For bash
-stainless-api-cli completion bash > /etc/bash_completion.d/stainless-api-cli
-
-# For zsh
-stainless-api-cli completion zsh > "${fpath[1]}/_stainless-api-cli"
-
-# For fish
-stainless-api-cli completion fish > ~/.config/fish/completions/stainless-api-cli.fish
+```sh
+stainless-api-cli builds create \
+  --project project \
+  --revision string
 ```
 
-## Available SDK Targets
-
-The Stainless API CLI can generate SDKs for multiple languages:
-
-- `typescript` - TypeScript SDK
-- `node` - Node.js SDK
-- `python` - Python SDK
-- `go` - Go SDK
-- `ruby` - Ruby SDK
-- `java` - Java SDK
-- `kotlin` - Kotlin SDK
-- `cli` - Command-line interface
-- `terraform` - Terraform provider
+For details about specific commands, use the `--help` flag.