TaskMate

by まさし
5
4
3
2
1
Score: 44/100

Description

A simple local-first Todoist-style task manager for Obsidian with a companion Agent Skill

Reviews

No reviews yet.

Stats

1
stars
45
downloads
0
forks
17
days
1
days
9
days
57
total PRs
0
open PRs
1
closed PRs
56
merged PRs
77
total issues
27
open issues
50
closed issues
240
commits

Latest Version

10 days ago

Changelog

TaskMate 0.8.0

TaskMate 0.8.0 lets a Task carry a hard deadline separate from the day you plan to work on it, an optional time, and a repeat rule. Deletions now ask in an Obsidian dialog and follow Obsidian's Deleted files setting, and reordering a long Manual list scrolls when you drag to its edge.

Required actions

  • Update the plugin: if you installed TaskMate from the Community directory, use Settings → Community plugins → Check for updates. If you installed it manually, back up the vault, disable TaskMate, and replace main.js, manifest.json, and styles.css together with the files from this Release; do not mix assets from different versions.
  • Task Pilot users: update the skills/taskpilot folder too, so Task Pilot reads and writes deadline, time, and repeat.
  • Check your Deleted files setting: deleting a Task now follows Settings → Files and links → Deleted files. If it is set to permanent deletion (or to the system trash on Android, where no system trash exists), deleted Task files cannot be restored.

Known issues

  • iOS and iPadOS behavior has not yet been verified.
  • Local reminders for timed Tasks are not included. #123

Highlights

  • Deadlines separate from scheduled dates. A Task can have a scheduled date (when you plan to work on it) and an independent deadline. Rescheduling changes only the date, and a missed deadline stays marked Deadline passed until the Task is completed. #113
  • Timed and recurring Tasks. Add a local time and a repeat rule (daily, weekly, monthly, yearly, or every N days, weeks, months, or years). Completing a recurring Task moves it to its next occurrence, shifts its deadline by the same amount, and reopens its Steps. Date sort lists untimed Tasks first on each day, then by time. #114
  • Safer deletion. Deleting a Task, selected Tasks, a label, or a project, and rejecting a Proposal, ask in an Obsidian dialog with Cancel focused. Deleted Task files follow Obsidian's Deleted files setting instead of always going to the system trash. #126

Improvements

  • Dragging a Task to the top or bottom edge of a long Manual-order list scrolls the list, keeps the scroll position after the drop, and returns a Task released outside the list to where it was. #112
  • On iPhone and iPad, the Enter that confirms Japanese (or other IME) input in the Label field no longer adds the label before you finish typing. Not yet verified on a device. #126

Fixes

  • On phones, the Apply and Cancel buttons of the import confirmation stay above Obsidian's mobile toolbar. #116, #132

Compatibility and upgrade notes

No manual migration is required. deadline, time, and repeat are optional; existing Task files without them stay valid and are read as unset. Saving an existing Task in 0.8.0 adds a deadline: null line.

If you go back to 0.7.x, it keeps these properties as unknown properties, but it does not understand them: completing a recurring Task there completes it instead of moving it to the next occurrence.

The minimum supported Obsidian version remains 1.8.7. TaskMate remains compatible with desktop and mobile Obsidian and uses only public Obsidian and browser APIs.

Documentation

  • The README leads with installing from the Obsidian Community directory. #111
  • The README and guides say that Obsidian Sync users must turn on Sync all other types for reviews to reach another device. #115, #132

For contributors

  • Desktop E2E tests run the built plugin in a sandboxed Obsidian, share helpers, cover schedule, styling, and deletion regressions, and refuse to open a real Vault. #124, #126, #127
  • npm run lint mirrors the Community directory scorecard and runs in CI. #127, #128
  • Release assets carry GitHub build provenance attestations. #118

Full changelog

https://github.com/tempu-village/taskmate/compare/0.7.2...0.8.0

README file from

Github

TaskMate

English | 日本語

TaskMate is a simple, local-first task manager for Obsidian users who want a focused Todoist-style task list without leaving their vault. Every task and project stays in readable Markdown that you own.

TaskMate also includes Task Pilot, an optional AI agent skill. It turns notes you select into task suggestions and plans, and changes no task until you approve them in a TaskMate review.

TaskMate task list in Obsidian, showing Overdue, Today and Later sections with priorities, projects and labels

