Skip to main content

​
Create

Provision a new cloud desktop: 
nen desktop create
Example output: 
Desktop created successfully!

  Desktop ID:   dsk_abc123def456
  Status:       running
  Workspace ID: ws_org_abc
  Name:         dsk-us-west-2-42
  Created:      2026-03-31T12:14:20-07:00
Name is only printed when the underlying instance has one. The desktop is ready to receive tool calls immediately. Pass --json to emit the response as JSON instead of the formatted layout above.

​
List

List all desktops in your workspace: 
nen desktop list

DESKTOP ID        STATUS   NAME                 CREATED
dsk_abc123def456  running  dsk-us-west-2-42     2026-03-31T12:14:20-07:00
dsk_789xyz012abc  running  -                    2026-03-31T11:05:00-07:00
Use -q/--quiet to print only desktop IDs (useful for piping into other commands), or --json for the structured form.

​
Status

Get details for a specific desktop: 
nen desktop status dsk_abc123def456

  Desktop ID:   dsk_abc123def456
  Status:       running
  Workspace ID: ws_org_abc
  Name:         dsk-us-west-2-42
  Created:      2026-03-31T12:14:20-07:00

​
Delete

Delete a desktop. You’ll be prompted to confirm unless --force is used: 
nen desktop delete dsk_abc123def456
FlagDescription
--force, -fSkip confirmation prompt
# Delete without confirmation
nen desktop delete dsk_abc123def456 --force

​
Global Flags

These flags apply to all nen commands:
FlagEnv VarDescriptionDefault
--api-urlNEN_API_URLDesktop API base URLhttps://desktop.api.getnen.ai
—NEN_API_KEYYour Nen API key—

​
Quick Reference

nen desktop create                             # Create a new cloud desktop
nen desktop list                               # List all desktops
nen desktop status dsk_abc123def456            # Get desktop details
nen desktop delete dsk_abc123def456            # Delete (with confirmation)
nen desktop delete dsk_abc123def456 -f         # Delete without confirmation