@undisk-mcp/cli

@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.