Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getnen.ai/llms.txt

Use this file to discover all available pages before exploring further.

Overview

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

Installation

The fastest way to install is with the install script — it detects your OS and architecture, verifies the checksum, and updates your shell profile automatically:
curl -fsSL https://releases.getnen.ai/install.sh | bash
This installs nen to ~/.nen/bin and adds it to your PATH via ~/.zshrc or ~/.bashrc. Restart your shell or run source ~/.zshrc (or ~/.bashrc) to pick it up. 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_KEYYour 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

nen quickstart

Interactive guided tour — run an agent in minutes

Desktop Commands

Create, list, and manage desktops