Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Interact with Paperless-NGX document management system via ppls CLI. Search, retrieve, upload, and organize documents.
Interact with Paperless-NGX document management system via ppls CLI. Search, retrieve, upload, and organize documents.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Search and manage documents in Paperless-NGX using ppls.
npm install -g @nickchristensen/ppls ppls config set hostname http://your-paperless-host ppls config set token your-api-token
# By name ppls documents list --name-contains "invoice" --json # By date range ppls documents list --created-after 2024-01-01 --created-before 2024-12-31 --json # By tag (OR โ any of these tags) ppls documents list --tag 5 --tag 12 --json # By tag (AND โ must have all) ppls documents list --tag-all 5,12 --json # Exclude tags ppls documents list --tag-not 3 --json # By correspondent ppls documents list --correspondent 7 --json # By document type ppls documents list --document-type 2 --json # Documents missing metadata ppls documents list --no-correspondent --json ppls documents list --no-tag --json # Recently added/modified ppls documents list --added-after 2024-06-01 --json ppls documents list --modified-after 2024-06-01 --json # Combine filters ppls documents list --correspondent 7 --created-after 2024-01-01 --tag 5 --json
# Get full document details (includes OCR content) ppls documents show 1234 --json # Download single document ppls documents download 1234 --output ~/Downloads/doc.pdf # Download multiple documents ppls documents download 1234 5678 --output-dir ~/Downloads # Download original (pre-processed) version ppls documents download 1234 --original
# Simple upload (Paperless auto-processes) ppls documents add scan.pdf # With metadata ppls documents add receipt.pdf \ --title "Store Receipt" \ --correspondent 5 \ --document-type 2 \ --tag 10
# List tags/correspondents/document-types ppls tags list --json ppls correspondents list --json ppls document-types list --json # Create new ppls tags add "Tax 2024" --color "#ff0000" ppls correspondents add "New Vendor" ppls document-types add "Contract" # Update document metadata ppls documents update 1234 --title "New Title" --correspondent 5 --tag 10
Always use --json for AI/automation โ it's the most parseable format Date formats: YYYY-MM-DD or full ISO 8601 IDs are numeric โ use list --json commands to find them Filters are repeatable: --tag 1 --tag 2 or --tag 1,2 both work Pagination: Use --page and --page-size for large result sets
ppls on GitHub Paperless-NGX Docs
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.