paperless
Interact with Paperless-NGX document management system via ppls CLI. Search, retrieve, upload, and organize documents.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Interact with Paperless-NGX document management system via ppls CLI. Search, retrieve, upload, and organize documents.
How to use
Zainstaluj narzędzie ppls za pomocą npm lub bun, uruchamiając polecenie npm install -g @nickchristensen/ppls. Upewnij się, że masz zainstalowany Node.js.
Skonfiguruj połączenie z serwerem Paperless-NGX, ustawiając nazwę hosta i token API. Uruchom ppls config set hostname http://twoj-serwer-paperless oraz ppls config set token twoj-token-api. Token znajdziesz w ustawieniach użytkownika w Paperless.
Wyszukaj dokumenty za pomocą filtrów — możesz szukać po nazwie (ppls documents list --name-contains "faktura" --json), dacie utworzenia (--created-after 2024-01-01), tagach (--tag 5) lub korespondentach (--correspondent 7). Połącz wiele filtrów w jedno polecenie, aby zawęzić wyniki.
Pobierz znalezione dokumenty, podając ich identyfikator — ppls documents download 1234 --output ~/Pobrane/dokument.pdf pobiera pojedynczy plik, a ppls documents download 1234 5678 --output-dir ~/Pobrane pobiera wiele plików naraz. Użyj flagi --original, aby pobrać wersję przed przetworzeniem.
Przesyłaj nowe dokumenty do archiwum poleceniem ppls documents add plik.pdf — Paperless automatycznie je przetworzy, wyodrębni tekst i przypisze metadane.