@undisk-mcp/cli

Interactive CLI for Undisk MCP — undo-first versioned file storage for AI agents.

Every file mutation is versioned. Every write is undoable in under 50 ms.

Installation

# Run directly (no install)
npx @undisk-mcp/cli

# Or install globally
npm install -g @undisk-mcp/cli
undisk-mcp

Authentication

Set your API key as an environment variable:

export UNDISK_API_KEY=sk_live_your_key_here

Get your key at mcp.undisk.app/signup.

Optionally set a custom endpoint:

export UNDISK_ENDPOINT=https://mcp.undisk.app

Usage

$ undisk-mcp

  ⟲ UNDISK CLI — Undo-First Storage for AI Agents

  Every file mutation is versioned. Every write is undoable.
  Type 'help' for commands, 'tools' to list server tools.

undisk-mcp> write_file notes.md "# My Notes"
  → write_file({"path":"notes.md","content":"# My Notes"})
  ✓ Written — version 1 created
  SHA-256: a1b2c3d4e5f6...
  (42ms)

undisk-mcp> list_files
  → list_files({})
     notes.md  (11 bytes)
  (28ms)

undisk-mcp> list_versions notes.md
  → list_versions({"path":"notes.md"})
  v1  a1b2c3d4e5f6...  14:30:22
  (31ms)

Available Commands

File Operations

| Command | Description | |---------|-------------| | write_file <path> <content> | Create or overwrite a file | | read_file <path> | Read file content | | create_file <path> <content> | Create a file (fails if exists) | | append_log <path> <content> | Append without overwriting | | delete_file <path> | Soft-delete (restorable) | | move_file <from> <to> | Move or rename a file | | list_files [path] | List files in directory | | search_files <pattern> | Search file contents |

Version Control

| Command | Description | |---------|-------------| | list_versions <path> | Show version history | | list_changes [since] | Query all workspace changes | | get_diff <path> <v1> <v2> | Diff two versions | | restore_version <path> <vid> | Restore to a version | | workspace_checkpoint <action> [name] | Create/list/restore snapshots |

Workspace Admin

| Command | Description | |---------|-------------| | audit_trail [list\|export\|verify] | View audit log | | policy [read\|write] | Get or set workspace policy | | vault_secret <action> [name] [value] | Manage secrets | | share_with_public <action> [path] | Share files publicly | | workspace_collaborate <action> | Locks, notes, agents | | webhook <action> [url] | Manage webhooks | | federation <action> | Cross-workspace links |

Built-in

| Command | Description | |---------|-------------| | help | Show help | | tools | List server tools | | clear | Clear terminal | | exit / quit | Exit the CLI |

Publishing

cd workers/cli
npm run build
npm publish --access public

License

See LICENSE.md in the repository root.