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