Skip to main content

​
Overview

The Nen CLI (nen) gives you full control over desktops from your terminal.

​
Installation

Download the latest release for your platform from releases.getnen.ai: 
curl -sL https://releases.getnen.ai/nen/latest/nen_darwin_arm64.tar.gz | tar xz
sudo mv nen /usr/local/bin/
Verify the installation: 
nen --help

​
Configuration

The CLI reads a couple of environment variables. These also work anywhere you construct desktop API URLs by hand (e.g. a BYOA agent loop), so the same values can back both flows.
VariableDefaultDescription
NEN_API_KEY—Your Nen API key. Required for every command except --help.
NEN_API_URLhttps://desktop.api.getnen.aiDesktop API base URL. Override when pointing at a non-prod environment. The --api-url flag does the same for a single invocation.
export NEN_API_KEY="sk_nen_..."
Add export NEN_API_KEY="..." to your shell profile (~/.zshrc, ~/.bashrc) so it’s always available.

​
Next Steps

Desktop Commands

Create, list, and manage desktops

Quickstart

Create your first desktop and run an agent loop