CLI - Notte

AI agent instructions

Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

The Notte CLI gives you every Notte resource from the command line. Pair it with shell scripts, CI pipelines, or coding agents.

Installation

# Install script (macOS and Linux)
curl -fsSL https://notte.cc/install-cli.sh | sh

# Homebrew
brew tap nottelabs/notte-cli https://github.com/nottelabs/notte-cli.git
brew install notte

# Go
go install github.com/nottelabs/notte-cli/cmd/notte@latest

Verify the installation:

notte version

Authentication

The CLI reads your API key from, in order: the NOTTE_API_KEY environment variable, the system keyring (set by notte auth login), then ~/.notte/cli/config.json. See Authentication to get a key.

export NOTTE_API_KEY=your_api_key_here
# or, for local development
notte auth login

Commands

Auth

Manage authentication

Files

Manage stored files

Functions

Manage functions

Page

Execute page actions (syntactic sugar for sessions execute)

Payment

Request a temporary card for a browser session

Personas

Manage personas

Profiles

Manage browser profiles

Sessions

Manage browser sessions

Skill

Manage Notte skills for AI coding assistants

Tunnel

Route sessions through this machine’s internet connection

Usage

Show API usage statistics

Vaults

Manage vaults

Other commands

clear, health, search, version

Global flags

These flags work with every command.

Flag	Description
`--no-color`	Disable color output
`--output <string>`, `-o`	Output format (text, json) (default: `text`)
`--timeout <int>`	API request timeout in seconds (default: `60`)
`--verbose`, `-v`	Verbose output
`--yes`, `-y`	Skip confirmation prompts

JSON output

Commands that return data accept --output json (or -o json) for machine-readable output. Commands that wrap another tool, such as skill add, print that tool’s output as is:

notte sessions start -o json
notte functions list -o json

​Installation

​Authentication

​Commands

Auth

Files

Functions

Page

Payment

Personas

Profiles

Sessions

Skill

Tunnel

Usage

Vaults

Other commands

​Global flags

​JSON output

Installation

Authentication

Commands

Global flags

JSON output