MichaelVessia

paperless

Search and manage documents in Paperless-ngx document management system. Use when the user asks about documents, invoices, receipts, tax forms, bills, or wants to search their document library.

MichaelVessia 2 Updated 3mo ago
GitHub

Install

npx skillscat add michaelvessia/nixos-config/paperless

Install via the SkillsCat registry.

SKILL.md

Paperless-ngx

Interact with Paperless-ngx document management system via CLI.

Setup

Environment: ~/.secrets.env (PAPERLESS_URL, PAPERLESS_TOKEN) - loaded by
wrapper.

CLI Discovery

Run paperless-cli --help to see available commands. Run
paperless-cli <command> --help for detailed usage of any command.

Capabilities

The CLI supports:

  • Search: Full-text search with filters (date ranges, tags, correspondents)
  • Browse: List recent documents, inbox items
  • Read: Get document details and extracted text content
  • Organize: Add/remove tags, edit metadata (title, correspondent, type)
  • Find related: Discover similar documents
  • Download: Save original files locally
  • Metadata: List tags, correspondents, document types, stats

Workflow

  1. Search or list to find documents
  2. Get document by ID to read full content
  3. Add/remove tags to organize
  4. Find similar documents for related items
  5. Download originals when needed

Notes

  • Flags must come BEFORE positional arguments
  • Document IDs are integers returned from search/list results