Overview

Next

An AI‑assisted CLI that keeps growing collections of files tidy. Dorgy ingests, classifies, and organizes files on demand or continuously, preserves a reversible audit trail, and powers portable per‑collection semantic search.

What You Can Do

  • Organize folders: classify, rename, and move files safely with undo.
  • Watch directories: batch changes with debouncing and emit JSON for automation.
  • Search collections: substring and semantic queries using a local Chromadb index.
  • Move safely: rename/move tracked files while preserving history and search metadata.

Quick Start

dorgy --help
dorgy org ./documents --dry-run
dorgy watch ./inbox --json --once

See Getting Started → Quickstart and Configuration for more.

Before → After

Before (unorganized):

my_docs/
  IMG_0234.jpg
  Scan_001.pdf
  taxes.txt
  contract_final_FINAL.docx
  notes (1).txt
  2023-05-07 14.23.10.png
  invoice.pdf

After (organized with categories and dates):

my_docs/
  .dorgy/                     # state, history, search index, logs
  Documents/
    Contracts/
      Employment Agreement (2023-06-15).pdf
    Taxes/
      2023/
        Tax Notes.txt
  Photos/
    2023/05/
      2023-05-07 14-23-10.png
  Invoices/
    2023/
      ACME - April.pdf

Destinations vary by configuration and prompts. All changes are tracked in .dorgy/ so you can undo.

Features at a Glance

  • DSPy‑backed classification with heuristic fallbacks and vision captions (opt‑in by config).
  • Reversible operations with .dorgy/ state, history, quarantine, and needs‑review staging.
  • Per‑collection Chromadb search store under .dorgy/chroma + search.json manifest.
  • Shared CLI UX: quiet/summary/JSON modes and standardized error payloads.

Learn More

  • Getting Started: Installation, Quickstart, Configuration
  • Guides: Organize, Watch, Search, Move & Undo, Prompts & Vision, Troubleshooting
  • Reference: CLI, API, Config, On‑Disk Layout, JSON contracts
  • Explanations: Architecture, Design Choices, Search Architecture

If you’re contributing, see Development → Contributing and CI.

Installation