CLI Overview

para-files commands organize around what you want to do.

Command Groups

Classification & Movement

  • classify - Determine category for files
  • move - Classify and move to PARA folders
  • scan - Preview classifications for a directory
  • learn - Interactive learning from files

Configuration & System

  • config - Show current configuration
  • init - Pre-create PARA folder structure
  • clean - Remove junk files

Reference Tree Management

Common Patterns

File Input

Most commands accept multiple files:

uv run para-files classify file1.pdf file2.docx file3.txt
uv run para-files move *.pdf

Output Formats

Get results as text or JSON:

uv run para-files classify file.pdf          # Human readable
uv run para-files classify file.pdf --json   # Machine readable

Verbosity

Add -v for detailed output:

uv run para-files classify file.pdf -v

Reference Tree

All commands can use a custom reference tree:

uv run para-files classify file.pdf -r custom_tree.yaml

Essential Commands

First time?

# Set up folder structure
uv run para-files init ~/Documents/PARA

Classify files:

# Single file
uv run para-files classify document.pdf

# Multiple files
uv run para-files classify *.pdf

# Preview results
uv run para-files classify *.pdf --json

Move files:

# Preview first
uv run para-files move *.pdf --dry-run

# Actually move
uv run para-files move *.pdf

Manage your categories:

# See all categories
uv run para-files routes

# Add a bank
uv run para-files add-issuer "My Bank" -c banques

# Add matching keywords
uv run para-files add-utterance factures-utilities "electricity bill"

Learn interactively:

# Improve matching for a file
uv run para-files learn misclassified_file.pdf

Global Options

All commands support:

  • -r, --reference-tree PATH - Use custom YAML reference tree
  • -v - Verbose output
  • --json - JSON output format

Help 

# Show all commands
uv run para-files --help

# Help for specific command
uv run para-files classify --help
uv run para-files move --help

Next Steps

  • Pick a command above and read its page for full details
  • Or jump to Task Guides for how-to walkthroughs