Skip to main content

Platform Commands

Platform mode connects the CLI to codewire.sh for workspace management, org administration, and remote access. All platform commands require authentication via cw setup or cw login.

Setup

setup

Interactive wizard that configures platform mode. Walks you through server URL, login, org selection, resource selection, and GitHub connection.
Run this once to get started. Your configuration is saved to ~/.codewire/platform.json.

Authentication

login

Authenticate with the Codewire platform.

logout

Sign out and clear stored credentials.

whoami

Show the currently authenticated user.

Organizations

orgs list

List all organizations you belong to.

orgs create

Create a new organization.

orgs delete

Delete an organization (owner only).

orgs invite

Invite a member to an organization.

Resources

resources list

List resources in the current organization.

resources get

Show details for a specific resource.

resources create

Create a new resource.

resources delete

Delete a resource (owner or admin only).

Workspaces

launch

Create a workspace from a repository URL. AI analyzes the repo to detect language, framework, Docker configuration, and services.
Pass . to use the current directory’s remote URL.

workspaces

List workspaces across your resources.

open

Open a workspace in your browser or connect via SSH.

start / stop

Start or stop a workspace.

Running Commands

run (platform mode)

In platform mode, cw run SSHs into a workspace and runs a command in a persistent session.
In standalone mode, cw run creates a local PTY session. In platform mode, it connects to a workspace first. See Sessions for standalone session management.

Secrets

secrets

Manage organization secrets from the CLI.

Billing & Cost

cost

View resource usage and cost estimates.

billing

Open the billing portal.

GitHub

github login

Authenticate with GitHub for private repo access.

github logout

Remove stored GitHub credentials.

github status

Check GitHub authentication status.

Utilities

update

Update the CLI to the latest version.

completion

Generate shell completions.