vikunja-fast
Manage Vikunja projects and tasks (overdue/due/today), mark done, and get quick summaries via the Vikunja API.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Manage Vikunja projects and tasks (overdue/due/today), mark done, and get quick summaries via the Vikunja API.
How to use
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.
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.
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.
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ń.
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.
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.