- Home
- Skills
- Agents & Orchestration
- Local Task Tracker Vikunja
Works with the AI Agents you already use
Local Task Tracker Vikunja
Manage your local Vikunja task tracker, projects, and Kanban boards via REST API and automated setup scripts.
Free
Local Task Tracker Vikunja
Example session with this skill installed
Create a new project called 'API-Refactor' and add a high priority task to review the auth middleware.
- Read your context and instructions
- Compiled the local task tracker
I have created the new project and initialized the standard Kanban workflow. I also added your high-priority task to the new project.
Vikunja Task Update
| Action | Resource | Details | Status |
|---|---|---|---|
| Create Project | API-Refactor | ID: 12 | Success |
| Setup Kanban | Project 12 | Columns: To-Do, In Progress, Review, Done | Initialized |
| Create Task | Review auth middleware | ID: 445, Priority: 5 (Highest) | Success |
Next steps
- Run
list tasksto see the current state of the API-Refactor board. - Move task
445to the 'Analyze' column once you start the investigation. - Use
comment 445to attach logs or notes to the task.
Connects securely to your tools. The creator never sees your data.
About this skill
Context switching between coding and task management kills momentum. This skill allows your agent to manage your local Vikunja instance directly through its REST API, turning your task tracker into a native part of your development environment.
What it does
- Task Lifecycle Management Create, list, update, and close tasks with specific priorities, descriptions, and due dates.
- Project Organization Manage project lists and automatically initialize "Inbox" for unsorted items.
- Automated Kanban Setup Trigger a custom Python script to scaffold a full Kanban workflow including columns for Analysis, Review, and Trash.
- Labeling and Comments Categorize tasks with labels and append progress notes via the comments API.
- Self-Healing Connectivity Automatically detects if the local Vikunja Docker container is down and restarts it before retrying requests.
How it works
- Environment Loading The agent sources credentials from a local
.envfile to authorize API requests. - Resource Discovery It identifies existing projects or views to ensure tasks are placed in the correct context.
- Stateful Updates Before modifying a task, it fetches the current state to perform safe, non-destructive updates.
- Workflow Initialization Upon creating a new project, it executes a standardized setup script to build out the Kanban board.
Frameworks & tools
This skill interacts with a local Vikunja instance via curl and REST API calls. It manages Docker containers using docker compose and uses a Python-based setup script for workspace configuration.
Why this beats prompting it yourself
Prompting an agent to "use my API" often leads to malformed JSON or forgotten headers. This skill encodes the specific Vikunja API quirks, such as the requirement to send unchanged fields during updates and the automated initialization of Kanban buckets, ensuring your task board stays consistent without manual cleanup.
Use cases
- Add a task to the Inbox when a bug is discovered during a terminal session.
- Initialize a standardized Kanban board for a new microservice project.
- Close a task and leave a comment with a link to the relevant commit hash.
- List all high-priority open tasks across all projects to plan the workday.
Known limitations
Requires a local Vikunja instance running at a specific local URL. Relies on a specific file path for the environment variables and the Kanban setup script.
Requires local Vikunja at http://vikunja.local:7456 and Docker installed. Environment variables must be at ~/projects/vikunja/.env. Only supports REST API operations.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 4 days ago
- Free with an Agensi account
Requires
Permissions
Allowed Hosts
File Scopes
Everything runs on your own computer; nothing is sent to the cloud. On first use the skill offers to install a private task tracker (Vikunja) in Docker. Docker must be running before you start. On Windows, use WSL (Ubuntu) with Docker Desktop's WSL integration turned on; the installer is a bash script and won't run in plain PowerShell. Already have your own Vikunja? Skip the install: set VIKUNJA_URL and VIKUNJA_TOKEN and the skill uses it.