Przejdź do treści
Biblioteka skilli
Produktywność osobista · Automatyzacja

tasknotes

/tasknotes

Zarządza zadaniami w Obsidianie przez API wtyczki TaskNotes: tworzy je, zmienia status, filtruje i przegląda cały vault.

Repozytorium
claude-plugins ↗
Licencja
MIT
Ostatnia zmiana repozytorium
15.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 15.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/tasks.py

Co robi i kiedy

Zarządza zadaniami w Obsidianie przez API wtyczki TaskNotes: tworzy je, zmienia status, filtruje i przegląda cały vault.

Wyzwalacze z opisu

show my taskscreate a taskwhat should I work onmark as done
Oryginalny opis (EN)

Manages tasks in Obsidian via the TaskNotes Plugin HTTP API. Provides task creation, status updates, filtering by project or status, and vault-wide scanning. Triggers when the user asks to "show my tasks", "create a task", "what should I work on", "mark as done", or wants to filter tasks by status/project.

Jak działa

  1. Prerequisites
  2. CLI Commands
  3. Task Properties
  4. API Reference
  5. Usage Patterns
  6. Example Workflow
  7. Important Notes
Sekcje z nagłówków SKILL.md, w oryginale · 166 linii, 806 słów
Podgląd SKILL.md
---
name: tasknotes
description: Manages tasks in Obsidian via the TaskNotes Plugin HTTP API. Provides task creation, status updates, filtering by project or status, and vault-wide scanning. Triggers when the user asks to "show my tasks", "create a task", "what should I work on", "mark as done", or wants to filter tasks by status/project.
---

# TaskNotes Skill

Task management in Obsidian via the TaskNotes Plugin HTTP API.

<example>
User: "show my tasks"
Action: Execute `list --scan --table` to display all tasks in the vault
</example>

<example>
User: "create a task to finish the landing page"
Action: Execute `create "Finish landing page"`
</example>

<example>
User: "what should I work on?"
Action: Execute `list --status in-progress --scan --table` to show active tasks
</example>

<example>
User: "mark task X as done"
Action: Execute `update "Tasks/task-x.md" --status done`
</example>

## Prerequisites

1. **TaskNotes Plugin** installed in Obsidian
2. **HTTP API enabled** in TaskNotes settings:
   - Open Obsidian Settings → TaskNotes
   - Enable "HTTP API" toggle
   - Set API port (default: 8080)
   - API Token: leave empty for no authentication, or set a token for security
3. **Environment variables** in `.env` file at vault root (if authentication is used):
   ```
   TASKNOTES_API_PORT=8080
   TASKNOTES_API_KEY=your_token_here
   ```
   If TaskNotes has no auth token configured, no `.env` file is required.

## CLI Commands

The script is located at `${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py`.

```bash
# List all tasks (API-monitored folders only)
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py list

# Find all tasks in the ENTIRE vault (scans filesystem)
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py list --scan --table

# All active tasks (excluding completed) in the entire vault
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py list --scan --table

# ALL tasks including completed in the entire vault
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py list --all --table

# Filter by status (use your configured status values)
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py list --status "in-progress" --scan

# Filter by project
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py list --project "My Project" --scan

# Create a task
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py create "Task title" --project "My Project" --priority high

# Create a task with scheduled time
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py create "Meeting preparation" --scheduled "2025-01-15T14:00:00"

# Update task status
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py update "Tasks/task.md" --status done

# Add/update description
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py update "Tasks/task.md" --details "Additional context here."

# Delete a task
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py delete "Tasks/task.md"

# Retrieve available options (statuses, priorities, projects)
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py options --table

# Human-readable output (add --table)
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py list --table
```

## Task Properties

**Status and priority values:** Configured in TaskNotes plugin settings. Execute the `options` command to view available values:

```bash
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py options --table
```

**Additional fields:**
- `projects` - Array of project links, e.g., `["[[ProjectName]]"]`
- `contexts` - Array such as `["office", "energy-high"]`
- `due` - Due date (YYYY-MM-DD)
- `scheduled` - Scheduled date/time (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS)
- `timeEstimate` - Minutes (number)
- `tags` - Array of tags
- `details` - Task description (writes to Markdown body, not frontmatter)

