Dokumentacja

Interfejs Wiersza Poleceń

Dokumentacja CLI

Automatyzacja plików wspierana przez AI z poziomu terminala. Zmieniaj nazwy tysięcy plików, wyodrębniaj dane z dokumentów i dziel pliki PDF za pomocą prostych poleceń.

Szybki Start

Wypróbuj natychmiast z npx — bez instalacji:

Terminal

$ npx @renamed-to/cli watch ~/Downloads --output-dir ~/Organized

Lub zainstaluj globalnie, aby uzyskać pełną funkcjonalność:

# Install with pnpm (recommended)
$ pnpm add -g @renamed-to/cli

# Then authenticate
$ renamed auth login

Polecenia

rename

Zmiana nazw plików wspierana przez AI

extract

Wyodrębnianie danych strukturalnych do JSON/CSV

pdf-split

Inteligentne dzielenie wielostronicowych plików PDF

watch

Monitorowanie katalogów i automatyczne przetwarzanie plików

service

Wdrożenie jako usługa systemd

auth

Zarządzanie uwierzytelnianiem

config

Zarządzanie plikami konfiguracyjnymi

doctor

Diagnostyka konfiguracji i łączności

Przykładowy Przepływ Pracy

Przetwarzaj katalog nieuporządkowanych dokumentów w zorganizowane, przeszukiwalne pliki:

# Podgląd zmian nazw
$ renamed rename ./documents/

# Zastosuj zmiany
$ renamed rename ./documents/ --apply

Analizowanie 47 plików...
✓ IMG_4521.pdf → 2026-01-15_AcmeCorp_Invoice.pdf
✓ scan0042.pdf → 2026-01-14_Receipt_Starbucks.pdf
✓ document.pdf → 2026-01-13_Contract_NDA_TechCorp.pdf
Gotowe! 47 plików zmienionych w 2,3s

Opcje Globalne

Te opcje działają ze wszystkimi poleceniami:

--json

Wyświetlanie wyników w formacie JSON do skryptów.

-q, --quiet

Ukryj wszystkie komunikaty oprócz błędów.

-y, --yes

Pomiń monity potwierdzenia.

--no-input

Wyłącz interaktywne monity. Przydatne w CI/CD.

--timeout <ms>

Limit czasu zapytań API w milisekundach.

--retry <n>

Liczba prób ponowienia dla nieudanych zapytań.

--on-conflict <strategy>

Sposób obsługi konfliktów nazw plików: fail, skip, suffix

-h, --help

Wyświetl pomoc dla polecenia.

Zmienne Środowiskowe

RENAMED_TOKEN — Token API do uwierzytelniania (alternatywa dla auth login)

RENAMED_CLIENT_ID — Niestandardowy identyfikator klienta OAuth dla firmowego SSO

RENAMED_CLIENT_SECRET — Niestandardowy sekret klienta OAuth dla firmowego SSO

RENAMED_JSON=1 — Włącz wyjście JSON (równoważne --json)

RENAMED_QUIET=1 — Włącz tryb cichy (równoważne --quiet)

CI=1 — Wykrywane automatycznie. Włącza --no-input i wyjście czytelne dla maszyn.

Obsługiwane Typy Plików

PDF, JPG, JPEG, PNG, TIFF — maksymalnie 25MB na plik.

Zasoby

Repozytorium GitHub Strona Prezentacji CLI