For agent fleets · MCP-first · Reversible

Your agent can clean the disk. It cannot delete.

Point Claude Code, Codex, or Cursor at Sort over MCP. Read tools scan and draft the exact plan — free, and they mutate nothing. Execution needs a human-approved, checksum-bound plan, quarantines instead of deleting, and rolls back byte-verified. An agent acting on its own cannot authorize a run.

Free to plan. Paid to execute. The undo is the product. Team and fleet pricing: contact us — pilot installs available.

The loop

18 default L0 tools — 85 tools total across 13 discovery packs

  1. doctor — sort_doctor verifies the loopback daemon, CLI binary, skill, and delete-guard hook in one call.
  2. scan — read-only inventory of a folder or drive. Nothing moves.
  3. census / sitrep — where the bytes are, by class, with honest coverage flags.
  4. suggest — advisory structure draft from your own folders. Never authorizes a move.
  5. plan — the exact move list: action count, bytes, plan checksum.
  6. simulate — dry-run the plan against the live tree.
  7. execute_request / execute_status — queues the simulated plan for your one-click approval in the Desktop Approvals desk. Quarantine, never delete. Signed journal.
  8. rollback — restore every move, byte-verified against the journal.

67 more tools ship across 13 on-demand discovery packs (sort_discover → sort_enable) in v2.5.0. Start with the 18 L0 tools.

Why not raw bash

Why not just ask Claude to rm -rf ~/.cache?

Deleting a package cache works once. After that, raw shell commands burn minutes in find/du, break project paths, forget what they moved yesterday, or delete uncommitted work. Sort gives your agents the five capabilities raw shell prompts cannot replicate:

1. Zero-break duplicate reclaim

Duplicate .gguf/.safetensors weights and build trees are reclaimed via hardlink replacement (with APFS clone detection so already-shared extents aren't re-copied) — freeing gigabytes while keeping both file paths alive in place.

2. 7 ms file & move memory

Indexed sort_locate answers in milliseconds without walking the drive, and the append-only move ledger tracks old path → new path so agents never hit FileNotFoundError in the next chat.

3. Structure & estate organizer

Drafts SUGGESTED_STRUCTURE.md / STRUCTURE.md across 10 estate zones (~/Downloads, ~/Workspace, ~/Staging/ideas), watches folders with Keep Organized, and holds ambiguous files for your call.

4. BLAKE3-verified cold offload

When the remaining 200 GB is cold projects or media you cannot delete, Sort copies to an external SSD or SSH host, verifies BLAKE3 digests, and evicts locally only after cryptographic proof.

Why fleets use it

Recovery, not promises

Mistakes become undoable

Model weights, build caches, old worktrees — agents find the dupes, Sort quarantines them with a receipt. Wrong call? Rollback restores the exact bytes.

Humans keep the trigger

Execute requires your click in the Mac Approval Desk (or a plan-bound acknowledgement). An agent acting on its own cannot self-approve a run.

Protected classes never move

Dirty git worktrees, keys, certificates, git internals, and Rekordbox/Pioneer device libraries are inventoried as sacred and blocked at plan time and again at write time.

Local-first, offline licence

No accounts, no telemetry or background phone-home (network is used only for license activation or opt-in update checks). The licence checks locally with Ed25519. Normal scan, plan, and execute send nothing anywhere.

Honest limit: Sort makes file actions taken through Sort recoverable and auditable, and ships a PreToolUse delete-guard hook for raw rm -rf. For full deny-by-default Seatbelt gating of all agent tool calls, pair Sort with Deponent.
Install

Five minutes to first plan

# 1. Unzip the agent kit, then point your MCP client at the launcher:
{
  "mcpServers": {
    "archivist-sort": {
      "command": "/path/to/archivist-sort-agent-kit/bin/archivist-sort-mcp"
    }
  }
}

# 2. Ask your agent: "Scan ~/Downloads with Sort and draft a plan. Do not execute."
# 3. Read the plan. Approve in the desktop app or CLI. Execute is licensed ($29 once).

Verify every artifact before you run it — checksums and Gatekeeper commands on the download page. Apple silicon, macOS 11+.

Pilots

Want the full Sovereign Agent Workstation installed on your machine?

Sovereign Agent Safety & Organization Install — $500, 2 hours. We install the 6-layer governed workstation stack (Archivist Sort + cds-find 20 ms search + Deponent tool gate + Fleet Watch collision guard + Sworn commit gate + didlie / honest-meter / claimcheck), map your workspace zones, execute one approved quarantine, roll it back, and hand you the signed receipt bundle. Book by email.