vikunja-vja

Manage Vikunja tasks via the vja CLI with JSON output and jq filtering.

1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/akhy/agent-skills --skill vikunja-vja-akhy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: vikunja-vja
Source: https://github.com/akhy/agent-skills/tree/main/vikunja-vja
Command: npx skills add https://github.com/akhy/agent-skills --skill vikunja-vja-akhy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires vja, jq.

What problem does it solve? Managing tasks on a self-hosted Vikunja instance from the terminal requires knowing the vja CLI's flags, filter syntax, and output formats. This Skill provides the exact commands and workflows to create, list, update, and organize tasks without memorizing the CLI reference. ## Core Features & Use Cases - Full Task CRUD: Create, list, show, edit, delete, toggle, defer, and clone tasks with support for due dates, priorities, labels, assignees, reminders, and projects. - Structured Output: Every command uses --json piped to jq for compact, filtered, machine-readable results. - Workflow Recipes: Ready-made patterns for daily reviews, bulk-deferring overdue tasks, and creating assigned labeled tasks in one step. - Use Case: Ask the agent to list all overdue high-priority tasks, and it runs vja ls with the right filters and jq projection to return a clean summary. ## Quick Start Use the vikunja-vja skill to list my overdue open tasks with their titles and due dates.

Frequently Asked Questions about vikunja-vja

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

FAQPage Schema
How do I create a task in Vikunja from the command line?▼

Use vja add with the task title as a positional argument, plus flags like -d for due date, -p for priority, -l for labels, and -A for assignee. Natural language dates such as "tomorrow" or "next monday at 9:00" are supported.

How to filter Vikunja tasks by due date or priority with vja?▼

Use vja ls with --filter expressions such as "due_date before today" or "priority ge 3", and combine multiple --filter flags which are ANDed together. Append --json and pipe to jq to select only the fields you need.

What dependencies does the vja CLI workflow require?▼

The workflow requires the vja binary (installable via uv tool install vja) and jq for JSON processing. Configuration is read from ~/.config/vja/config.rc, which must point to your Vikunja instance.

Can I bulk-update overdue Vikunja tasks from the terminal?▼

Yes, list overdue open tasks with vja ls --filter, extract their IDs with jq, and pipe them to xargs running vja defer to shift due dates in bulk. The defer command also shifts associated reminders.

Why should I always append --json to vja commands?▼

The --json flag returns the Vikunja API's structured JSON instead of human-formatted text, making output reliable to parse and filter with jq. Use --jsonvja instead if you need vja's internal representation.