Why TaskMate

  • Use the same task interface in desktop and mobile Obsidian.
  • Reorder tasks manually without losing that order in other built-in views.
  • Keep tasks inspectable, portable, and editable as Markdown.
  • Use the plugin without creating a TaskMate account or hosted database.
  • Review AI-generated proposals before they become canonical tasks.

Install

TaskMate is listed in the Obsidian Community directory. Desktop and Android Obsidian are verified; iOS has not yet been verified.

  1. In Obsidian, open Settings → Community plugins and select Browse. Turn on community plugins first if Obsidian asks.
  2. Search for TaskMate, select Install, and then select Enable.

You can also open the TaskMate listing and select Add to Obsidian. To update, select Check for updates under Settings → Community plugins.

Install manually from a GitHub Release

Use this method when the Community directory is not available to you.

  1. Open the TaskMate Releases page and download these three assets from the same version:

    main.js
    manifest.json
    styles.css
    
  2. Create <vault>/.obsidian/plugins/taskmate/ and place the three files directly inside it.

  3. Restart Obsidian and enable TaskMate under Settings → Community plugins.

To update a manual installation, back up the vault, disable TaskMate, replace all three files with assets from one newer Release, and enable TaskMate again. Do not mix files from different versions.

To run an unpublished build, see Install a development build.

Quick start

For a guided first exercise, see Your first TaskMate task. Goal-specific instructions are in user guides.

  1. Install and enable TaskMate.
  2. Open the command palette and run TaskMate: Open task list.
  3. Select + Add, enter a title, and save the task.
  4. Use the Date screen to view Scheduled, All, or No date tasks. Use Adjust to filter or select the current list.
  5. Select Settings → TaskMate → Language to choose Auto, English, or 日本語.

The language change updates TaskMate views and settings immediately. Reload the plugin to update command names and the ribbon tooltip.

Current features

  • Three focused destinations: Date, Search, and Projects
  • Scheduled, All, and No date views, with overdue, today, and later sections in Scheduled
  • An Adjust menu that filters the current list and provides explicit task selection
  • Single-task deletion in the editor and bulk editing or deletion from selection mode
  • Search with up to 10 recent search terms
  • Markdown-backed projects with five recent projects, rename, and safe deletion
  • Priority 1–3 and up to 500 labels, with an indexed label picker, inline favorites, and filters for priority, label, and completion state
  • One-tap Today, Tomorrow, 7 days later, and No date suggestions
  • Compact ordered Steps with completion controls, optional dates, drag reordering, and a focused editor
  • Up to 10 favorite and 10 non-duplicate recently saved label suggestions
  • One global manual drag order plus date, priority, and creation sorting
  • Auto, English, and 日本語 language settings with English fallback
  • Desktop and mobile Obsidian support
  • One readable Markdown file per task with a stable ID in frontmatter
  • Explicit AI source folders with per-note include and exclude overrides
  • Staged proposal review before an agent may create, merge, or exclude an action

Install and use Task Pilot

Task Pilot is optional; the plugin works without it. Task Pilot runs in an Agent Skills-compatible AI client, such as Codex, with your vault open as its workspace. It reads only the notes you select, saves its suggestions as a review or a plan in the vault, and never changes a task by itself: every change waits until you approve it in TaskMate.

An Import review in TaskMate: each candidate Task shows its date, priority, project and Steps, the source note it came from, and Create, Hold and Edit controls

To install it, copy the skills/taskpilot folder from this repository into your client's skills folder, for example ~/.agents/skills/taskpilot.

You do not need to name Task Pilot. Ask for what you want in everyday words:

Plan my TaskMate tasks for this week.

To name it explicitly, or for a specific operation, start with $taskpilot:

$taskpilot Review the selected source notes and stage every Task candidate for review in TaskMate.
$taskpilot Review my stale Tasks and propose safe date, Priority, and Context-label changes.
$taskpilot I have two hours. What can I do now?
$taskpilot Find work for a 30-minute phone-only break.

Task Pilot saves one review file in the proposal folder, opens it in TaskMate, and creates no Task at this stage; you can also run TaskMate: Open reviews, which lists every pending review. Each candidate is a card that quotes its source sentences. Edit a card when needed, choose to create, merge, exclude, or hold it, and then select Apply decisions…. TaskMate changes no Task before you confirm, asks for an extra confirmation for merges whose diff you did not open, and records the import on a source note once all of its candidates are applied. Completed reviews move to TaskMate/Proposals/History and remain there until you delete them. See Review source notes and create Tasks for the full steps.

