vikunja

Manage Vikunja tasks and projects via REST API with a CLI wrapper.

Updated Apr 16, 2025
One-click install
npx skills add https://github.com/aitorroma/hiveagilectl-web --skill vikunja-aitorroma
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vikunja
Source: https://github.com/aitorroma/hiveagilectl-web/tree/main
Command: npx skills add https://github.com/aitorroma/hiveagilectl-web --skill vikunja-aitorroma

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, curl, python3, and includes scripts (resource) components.

What problem does it solve?

Manage tasks and projects on a self-hosted Vikunja instance (PERSONAL/WORK). Use when the user wants to create, view, complete, or manage tasks, check what's due or overdue, list projects, or get notifications. Always register user-requested tasks in Vikunja for tracking and follow-up.

Core Features & Use Cases

  • Create, view, update, and complete tasks across PERSONAL and WORK using Vikunja REST API.
  • List projects and tasks with filters (project, assignee, due date, priority) and fetch overdue/due-today tasks.
  • Enforce a single source of truth by automatically registering user-requested tasks in Vikunja for tracking and follow-up.

Quick Start

Run a sample by creating a task in WORK and verify it appears in Vikunja.

Frequently Asked Questions about vikunja

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage self-hosted Vikunja tasks from the command line?

You can manage self-hosted Vikunja tasks using a CLI wrapper that calls the Vikunja REST API to create, retrieve, update, and delete tasks. It requires curl, jq, and python3 to handle API requests and parse responses.

Can I list overdue and due-today tasks in Vikunja via REST API?

Yes, you can list overdue and due-today tasks in Vikunja by applying REST API filters for due dates. The CLI wrapper fetches these tasks automatically, allowing you to check what requires immediate attention across your projects.

Does this task-management approach support separating personal and work projects?

Yes, this task-management approach explicitly supports separating personal and work projects. You can create, update, and complete tasks across distinct PERSONAL and WORK namespaces while maintaining a single source of truth for auditing.

What's the best way to automate project discovery and task assignments on a self-hosted instance?

The best way to automate project discovery and task assignments on a self-hosted instance is using a REST API CLI wrapper. It lists available projects and handles basic collaboration including task assignments and notifications.

Do I need curl and jq to interact with the Vikunja REST API for project management?

Yes, you need curl and jq along with python3 to interact with the Vikunja REST API for project management. These dependencies handle HTTP requests to standard REST endpoints and parse the returned JSON data.