TaskChute Plus

English | 日本語

📖 Documentation: https://obsidian.levers.co.jp/

Execute tasks, don't just organize them.

TaskChute Plus is an Obsidian plugin focused on execution-first task management: you decide what to do now, run it, and keep a reliable log of what actually happened.

What You Can Do

• Manage daily tasks in one TaskChute view with date navigation.
• Start/stop tasks and track actual execution time.
• Group tasks by configurable time slots plus a No time section.
• Create and run routines (daily, weekly, monthly patterns).
• Move, duplicate, reset, and delete task instances with day-state persistence.
• Link tasks to projects and open project board views.
• Review history from execution logs and yearly heatmap data.
• Set reminder times per task.
• Export tasks to Google Calendar URL scheme.
• Use Japanese/English UI (or follow Obsidian language).

Commands

Available from Obsidian Command Palette:

• Open TaskChute
• TaskChute settings
• Show today's tasks
• Reorganize idle tasks to current slot
• Duplicate selected task (when TaskChute view is active)
• Delete selected task (when TaskChute view is active)
• Reset selected task (when TaskChute view is active)

Getting Started

Install in Obsidian

1. Open Settings -> Community plugins.
2. Install/enable TaskChute Plus.
3. Run the command Open TaskChute.

First Task

You can create tasks from the TaskChute UI, or manually create a note in your task folder.

Minimal manual example:

---
tags:
  - task
target_date: "2026-04-16"
scheduled_time: "09:00"
---

# Online consultation

#task in note body is also supported for legacy compatibility.

Settings Overview

Open TaskChute settings to configure:

• Storage location mode (vaultRoot or specifiedFolder)
• Project folder path (optional, independent path)
• Review template path and filename pattern
• Language override (auto, en, ja)
• Reminder default minutes
• Backup interval/retention for execution snapshots
• Custom time-slot boundaries and collapsible slot UI
• Google Calendar export defaults

Current default values in code:

• backupIntervalHours: 2
• backupRetentionDays: 1
• defaultReminderMinutes: 5
• locationMode: vaultRoot

Default Paths

With default vaultRoot mode, TaskChute-managed folders are:

• TaskChute/Task
• TaskChute/Log
• TaskChute/Review

projectsFolder is intentionally unset by default and can be configured separately.

AI tasks (experimental, desktop only)

Run a task with an AI CLI (Claude Code or Codex) inside a real terminal embedded in the "AI runs" pane below the task list: the full interactive TUI renders there, the prompt from the task note is submitted automatically, and you can type into the session at any time — exactly as if you had launched the CLI in your own terminal.

• Enable it in TaskChute settings → AI task → Enable AI tasks. The feature is off by default and never activates on mobile.
• The plugin launches the CLIs you already have: Claude Code (claude) and/or Codex (codex) must be installed and authenticated separately by you. The plugin handles no API keys and makes no network calls itself.
• If auto-detection fails, set the absolute binary paths in the same settings section.

Mark a task note with frontmatter and add a ## Prompt section:

---
ai_task: true
ai_task_host: claude        # optional: claude (default) or codex
ai_task_cwd: Projects/demo  # optional: working directory (vault-relative or absolute)
ai_task_args: --max-turns 5 # optional: extra CLI arguments (string or list)
---

## Prompt

Summarize the open questions in this project and propose next steps.

The task row then shows a run button; while a run is active it becomes a stop control with a status chip. Each finished run is saved as a markdown log note (the terminal transcript, colors stripped) under TaskChute/AI/Logs/YYYY-MM/, and log notes older than Run log retention (days) (default 30) are moved to the trash automatically.

Run modes

• Terminal (interactive) — the default experience described above. In terminal mode the ## Prompt section is optional: without one, the CLI simply opens as a plain interactive session.
• Headless (parsed events) — the previous behavior, selectable via TaskChute settings → AI task → Run mode: the CLI runs non-interactively, parsed stream events render as text in the pane, and a composer bar sends resume-based follow-up prompts. Headless runs require a ## Prompt section.
• Windows runs terminal mode inside a Windows pseudo console (ConPTY) hosted by the built-in Windows PowerShell, so nothing extra has to be installed. It needs Windows 10 version 1809 or later. The first terminal run checks that the pseudo console works on the machine; where it cannot (an older build, or PowerShell locked down by policy), runs use headless mode instead and a notice says why. On Windows the pane does not offer plain shell sessions, and a terminal session ends when the CLI exits.

Task-note frontmatter is read-only for this feature: the plugin never edits your task notes.

Development

Requirements

• Node.js 18+
• npm

Setup

npm install

Scripts

npm run dev       # esbuild watch
npm run build     # production bundle
npm run lint      # eslint for src/tests
npm run test:unit        # jest (unit suites)
npm run test:integration # jest (*.integration.test.ts; spawns real processes)

Release Artifacts

Obsidian loads these files from the plugin root:

• main.js
• manifest.json
• styles.css

License

MIT

Author

Hiroya Iizuka