Task Manager

Overview

The Task Manager is Yukkai's built-in productivity system for creating, tracking, and completing tasks and projects. Instead of switching to a separate to-do app, you can manage everything through natural language directly in your Yukkai conversation.

Whether you're jotting down a quick reminder, planning a multi-step project, or checking what's overdue, the Task Manager understands plain English and handles the structure for you. Tasks can have priorities, due dates, statuses, and notes, and they can be grouped into projects with automatic progress tracking.

How it works

The Task Manager operates through a set of seven actions, all accessible via natural language:

Action	What it does
parse_intention	Parses a free-form goal in natural language and automatically creates tasks and/or projects. May ask a follow-up question to clarify.
list_tasks	Lists tasks filtered by status: active, today, overdue, blocked, or priority. Returns up to 10 by default.
complete_task	Marks a task as done and auto-updates the parent project's progress.
update_task	Updates any field on an existing task: title, status, priority, due date, or notes.
search	Full-text search across all tasks and projects.
view_project	Shows the details and progress of a specific project.
stats	Returns global counts, completion rate, and a breakdown by priority.

Task statuses

Every task moves through a lifecycle. The available statuses are:

• inbox — newly captured, not yet planned
• planned — scheduled or organised but not started
• inProgress — actively being worked on
• waiting — blocked by an external dependency
• done — completed
• cancelled — abandoned
• archived — finished and tucked away

Priorities

Tasks can be assigned one of five priority levels: critical, high, medium, low, or none.

How to use it

Creating tasks

The simplest way to create tasks is to just describe what you want to do in natural language. Yukkai will parse your intention, create the appropriate tasks, and optionally group them into a project.

"I want to launch my fitness app before summer."

Yukkai may respond with a follow-up question to clarify details before finalising the plan.

Listing tasks

You can ask to see your tasks filtered by context:

• "What are my active tasks?"
• "Show me what's overdue."
• "What do I need to do today?"

Completing tasks

When a task is done, just say so:

"Mark the 'Design landing page' task as complete."

Yukkai will update the task status and automatically recalculate the parent project's progress.

Updating tasks

You can change any field on an existing task:

"Change the due date for 'Write blog post' to next Friday and set it to high priority."

Searching

Use full-text search to find any task or project quickly:

"Search for tasks about 'API migration'."

Viewing project progress

When tasks are grouped into a project, you can ask for a project overview to see how far along things are:

"Show me the progress of my fitness app project."

Checking stats

Get a bird's-eye view of your workload:

"Give me my task stats."

This returns total counts, completion rate, and a priority breakdown.

Examples

Example 1 — Planning a product launch

"I need to launch my new coffee subscription box by March 1st. I'll need to finalise the branding, set up the Shopify store, create a marketing plan, and find a fulfilment partner."

Yukkai parses this into a project with four tasks, each with appropriate priorities and a shared deadline.

Example 2 — Daily review

"What's on my plate today?"

Yukkai lists all tasks due today or marked as high priority, giving you a focused starting point.

Example 3 — Quick capture

"Add a task to call the accountant next week."

Yukkai creates a single task with a due date approximately one week out.

Example 4 — Unblocking work

"The 'Deploy to staging' task is waiting on the DevOps team. Mark it as waiting and add a note that I emailed Sarah about it."

Yukkai updates the status and appends the note in one step.

Tips

• Prefer natural language. You don't need to memorise action names or parameters. Just describe what you want in plain English and Yukkai will figure out the right actions.
• Use projects for multi-step goals. When you describe a goal with several steps, Yukkai automatically groups them into a project with progress tracking. Completing individual tasks updates the project percentage automatically.
• Check for follow-up questions. After parse_intention runs, Yukkai may ask a clarifying question before finalising the plan. Always check the response before assuming the tasks are set.
• Use prefixes for IDs. When referring to a task or project by ID, you only need the first eight characters — Yukkai accepts prefixes.
• Review overdue tasks regularly. Ask "What's overdue?" at the start of your day to catch anything that slipped through the cracks.
• Leverage the waiting status. If a task is blocked by someone else, mark it as waiting so it doesn't clutter your active list but stays on your radar.
• Use stats for weekly reviews. The stats action gives you a quick snapshot of completion rate and priority distribution — perfect for a Friday afternoon review.