Vikunja Fast for Openclaw

A streamlined interface to manage Vikunja tasks and projects using Openclaw Skills for automated workflows.

tmigone
v1.0.0
Jan 23, 2026
2
2.7k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install vikunja-fast

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install vikunja-fast 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 Fast?

Vikunja Fast is a specialized integration designed for Openclaw Skills that allows AI agents to interact directly with the Vikunja task management platform. It provides a robust bridge between your terminal and your project management database, enabling real-time updates and task tracking. By using this integration within the Openclaw Skills ecosystem, developers can maintain a single source of truth for their productivity without switching contexts between their IDE and project management tools.

The skill leverages the Vikunja API to perform high-speed queries and modifications, such as listing overdue tasks or marking items as complete. It is optimized for speed, utilizing lightweight shell scripts and standard utilities like curl and jq to ensure that your agent responds instantly to task-related queries.

Vikunja Fast Use Cases

  • Tracking overdue tasks across multiple projects using Openclaw Skills to stay on schedule.
  • Retrieving a daily summary of items due today for quick morning standups.
  • Filtering tasks using advanced syntax to identify high-priority development blockers.
  • Updating task statuses and marking projects as done directly through agent interactions.

How Vikunja Fast Works

  1. The skill establishes a secure connection to your Vikunja instance using a JWT bearer token or login credentials stored in Openclaw Skills environment variables.
  2. A dedicated shell helper script, vikunja.sh, processes commands and formats the requests for the Vikunja REST API.
  3. When a user requests task information, the skill fetches data from the /tasks/all endpoint and filters it based on parameters like due date or project ID.
  4. The output is parsed via jq to generate a clean, readable format that includes project-specific emojis and simplified date strings.
  5. Status updates are sent back to the API via POST requests to ensure the Vikunja database reflects the current state of work.

Vikunja Fast Setup

To integrate Vikunja Fast with Openclaw Skills, you can configure your environment variables or update your local config file. Set the required URL and token as follows:

export VIKUNJA_URL="https://vikunja.xyz"
export VIKUNJA_TOKEN="your_jwt_token"

For a permanent setup within Openclaw Skills, edit your ~/.clawdbot/clawdbot.json file:

{
  "skills": {
    "entries": {
      "vikunja-fast": {
        "enabled": true,
        "env": {
          "VIKUNJA_URL": "https://vikunja.xyz",
          "VIKUNJA_TOKEN": "<jwt>"
        }
      }
    }
  }
}

Vikunja Fast Data Schema & Taxonomy

Vikunja Fast organizes data for Openclaw Skills by mapping API responses into a human-readable table and list format. The primary data structure includes:

Attribute Description
Task ID Unique numerical identifier prefixed with #
Emoji Visual project indicator extracted from the project title
Due Date Normalized date format (Month/Day)
Status Boolean indicator of task completion
Filter Native Vikunja syntax strings for complex queries

Vikunja Fast Advanced Features

  • Support for complex Vikunja filter syntax to create highly specific task views within Openclaw Skills.
  • Automatic project-to-emoji mapping that dynamically assigns icons based on project naming conventions.
  • Multi-authentication support allowing for both long-lived JWTs and standard username/password login flows.
  • Cross-project task aggregation using the GET /tasks/all endpoint for global oversight.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*