A comprehensive task and project management skill for interacting with self-hosted Vikunja instances via REST API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install vikunja-tasks
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install vikunja-tasks using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Vikunja Task Manager?
The Vikunja Task Manager skill provides a robust interface for AI agents to interact with the Vikunja productivity suite. It enables users to bridge their development environment with their personal task management system, facilitating seamless coordination between coding tasks and project deadlines. By integrating this into your library of Openclaw Skills, you can automate routine organizational tasks like checking due dates, creating reminders, and listing active projects directly from your agentic workflow.
This skill is designed for developers and power users who prefer self-hosted solutions and want to leverage the power of automation to maintain their productivity pipeline. It utilizes the Vikunja REST API to perform high-level operations, ensuring that your task data remains synchronized and accessible across your local and server-based environments.
Vikunja Task Manager Use Cases
- Tracking and completing development tasks without leaving the command line.
- Automating project creation for new repositories or client engagements.
- Monitoring overdue items and upcoming deadlines through centralized AI-driven notifications.
- Organizing shopping lists, reminders, and personal to-do items on a private, self-hosted server.
How Vikunja Task Manager Works
- The skill authenticates with your self-hosted Vikunja instance using a pre-configured API token and URL.
- Users provide natural language or structured commands to query tasks, filter by project, or update task statuses.
- The skill executes the corresponding REST API requests to fetch or modify data on the Vikunja server.
- Results are processed and returned to the agent, providing visibility into task details, priorities, and deadlines.
- Advanced monitoring logic can be applied to trigger automated alerts based on specific time intervals or task states.
Vikunja Task Manager Setup
To get started with this addition to your Openclaw Skills, set the following environment variables in your terminal or configuration file:
export VIKUNJA_URL="https://your-vikunja-instance.com"
export VIKUNJA_TOKEN="your-api-token"
To generate your API token, log into your Vikunja instance and navigate to Settings > API Tokens > Create token.
Vikunja Task Manager Data Schema & Taxonomy
The skill manages data across several key entities within the Vikunja ecosystem:
| Entity | Attributes |
|---|---|
| Tasks | ID, Title, Due Date, Priority (1-5), Project ID, Completion Status |
| Projects | ID, Title, Description |
| Notifications | Internal alert IDs and content strings |
| Filters | Standard Vikunja filter syntax for advanced task retrieval |
Note: All date-time operations are localized to the America/Denver timezone for consistent scheduling.
Vikunja Task Manager Advanced Features
- Support for clawdbot cron jobs to enable proactive task monitoring and delivery via Telegram or other messaging channels.
- Case-insensitive project searching to simplify command-line interactions.
- Deep integration with Vikunja filter syntax for complex, multi-variable task queries.
- Priority-based sorting and ordering for urgent task management.
- Capability to handle multi-agent sessions for collaborative task tracking.
SKILL.md
Loading
Related Openclaw Skills
Supernote Private Cloud Integration
Manage your self-hosted Supernote Private Cloud and instantly convert web content into e-reader-friendly documents.
reMarkable Cloud Integration
A specialized skill for sending web content and documents to reMarkable e-ink tablets via the cloud for distraction-free reading.
Readeck
An AI agent skill to automatically save URLs and articles to a self-hosted Readeck instance for organized reading and archival.
NocoDB
Manage NocoDB bases, tables, and records through a powerful REST API integration for AI agents.
Patiently AI
A specialized tool for converting technical clinical documentation into clear, personalized, and patient-friendly explanations.
MeatMarket
MeatMarket is a decentralized platform where AI agents hire, manage, and pay human workers for tasks requiring physical presence or human intuition.
Featured*
