Skip to content
TakoAPI
Back to skills

vikunja-kanban

by shad0wca7

Productivity & Tasks
774Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Manage a Vikunja kanban board via API.

Description

What This Skill Does

Manages a Vikunja kanban board through bash scripts and the Vikunja REST API. Supports reading board state, creating tasks, moving tasks between buckets, and marking tasks complete. Integrates with heartbeat monitoring and email triage workflows.

Uses a long-lived API token so other crons can call the scripts directly without handling JWT refresh or re-authentication.

When to Use It

  • Adding an incoming email action item to the Inbox bucket
  • Moving a task from Active Projects to Done after finishing work
  • Checking urgent tasks aging over an hour during a heartbeat run
  • Creating a high-priority infra task in the System Issues bucket
  • Filtering the board to see only tasks in a specific bucket

Example Workflow

INPUT

User asks: add a task to fix DNS records, high priority, urgent bucket

AGENT
  1. 1

    Identify target bucket ID (1 = Urgent)

  2. 2

    Run vikunja-add-task.sh with title 'Fix DNS', description 'Check records', bucket 1, priority 4

  3. 3

    API returns the created task ID

  4. 4

    Confirm task appears in the Urgent bucket by running vikunja-status.sh with filter 'Urgent'

OUTPUT

Task 'Fix DNS' created in the Urgent bucket with priority 4

Requirements

  • Self-hosted Vikunja instance
  • VIKUNJA_TOKEN API token generated in Vikunja with tasks and projects permissions
  • VIKUNJA_URL, VIKUNJA_PROJECT_ID, and VIKUNJA_VIEW_ID values for secrets/vikunja.env

Installation

clawhub install shad0wca7/vikunja-kanban

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links