vikunja-fast

What This Skill Does

The Vikunja Fast skill integrates your OpenClaw agent with the Vikunja project management platform, acting as a high-speed interface for your task ecosystem. Instead of navigating web dashboards, you can query, filter, and complete tasks directly through your agent's command line or natural language interface. This skill focuses on efficiency, providing quick snapshots of your workload, specifically targeting overdue items and tasks due today. By utilizing the Vikunja API, it ensures that your task data remains synchronized as your single source of truth, while the integrated CLI helper simplifies complex API interactions into human-readable commands.

Installation

Installation is managed via the Clawhub CLI. Simply run: clawhub install openclaw/skills/skills/tmigone/vikunja-fast.

Once installed, you must configure authentication. You can either set system-wide environment variables (VIKUNJA_URL, VIKUNJA_TOKEN) or add them to your ~/.clawdbot/clawdbot.json file. The recommended method is using a JWT bearer token. If you have only a standard username and password, perform a POST request to the /login endpoint to obtain your JWT. Ensure your URL is correctly formatted; the system automatically normalizes base URLs to the /api/v1 path for seamless connectivity.

Use Cases

This skill is perfect for power users who maintain a rigorous task list in Vikunja but want to reduce "context switching" between their IDE or agent interface and the web browser. It is ideal for daily standups, where you can instantly retrieve tasks due today, or for project clean-up sessions where you want to blast through overdue items. It also serves developers who need to quickly verify task status or check off items without leaving their current terminal window.

Example Prompts

1. "Check my Vikunja tasks—what do I have marked as overdue that I need to address right now?"
2. "Show me all tasks due today across my projects and format them clearly."
3. "I just finished the documentation update; mark task ID 452 as done in Vikunja."

Tips & Limitations

To maximize effectiveness, ensure your project titles in Vikunja start with an emoji; the skill will intelligently use that emoji for status summaries, making lists much easier to scan. The skill relies on the /tasks/all endpoint, so be mindful if your project list is exceptionally large, as it fetches data across the entire account. If you experience authentication errors, check that your JWT hasn't expired; you can re-authenticate via the helper script if needed. Finally, always verify the filter syntax when using the advanced list --filter command, as it relies directly on the standard Vikunja query parameters.