vikunja-fast

Vikunja Fast to umiejętność agenta, która łączy Twoje projekty i zadania z platformy Vikunja w jedno miejsce. Przeglądaj zadania zaplanowane na dziś, jutro i zaległe, oznaczaj je jako wykonane, oraz otrzymuj szybkie podsumowania — wszystko przez API Vikunja. Narzędzie wymaga dostępu do instancji Vikunja (własnej lub hostowanej) i uwierzytelnienia za pomocą tokenu JWT lub danych logowania. Idealnie sprawdza się dla użytkowników, którzy chcą zautomatyzować przepływ pracy z zarządzaniem zadaniami bez opuszczania agenta.

1. Upewnij się, że masz zainstalowany curl i jq — są to wymagane narzędzia do komunikacji z API Vikunja. Sprawdź ich dostępność w terminalu poleceniami curl --version i jq --version.

2. Zdobądź dostęp do instancji Vikunja (własnej lub publicznej) i zapamiętaj jej adres URL, np. https://vikunja.xyz. Jeśli posiadasz token JWT (zaczynający się od "eyJ"), przejdź do kroku 4. Jeśli masz tylko nazwę użytkownika i hasło, wykonaj login przez API: wyślij żądanie POST do VIKUNJA_URL/login z danymi logowania, aby otrzymać token JWT.

3. Skonfiguruj zmienne środowiskowe lub edytuj plik ~/.clawdbot/clawdbot.json. Dla zmiennych środowiskowych ustaw VIKUNJA_URL (adres instancji), VIKUNJA_TOKEN (token JWT) i opcjonalnie VIKUNJA_USERNAME oraz VIKUNJA_PASSWORD. Dla konfiguracji agenta dodaj wpis "vikunja-fast" w sekcji skills z tymi samymi zmiennymi w polu env.

4. Włącz umiejętność w konfiguracji agenta, ustawiając enabled: true dla wpisu vikunja-fast. Upewnij się, że VIKUNJA_URL wskazuje na poprawny adres — system automatycznie doda /api/v1 do zapytań.

5. Przetestuj połączenie, wysyłając żądanie GET do VIKUNJA_URL/user z nagłówkiem Authorization: Bearer TOKEN. Jeśli odpowiedź zawiera Twoje dane użytkownika, konfiguracja jest prawidłowa.

6. Używaj umiejętności do przeglądania projektów, filtrowania zadań (zaległe, dzisiejsze, jutrzejsze), oznaczania ich jako wykonane i otrzymywania podsumowań — wszystkie operacje odbywają się przez API Vikunja bez konieczności logowania się na stronie.