> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nylio.app/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI overview

> Install the Nylio CLI, authenticate with OAuth, and manage documents from your terminal.

The Nylio CLI is the fastest way to script against the public API without writing your own OAuth flow.

## Install

The published package is `nylio-cli` and the executable is `nylio`.

```bash theme={null}
npm install -g nylio-cli
nylio --help
```

## Requirements

* Node.js `>=22`
* A browser for the default login flow, unless you use `--print-url`

## Default behavior

* Production API base URL defaults to `https://api.nylio.app`
* Tokens are stored at `~/.config/nylio/auth.json`
* Login listens on `http://127.0.0.1:39123/callback`

## What the CLI can do

* Start and refresh OAuth sessions
* List accessible workspaces
* List, fetch, and create documents
* Apply a single string replacement to a personal document you own
* Replace a personal document body with full enhanced markdown
* Export documents to markdown, PDF, or DOCX
* Search documents

## Common commands

```bash theme={null}
nylio login
nylio auth status
nylio workspaces list
nylio documents list --limit 10
nylio documents get doc_123
nylio documents create --title "Draft"
nylio documents export doc_123 --format pdf --output ./draft.pdf
nylio search "project plan"
```

## Output modes

* Default output is compact plain text tuned for terminal and agent use
* Add `--json` for machine-readable JSON in scripts
* Add `--api-base-url <url>` to target a non-default environment