Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    Local Task Tracker Vikunja

    2

    Manage your local Vikunja task tracker, projects, and Kanban boards via REST API and automated setup scripts.

    Free

    Security scanned

    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

    ActionResourceDetailsStatus
    Create ProjectAPI-RefactorID: 12Success
    Setup KanbanProject 12Columns: To-Do, In Progress, Review, DoneInitialized
    Create TaskReview auth middlewareID: 445, Priority: 5 (Highest)Success

    Next steps

    • Run list tasks to see the current state of the API-Refactor board.
    • Move task 445 to the 'Analyze' column once you start the investigation.
    • Use comment 445 to 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

    1. Environment Loading The agent sources credentials from a local .env file to authorize API requests.
    2. Resource Discovery It identifies existing projects or views to ensure tasks are placed in the correct context.
    3. Stateful Updates Before modifying a task, it fetches the current state to perform safe, non-destructive updates.
    4. 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. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 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

    Vikunja
    Python
    Docker
    Bash
    curl

    Permissions

    Terminal / Shell
    Read Files
    Environment Variables
    Write Files

    Allowed Hosts

    vikunja.local

    File Scopes

    ~/.local/share/vikunja-tasks/

    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.

    Listed4 days ago

    What's inside

    Frequently Asked Questions

    This skill manages your local Vikunja instance via its REST API, allowing your AI agent to create tasks, organize projects, and scaffold Kanban boards without you ever leaving your terminal or IDE. It eliminates manual context switching by turning your task tracker into a programmable part of your development workflow.

    You will need a local Vikunja instance running via Docker and a `.env` file containing your API credentials. The skill also includes a Python-based setup script that automatically initializes your Kanban structure, so you'll need a standard Python environment to run that component.

    Unlike generic prompts, this skill is pre-configured to handle Vikunja's specific API requirements, such as preserving state during updates and automating bucket creation. It prevents common errors like malformed JSON or missing headers that typically occur when an agent tries to 'guess' the API structure.

    Yes, the skill features a 'self-healing' mechanism that detects if your local Vikunja Docker container has stopped. It will attempt to restart the container automatically before retrying your request, ensuring your workflow isn't interrupted by service downtime.

    You receive the full integration logic for REST API communication, the automated Kanban scaffolding script, and documentation on configuring your environment variables. It is designed to work with any AI agent capable of executing local scripts and making HTTP requests.

    New in Agents & Orchestration