vikunja

TotalClaw 作者 totalclaw

在自托管 Vikunja 实例上管理任务和项目。当用户想要创建、查看、完成或管理任务、检查到期或逾期的任务、列出项目或获取任务通知时使用。还可用于待办事项列表、提醒和任务跟踪。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~nickian-vikunja-tasks

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~nickian-vikunja-tasks/file -o nickian-vikunja-tasks.md

## 概述（中文）

在自托管 Vikunja 实例上管理任务和项目。当用户想要创建、查看、完成或管理任务、检查到期或逾期的任务、列出项目或获取任务通知时使用。还可用于待办事项列表、提醒和任务跟踪。

## 原文

# Vikunja Task Manager

Manage tasks and projects on a self-hosted Vikunja instance via REST API.

## Setup

Set these environment variables:

```bash
export VIKUNJA_URL="https://your-vikunja-instance.com"
export VIKUNJA_TOKEN="your-api-token"
```

Get your API token: Vikunja → Settings → API Tokens → Create token.

## Commands

### List tasks

```bash
{baseDir}/scripts/vikunja.sh tasks --count 10
{baseDir}/scripts/vikunja.sh tasks --project "Shopping" --count 5
{baseDir}/scripts/vikunja.sh tasks --search "groceries"
{baseDir}/scripts/vikunja.sh tasks --sort priority --order desc
```

### Overdue tasks

```bash
{baseDir}/scripts/vikunja.sh overdue
```

### Tasks due soon (next N hours)

```bash
{baseDir}/scripts/vikunja.sh due --hours 24
{baseDir}/scripts/vikunja.sh due --hours 48
```

### Create a task

```bash
{baseDir}/scripts/vikunja.sh create-task --project "Tasks" --title "Buy milk" --due "2026-02-01" --priority 3
```

Priority: 1 (low) to 5 (urgent). Due date format: YYYY-MM-DD.

### Complete a task

```bash
{baseDir}/scripts/vikunja.sh complete --id 123
```

### Get task details

```bash
{baseDir}/scripts/vikunja.sh task --id 123
```

### List projects

```bash
{baseDir}/scripts/vikunja.sh projects
```

### Create a project

```bash
{baseDir}/scripts/vikunja.sh create-project --title "New Project" --description "Optional description"
```

### Get notifications

```bash
{baseDir}/scripts/vikunja.sh notifications
```

## Due Date Monitoring

To get proactive notifications about due/overdue tasks, set up a cron job:

```bash
clawdbot cron add \
  --name "Task due check" \
  --cron "0 9,14 * * *" \
  --tz "America/Denver" \
  --session isolated \
  --message "Check Vikunja for overdue and upcoming tasks (next 24 hours). If any are found, notify me with the list." \
  --deliver \
  --channel telegram
```

## Notes

- Project names in `--project` are case-insensitive
- Filter expressions follow Vikunja filter syntax (see https://vikunja.io/docs/filters)
- All times are handled in America/Denver timezone