Skip to content
AVAILABLE NOW IN SPACEWISE PRO·MODEL CONTEXT PROTOCOL

Storage intelligence for AI coding assistants.

Let Claude Code, Cursor, and Codex CLI check available disk space, evaluate build headroom, and stage cleanups with human approval in SpaceWise before a single byte is touched.

Client Setup
claude mcp add spacewise -- npx -y spacewise-mcp

Available now in SpaceWise Pro · Included in lifetime license ($7.99$3.99) · 100% local-first

VIDEO DEMO·HOW IT WORKS

Watch SpaceWise MCP in Action

See how AI coding agents query available disk headroom, run preflight capacity checks, and stage cleanups with mandatory desktop authorization.

How SpaceWise MCP Works
ZERO DIRECT DELETION · HUMAN GATEWAY

How agents interact with your machine safely.

Click a phase below to watch how the AI agent requests cleanups and how SpaceWise protects your disk.

Claude Code / Cursor Agent
stdio transport
$ claude "Can I safely run this 18 GB docker build?"
mcp.call("preflight_check", expectedBytes: 18 GB)
[Shortfall]: Needs 18 GB + 2 GB headroom. Current free: 14.2 GB.
Action: SpaceWise identifies 24.8 GB of reclaimable DerivedData & Docker cache.
Protocol: @modelcontextprotocol/sdk v1.32.10600 IPC Socket
SpaceWise Desktop · Human Gateway
Pro Verified
READ-ONLY PREFLIGHTNon-Destructive

SpaceWise verified live disk capacity for the agent without exposing any private filenames or personal documents.

Free Storage: 14.2 GBReclaimable: 24.8 GB
Audit Log: ~/.spacewise/mcp-audit.jsonlNo Cloud Sync
HOW IT WORKS

Safe by design at every step.

SpaceWise treats AI coding agents as intelligent draft creators, not root disk administrators.

APPROVAL GATE

Zero Direct Deletion

Agents can only propose cleanup plans. Destructive actions strictly require human approval in the desktop app.

Safety RuleHuman Confirmed
CONTAINMENT

Protected Projects

Your active workspace roots and current working directory are strictly protected. Neither files inside nor parent folders can be wiped.

Workspace IsolationBidirectional
CRASH PREVENTION

Active App Guard

Checks running processes before cleaning. If Xcode, Docker, or simulators are open, their caches are automatically skipped.

Process LivenessAuto-Skipped
RESTORE ROLLBACK

Recovery Bin Quarantine

Cleanups move items into the SpaceWise Recovery Bin and native OS Trash. No hard unlinking. Instant 1-click restore.

Undo Support100% Restorable
SANITIZATION

Prompt Injection Defense

Folder names and paths are stripped of ANSI escape codes, terminal control characters, and truncated to safe lengths.

Payload StrippingSanitized
LOCAL IPC

0600 Owner-Only Socket

Communicates over a local Unix domain socket or Windows Named Pipe with 256-bit unguessable tokens. Zero cloud telemetry.

Network Exposure0% Cloud
TOOL REGISTRY

The 6 tools exposed to your agent.

Typed Zod schemas with deterministic outputs, zero hallucinated paths, and live visual gateway feedback.

$ mcp.get_disk_status()
Macintosh HD (APFS)
Live Mount /
55.3 GB free of 228.3 GB76% used
Mount/ (Root)
Freshness14s ago
File SystemAPFS
Natural Language Agent Trigger:stdio transport
"How much free disk space do I have right now?"
Protocol: @modelcontextprotocol/sdk v1.32.10600 Owner IPC · No Cloud Sync
FREQUENTLY ASKED QUESTIONS

Everything you need to know

Clear answers about safety, privacy, containment, and agent execution.

Can an AI coding agent delete my project files or git repository?

No. SpaceWise uses bidirectional containment: workspace roots advertised by your IDE or CLI and your current working directory cannot be touched or traversed upward. Furthermore, agents can only draft dry-run plans; every cleanup requires your explicit approval in the desktop application.

Where do files go when a cleanup plan runs?

Files are evacuated to the SpaceWise Recovery Bin (~/.spacewise/recovery-bin/) and your native OS Trash. No permanent rm -rf is ever executed. You can restore any cleaned target with one click from the Activity tab.

What happens if an agent tries to execute a plan before I approve it?

The call immediately returns pending_approval without blocking or touching any file. SpaceWise fails closed; only plans explicitly approved by you inside the desktop app can be executed.

Does SpaceWise MCP send my files, filenames, or disk metrics to any cloud?

Never. SpaceWise MCP operates entirely on your local machine over an authenticated Unix domain socket (or Windows named pipe) with owner-only (0600) permissions. Zero external telemetry, zero network tracking.

How do I install and configure the MCP server?

For Claude Code, run: claude mcp add spacewise -- npx -y spacewise-mcp. For Cursor, add spacewise to ~/.cursor/mcp.json. For Codex CLI, add it to ~/.codex/config.toml. The bridge runs via npx with zero local build steps.

GET STARTED

Equip your AI assistants safely.

Give Claude Code, Cursor, and Codex CLI storage intelligence without risking your repositories or files.

Pay once, own forever · Up to 3 personal devices · 100% on-device