## API Reference

Base URL: `http://localhost:8080/api`

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | /tasks | List tasks (supports filters) |
| POST | /tasks | Create task |
| GET | /tasks/{id} | Retrieve single task |
| PUT | /tasks/{id} | Update task |
| DELETE | /tasks/{id} | Delete task |
| GET | /filter-options | Available statuses, priorities, projects |

### Query Parameters for GET /tasks

- `status` - Filter by status
- `project` - Filter by project name
- `priority` - Filter by priority
- `tag` - Filter by tag
- `overdue` - true/false
- `sort` - Sort field
- `limit` - Maximum results
- `offset` - Pagination offset

## Usage Patterns

| User Request | Action |
|--------------|--------|
| "create a task for X" | Create task |
| "show my tasks" | list --scan --table (finds all tasks in vault) |
| "show in-progress tasks" | list --status in-progress --scan --table |
| "mark X as done" | Set task status to done |
| "what should I work on" | list --scan --table |

**IMPORTANT:** Always use `--scan` when listing to find ALL tasks in the entire vault, not just those in the configured TaskNotes folder.

## Example Workflow

```bash
# Morning: Check what to work on (all tasks in vault)
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py list --scan --table
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py list --status in-progress --scan --table

# Show top 5 tasks
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py list --scan --limit 5 --table

# Create a task with project association
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py create "Complete landing page" \
  --project "Website Redesign" \
  --priority high

# Complete a task
uv run ${CLAUDE_PLUGIN_ROOT}/skills/tasknotes/scripts/tasks.py update "Tasks/complete-landing-page.md" --status done
```

## Important Notes

- **JSON output** (default): Suitable for programmatic processing
- **Table output** (`--table`): For human-readable display
- **Vault path**: The script expects the `.env` file at the vault root or automatically locates the Obsidian vault
- **Error handling**: On connection errors, verify that Obsidian is running and the TaskNotes API is enabled
- **Scan mode** (`--scan`): Directly scans the filesystem and finds ALL tasks with the #task tag in the entire vault, regardless of the configured TaskNotes folder. **This is the recommended mode for listing tasks.**
- **API mode** (without `--scan`): Uses the TaskNotes HTTP API but only finds tasks in TaskNotes-monitored folders
Pliki w paczce (2)
  • SKILL.md 6 KB
  • scripts/tasks.py 17 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · talent-factory/claude-plugins100MIT
ArtemXTech/personal-os-skills100MIT

Migawka bazy z 13.11.2026 · wersja paczki a38b138f1386 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 86tasknotes-development
    Rozwija i weryfikuje TaskNotes w rdzeniu Rust, fixtures, wygenerowanych bindingach, serwerze synchronizacji oraz klientach macOS, Windows i React Native, przy pracy w packages/tasknotes-* i tasks-for-obsidian.
  • 100obsidian-tasks-plugin-workflow
    Śledzi, filtruje i planuje zadania z terminami i cyklicznością w Obsidian za pomocą wtyczki Tasks.
  • 100today
    Zbiera zadania z notatek, kalendarza, poczty, Linear i GitHuba i zapisuje priorytetowy plan dnia.
  • 100obsidian-cli
    Zarządza notatkami, zadaniami i właściwościami w Obsidianie przez Obsidian CLI oraz wspiera tworzenie wtyczek i motywów, w tym inspekcję DOM i przechwytywanie błędów.
  • 100pm
    Zarządza zadaniami i dokumentami w vaulcie Obsidian: dodaje zadania, tworzy dokumenty, archiwizuje, listuje zadania w toku, odświeża dashboard i dzieli specyfikacje na tickety.
  • 100obsidian-cli
    Integruje sejf Obsidian przez oficjalne CLI: zapisuje artefakty deweloperskie, przeszukuje sejf pod kątem kontekstu, dopisuje do notatki dziennej i zarządza zadaniami.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.