confcli

Interact with Confluence Cloud from the command line. Use when reading, creating, updating, or searching Confluence pages, managing attachments, labels, comments, or exporting content.

1. Sprawdź, czy confcli jest zainstalowany, uruchamiając w terminalu polecenie command -v confcli. Jeśli narzędzie nie istnieje, zainstaluj je za pomocą skryptu instalacyjnego: curl -fsSL https://raw.githubusercontent.com/hochej/confcli/main/install.sh | sh. Możesz również określić wersję lub katalog instalacji, ustawiając zmienne VERSION lub INSTALL_DIR.
2. Skonfiguruj uwierzytelnienie, najpierw sprawdzając status: confcli auth status. Jeśli nie jesteś zalogowany, możesz uruchomić confcli auth login interaktywnie w swoim terminalu lub ustawić zmienne środowiskowe: CONFLUENCE_DOMAIN (np. yourcompany.atlassian.net), CONFLUENCE_EMAIL i CONFLUENCE_TOKEN. Token API możesz wygenerować na stronie https://id.atlassian.com/manage-profile/security/api-tokens.
3. Aby odczytać lub wyszukać strony, użyj poleceń takich jak confcli space list (lista przestrzeni) lub confcli space pages NAZWA_PRZESTRZENI --tree (hierarchia stron). Strony możesz referencjonować na trzy sposoby: po ID (np. 12345), pełnym URL lub notacji Przestrzeń:Tytuł (np. MFS:Overview).
4. Do tworzenia lub edycji stron użyj poleceń create i update. Przed wykonaniem operacji modyfikujących dane (tworzenie, usuwanie, dodawanie etykiet, przesyłanie załączników), upewnij się, że masz wyraźną intencję użytkownika — nigdy nie wykonuj tych czynności na podstawie założeń.
5. Aby bezpiecznie sprawdzić, co zrobi destrukcyjna operacja bez jej wykonania, dodaj flagę --dry-run do polecenia. To pozwala na podgląd zmian przed zatwierdzeniem.
6. Zarządzaj załącznikami, etykietami i komentarzami za pomocą dedykowanych poleceń (np. attachment upload/delete, label add/remove, comment add/delete), które są dostępne dla każdej strony lub przestrzeni.