Skip to main content

​
Create

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

  Desktop ID:   dsk_abc123def456
  Type:         sandbox
  Status:       running
  Workspace ID: ws_org_abc
  Name:         dsk-us-west-2-42
  Tools URL:    https://desktop.api.getnen.ai/desktops/dsk_abc123def456/tools
  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  # alias: nen desktop ls

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
  Type:         sandbox
  Status:       running
  Workspace ID: ws_org_abc
  Name:         dsk-us-west-2-42
  Tools URL:    https://desktop.api.getnen.ai/desktops/dsk_abc123def456/tools
  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  # alias: nen desktop rm
FlagDescription
--force, -fSkip confirmation prompt
# Delete without confirmation
nen desktop delete dsk_abc123def456 --force

​
Files

Manage files on a desktop’s shared drive — persisted on EFS, scoped to the desktop, capped at 100 MiB per upload.

​
List Files

nen desktop files list dsk_abc123def456  # alias: ls

NAME              SIZE      MODIFIED
Documents/        <DIR>     just now
report.pdf        102400    just now
notes.txt         512       2m ago
Directory entries surface with a trailing / on the name and <DIR> in the size column (a trailing / in --quiet mode). Pass --path <subdir> to list a specific subdirectory.
FlagDescription
--path <subdir>, -p <subdir>List files in a subdirectory
--jsonOutput the response as JSON
--quiet, -qOnly print file names

​
Upload File

nen desktop files upload dsk_abc123def456 ./report.pdf
The remote name defaults to the basename of the local path. Content-Type is detected from the extension and falls back to application/octet-stream. Pass --path <subdir> to upload into a subdirectory; missing intermediate directories are created on the server.
FlagDescription
--name <name>Remote file name (defaults to basename of local-path)
--content-type <type>MIME type (defaults to detection from extension)
--path <subdir>, -p <subdir>Upload into the named subdirectory (created if missing)
--jsonOutput the response as JSON

​
Download File

nen desktop files download dsk_abc123def456 report.pdf
By default writes to ./<name>. Pass --output <path> (or -o <path>) to override, or --output - to write to stdout. The output file is not overwritten unless --force is passed. Pass --path <subdir> to download from a subdirectory.
FlagDescription
--output <path>, -o <path>Output file path (defaults to ./<name>; - writes to stdout)
--path <subdir>, -p <subdir>Download from the named subdirectory
--force, -fOverwrite the output file if it exists

​
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 (alias: ls)
nen desktop status dsk_abc123def456            # Get desktop details
nen desktop delete dsk_abc123def456            # Delete (with confirmation, alias: rm)
nen desktop delete dsk_abc123def456 -f         # Delete without confirmation
nen desktop files list dsk_abc123def456        # List files on the shared drive
nen desktop files list dsk_abc123def456 --path Documents  # List a subdirectory
nen desktop files upload dsk_abc123def456 ./report.pdf
nen desktop files upload dsk_abc123def456 ./report.pdf --path Documents  # Upload into a subdirectory
nen desktop files download dsk_abc123def456 report.pdf
nen desktop files download dsk_abc123def456 report.pdf --path Documents  # Download from a subdirectory