CLI commands

Global flags

Flag	Description
`--help`	Show help for the current command
`--json`	Switch output from compact plain text to raw JSON
`--api-base-url <url>`	Override the API origin for this invocation

You can also run nylio help <command> to view help for any command:

nylio help documents edit

Auth

nylio login
nylio login --print-url
nylio auth status
nylio whoami
nylio logout

Workspaces

nylio workspaces list

Documents

Create a personal document. If you omit --title, the document defaults to “Untitled document”. You can pass the initial body as a positional argument, with --markdown, or piped through --stdin:

nylio documents create --title "Draft"
nylio documents create --title "Draft" --markdown "# Draft"
nylio documents create --title "Draft" "# Heading\n\nBody text"
cat body.md | nylio documents create --title "Draft" --stdin

List documents:

nylio documents list --limit 10
nylio documents list --workspace-scope personal
nylio documents list --workspace-slug my-workspace --limit 25

Fetch a document by id or Nylio URL:

nylio documents get doc_123
nylio documents get https://app.nylio.app/app/doc/doc_123

Apply one exact string replacement to a personal document. You can read either oldString or newString from stdin, but not both in the same call:

nylio documents edit doc_123 "Old heading" "New heading"
nylio documents edit --document doc_123 --old-string "Old heading" --new-string "New heading"
printf 'New heading' | nylio documents edit --document doc_123 --old-string "Old heading" --new-string-stdin
printf 'Old heading' | nylio documents edit --document doc_123 --old-string-stdin --new-string "New heading"

Preview a write without sending it:

nylio documents edit --document doc_123 --old-string "Old heading" --new-string "New heading" --dry-run

Replace the full enhanced markdown body:

nylio documents replace doc_123 "# New title"
nylio documents replace --document doc_123 --stdin < body.md
cat body.md | nylio documents replace --document doc_123 --stdin

Preview a full replace without sending it:

nylio documents replace --document doc_123 --stdin --dry-run < body.md

Export one document:

nylio documents export doc_123 --format markdown
nylio documents export doc_123 --format pdf --output ./draft.pdf
nylio documents export doc_123 --format docx

Search

nylio search "project plan"
nylio search "quarterly review" --workspace-slug my-workspace --limit 5

Write-safety rules

documents edit performs one replacement per call.
documents edit supports at most one stdin-backed field (--old-string-stdin or --new-string-stdin) per invocation.
Write commands are scoped to personal documents owned by the authenticated user.
documents replace expects Nylio enhanced markdown, not plain rich-text HTML.

Start Here

CLI

MCP

Format

API Reference

Global flags

Auth

Workspaces

Documents

Search

Write-safety rules

​Global flags

​Auth

​Workspaces

​Documents

​Search

​Write-safety rules

Global flags

Auth

Workspaces

Documents

Search

Write-safety rules