coreweave/cwic

coreweave/cwic

Description: CoreWeave Intelligent CLI

Stars: 12

Forks: 1

Open issues: 6

Created: 2025-10-10T17:23:31Z

Pushed: 2026-06-05T16:10:40Z

Default branch: main

Fork: no

Archived: no

README:

CWIC - CoreWeave Intelligent CLI

> Note: CWIC is a CoreWeave developed tool and is in-development. It is provided "as-is" without warranty. For official support, please refer to CoreWeave's main support channels.

CWIC (CoreWeave Intelligent CLI) is a powerful command-line interface for interacting with CoreWeave's high-performance AI infrastructure. Built for developers, researchers, and ML engineers who demand speed, scalability, and control over their cloud resources.

╔════════════════════════════════════════════════════════════╗
║ ║
║ ██████╗██╗ ██╗██╗ ██████╗ ║
║ ██╔════╝██║ ██║██║ ██╔═══ ║
║ ██║ ██║ █╗ ██║██║ ██║ ║
║ ██║ ██║███╗██║██║ ██║ ║
║ ╚██████╗╚███╔███╔╝██║ ╚██████ ║
║ ╚═════╝ ╚══╝╚══╝ ╚═╝ ╚═════╝ ║
║ ║
║ C W I C — CoreWeave Intelligent CLI ║
╚════════════════════════════════════════════════════════════╝

Features

• Authentication Management: Secure token-based authentication with CoreWeave services
• Cluster Operations: List, manage, and generate kubeconfigs for CoreWeave Kubernetes clusters
• Node Management: Comprehensive node operations including drain, cordon, reboot, and monitoring
• SUNK Cluster Interaction: Seamlessly interact with SUNK (Slurm) clusters
• Object Storage: Complete CoreWeave Object Storage (cwobject) management capabilities
• CoreWeave Dashboards: Link straight into the relevant dashboard, pre-filtered, in CoreWeave's managed Grafana

Table of Contents

• [CWIC - CoreWeave Intelligent CLI](#cwic---coreweave-intelligent-cli)
• [Features](#features)
• [Table of Contents](#table-of-contents)
• [Installation](#installation)
• [Pre-built Binaries](#pre-built-binaries)
• [Linux](#linux)
• [MacOS](#macos)
• [From Source](#from-source)
• [Auto-Update](#auto-update)
• [Getting Started](#getting-started)
• [1. Authentication](#1-authentication)
• [2. Verify Authentication](#2-verify-authentication)
• [3. Set Up Cluster Access](#3-set-up-cluster-access)
• [4. Basic Usage](#4-basic-usage)
• [Commands](#commands)
• [Authentication](#authentication)
• [Cluster Management](#cluster-management)
• [Node Operations](#node-operations)
• [SUNK (Slurm) Management](#sunk-slurm-management)
• [Cluster Operations](#cluster-operations)
• [Node Management](#node-management)
• [Job Management](#job-management)
• [Object Storage (cwobject)](#object-storage-cwobject)
• [NodePool Management](#nodepool-management)
• [Configuration](#configuration)
• [Development](#development)
• [Prerequisites](#prerequisites)
• [Testing](#testing)
• [Code Style](#code-style)

Installation

Pre-built Binaries

Download the latest release for your platform from the releases page. You will then need to add the binary to your PATH environment variable and/or /usr/local/bin.

Linux

gh release download -R coreweave/cwic -p "cwic_$(uname)_$(uname -m).tar.gz" -O - --clobber | tar zxf - cwic && mv cwic $HOME/.local/bin/

MacOS

gh release download -R coreweave/cwic -p "cwic_$(uname)_$(uname -m).tar.gz" -O - --clobber | tar zxf - cwic && mv cwic /usr/local/bin

From Source

Requires Go 1.24.1 or later:

git clone https://github.com/coreweave/cwic.git
cd cwic
make build

Auto-Update

CWIC can update itself to the latest version:

cwic update

Getting Started

1. Authentication

Before using CWIC, you need to authenticate with CoreWeave. You can either provide a token directly or use the interactive browser-based authentication:

# Interactive authentication (opens browser)
cwic auth login

# Direct token authentication
cwic auth login YOUR_TOKEN_HERE

To get a token: 1. Visit https://console.coreweave.com/tokens 2. Generate a new API token 3. Use it with cwic auth login YOUR_TOKEN

This CW token will be used for different functionality throughout cwic including but not limited to:

• kubeconfig generation
• metrics querying
• cwobject interactions
• CW API interactions (CKS cluster listing)

2. Verify Authentication

Check your authentication status:

# Check current user/organization
cwic auth whoami

# Verify access by listing clusters
cwic cluster get

The whoami command shows which organization you're authenticated as, and cluster get will list your current CKS clusters if authentication is successful.

3. Set Up Cluster Access

> [!NOTE] > Only clusters with a Public endpoint are supported for cwic cluster auth

Generate a kubeconfig for your cluster:

# List available clusters
cwic cluster get

# Generate kubeconfig for a specific cluster
cwic cluster auth CLUSTER_NAME

# Generate kubeconfig for all clusters
cwic cluster auth all

> [!IMPORTANT] > Kubernetes-based cwic commands (node, sunk, nodepool) require this kubeconfig. > If you created a new kubeconfig file (not appended to default), set the KUBECONFIG environment variable: > ``bash > export KUBECONFIG=/path/to/your/kubeconfig >

4. Basic Usage

Once authenticated, you can start managing your CoreWeave resources:

# List nodes in your cluster (requires kubeconfig from step 3)
cwic node get

# Check cluster status (requires kubeconfig from step 3)
cwic sunk cluster describe

# List storage buckets (requires only CW auth token, no kubeconfig needed)
cwic cwobject list

Commands

Authentication

Manage your CoreWeave authentication credentials.

# Interactive login (opens browser)
cwic auth login

# Login with token
cwic auth login

# Login with a friendly name for the organization
cwic auth login --name "My Org"
cwic auth login -n "Production"

# Check current authentication status
cwic auth whoami

# Switch between authenticated accounts
cwic auth switch [organization]

# List all authenticated accounts
cwic auth switch

# Logout from current organization
cwic auth logout

Examples:

# Login to multiple organizations with friendly names
cwic auth login abc123... --name "Production"
cwic auth login xyz789... --name "Development"

# List all authenticated accounts
cwic auth switch
# Output:
# Production (org-id-123) (active)
# Development (org-id-456)

# Switch to different account
cwic auth switch Development
# Or use the organization ID directly…