Nudocs

Upload documents to Nudocs.ai for rich editing, get shareable links, and pull back the results.

Setup

1. Install the CLI:

npm install -g @nutrient-sdk/nudocs-cli

1. Get your API key from https://nudocs.ai (click "Integration" after signing in)

2. Configure the key:

# Option 1: Environment variable
export NUDOCS_API_KEY="nudocs_your_key_here"

# Option 2: Config file
mkdir -p ~/.config/nudocs
echo "nudocs_your_key_here" > ~/.config/nudocs/api_key

Commands

nudocs upload <file>              # Upload and get edit link
nudocs list                       # List all documents
nudocs link [ulid]                # Get edit link (last upload if no ULID)
nudocs pull [ulid] [--format fmt] # Download document (default: docx)
nudocs delete <ulid>              # Delete a document
nudocs config                     # Show configuration

Workflow

Upload Flow

1. Create/write document content

2. Save as markdown (or other supported format)

3. Run: nudocs upload <file>

4. Share the returned edit link with user

Pull Flow

1. User requests document back

2. Run: nudocs pull [ulid] --format <fmt>

3. Read and present the downloaded file

Format Selection

See references/formats.md for full format support.

Natural Language Triggers

Recognize these user intents:

Upload/Send:

• "send to nudocs"

• "upload to nudocs"

• "open in nudocs"

• "edit this in nudocs"

• "let me edit this in nudocs"

• "put this in nudocs"

Pull/Fetch:

• "pull it back"

• "pull from nudocs"

• "get that doc"

• "fetch from nudocs"

• "download from nudocs"

• "grab the updated version"

• "what did I change"

• "get my edits"

Link:

• "get the nudocs link"

• "share link"

• "where's that doc"

• "nudocs url"

List:

• "show my nudocs"

• "list my documents"

• "what docs do I have"

• "my nudocs documents"

Document Best Practices

Before uploading, ensure good structure:

• Clear heading hierarchy (H1 → H2 → H3)

• Consistent spacing

• Appropriate list formatting

• Concise paragraphs (3-5 sentences)

See references/document-design.md for templates and guidelines.

Example Session

User: Write me a blog post about remote work and send it to Nudocs

Agent:

1. Writes blog-remote-work.md with proper structure

2. Runs: nudocs upload blog-remote-work.md

3. Returns: "Here's your Nudocs link: https://nudocs.ai/file/01ABC..."

User: *edits in Nudocs, adds formatting, images*
User: Pull that back

Agent:

1. Runs: nudocs pull --format docx

2. Reads the downloaded file

3. Returns: "Got your updated document! Here's what changed..."

Error Handling

Links

• CLI: https://github.com/PSPDFKit/nudocs-cli (@nutrient-sdk/nudocs-cli on npm)

• MCP Server: https://github.com/PSPDFKit/nudocs-mcp-server

• Nudocs: https://nudocs.ai