Skip to main content

​
Overview

nen quickstart is an interactive, menu-driven tour that walks you through the platform step by step — no code required to get started. 
nen quickstart
On first run it will ask for your Nen API key, validate it, and save it to ~/.config/nen/config.json so you don’t have to re-enter it.

​
The Four Guides

​
1. Your first desktop

Provisions a cloud desktop, takes a live screenshot, and tears it down. Teaches the core execute API without writing any code. What it does:
  • Creates a new cloud desktop from the pool
  • Calls POST /desktops/{id}/execute with a screenshot action
  • Displays the live view URL and saves the screenshot locally
  • Deletes the desktop when done

​
2. Manage desktops

Walks through every nen desktop CLI command against a real desktop — create, list, status, and delete — so you can see the exact output and understand the lifecycle. What it does:
  • Runs nen desktop create and shows the response
  • Runs nen desktop list showing the table output
  • Runs nen desktop status for the new desktop
  • Runs nen desktop delete with confirmation

​
3. Run an AI agent

Provisions a desktop and runs a full Claude agent loop entirely inside the CLI — no installation, no Python, no code. Claude sees the screen, decides what to do, and acts autonomously. What it does:
  • Provisions a desktop and waits for it to stabilize
  • Discovers available tools from GET /desktops/{id}/tools
  • Runs a Claude Sonnet agent loop (up to 25 steps) directly in your terminal
  • Streams thinking summaries and tool actions live
  • Optionally opens a browser window to the live desktop view
  • Deletes the desktop when the task is done

​
4. Build your own agent

Scaffolds a ready-to-run agent project on disk, pre-fills your API keys, installs dependencies, and optionally runs it immediately. You keep the code. What it does:
  • Scaffolds the anthropic-computer-use template into nen-anthropic-cua/
  • Writes your Nen and Anthropic API keys into .env automatically
  • Runs uv sync to install Python dependencies (prompts to install uv if missing)
  • Optionally runs agent.py with a task you specify right away
  • Leaves you with a working codebase to modify and ship
Guide 4 is the fastest path from zero to a running agent you own. Use Guide 3 if you just want to see autonomous desktop control without touching code.

​
API Key Storage

nen quickstart stores your API keys in ~/.config/nen/config.json after validating them. Subsequent runs — and other nen commands — read from there automatically, so you only need to enter your key once. You can always override the stored key with environment variables: 
NEN_API_KEY=sk_nen_... nen quickstart

​
Next Steps

Desktop Commands

Full reference for nen desktop create, list, status, delete

Examples

Complete agent loop examples for Claude and GPT