Backlog changes are also shown before writing. A plan is always a rolling plan saved under TaskMate/Plans. A free-time Task suggestion is read-only, writes no file, uses a visible 20% default buffer and upper effort estimates, and never adds Task statuses or changes Manual order. A request that asks for a plan, such as “Plan today”, always gets a rolling plan; Task Pilot asks once only when a request names neither a plan nor free time. “Do later” removes the date instead of adding a Pending or Waiting state.

Change the proposal location under Settings → TaskMate → Proposal folder when needed. The proposal folder is an approval boundary, not a security sandbox, and does not expand the source-note allowlist.

If you use Obsidian Sync, turn on Settings → Sync → Selective sync → Sync all other types on every device. Reviews are JSON files in the proposal folder, and Obsidian Sync skips JSON files unless that option is on, so a review created on your computer would never reach your phone.

Select notes for Task Pilot

Run TaskMate: Include current folder as an AI source, or add one vault-relative folder per line under Settings → TaskMate → AI source folders.

Individual notes can override their folder rule:

taskmate-source: true  # include this note anywhere
taskmate-source: false # exclude this note from an included folder

Processed source notes receive taskmate-import-* provenance properties. A content hash lets Task Pilot detect a later edit without treating its own metadata as a user change.

Storage, privacy, and permissions

  • Tasks are stored under TaskMate/Tasks by default.
  • Projects are stored under TaskMate/Projects by default.
  • Reviews are stored under TaskMate/Proposals by default, and completed reviews under its History folder.
  • Folder locations can be changed in TaskMate settings.
  • The plugin uses Obsidian's vault and file-management APIs to read and write TaskMate-managed Markdown.
  • The plugin contains no telemetry, hosted TaskMate account, runtime AI, translation service, or TaskMate synchronization server.
  • The plugin does not send task content to an external translation service.
  • Task Pilot runs with the permissions of the agent client and is separate from the Obsidian plugin.
  • Uninstalling the plugin leaves tasks, projects, and review files in the vault.

Review these claims against the release build before public release. Back up the vault and understand the synchronization provider's conflict behavior before using TaskMate with important data.

Known limitations

  • Calendar, Kanban, recurrence, and reminders are not included in the current release.
  • TaskMate does not provide its own free synchronization service.
  • Simultaneous offline edits on multiple devices may be handled as conflicts by the vault synchronization provider.
  • The Android workflow has been tested; iOS has not yet been tested.
  • Command names and the ribbon tooltip require a plugin reload after changing the TaskMate language.

Troubleshooting

See Troubleshooting for recovery guidance. When reporting a bug, include the TaskMate version, Obsidian version, operating system, reproduction steps, and a sanitized example task when relevant. Do not publish private vault content.

Development

Contributors start at CONTRIBUTING. To build and run an unpublished version, including the Obsidian Sync procedure for desktop and Android, see Install a development build.

Translation workflow

English is the canonical source and fallback for TaskMate UI and user documentation.

  1. Finalize changes in src/i18n/en.ts and English documentation.
  2. Update src/i18n/ja.ts and Japanese documentation in the same change.
  3. Check catalog keys, placeholders, Markdown structure, protected literals, and links.
  4. Keep AI-created or AI-updated translations marked ai-translated.
  5. Change the status to human-reviewed only after a person compares the complete current English and Japanese content.
  6. Check both languages in real desktop and mobile Obsidian before release.

Do not add a feature specification only to Japanese. Update English first, then translate it. Keep code, commands, paths, property names, IDs, and URLs unchanged unless the localized UI intentionally uses a translated command label.

Verification

npm run typecheck
npm test
npm run build
python3 -m unittest discover -s skills/taskpilot/tests -v
python3 scripts/validate_skills.py
npm run validate:localization
python3 scripts/validate_docs.py
npm run validate:release
git diff --check

The generated main.js is a build artifact. Do not edit it by hand.

Maintainers should follow the bilingual release procedure to update synchronized version metadata, create an exact version tag, and verify the generated GitHub Release. See the documentation index for the complete document map.

License

TaskMate is available under the MIT License.

Copyright (c) 2026 Masashi (Tempu Village)

Official Obsidian documentation