Tasks Integration

Overview

aimux integrates with Google Tasks to enable task-driven agent workflows. View your task lists, launch agents with task context, and track progress.

Setup

Configure the tasks backend in ~/.aimux/config.yaml:

tasks:
  backend: "auto"        # "auto", "mcp", or "api"
  default_list: ""       # default task list ID
  prompt_template: "Work on the following task: {title}\n\nDetails: {notes}\n\nAdditional instructions: {user_prompt}\n\nWhen done, summarize what you did."

Backends

Backend	Description
auto	Tries MCP first, falls back to Google Workspace API
mcp	Uses an MCP server endpoint for task operations
api	Uses Google Workspace API directly

Web Dashboard

Click the Tasks button in the header to open the tasks panel. Features:

• View task lists and tasks
• See task status (needs action / completed)
• Launch an agent directly from a task
• Complete or reopen tasks

Task-Driven Launch

1. Click “Launch” on a task in the tasks panel
2. Select provider, directory, and model
3. The task title and notes are injected into the agent prompt using the configured template
4. A “Session started by aimux” note is automatically added to the task

Prompt Template

Customize how task context is passed to agents:

tasks:
  prompt_template: "Task: {title}\n\nDetails:\n{notes}\n\nUser input: {user_prompt}"

Available placeholders:

Placeholder	Description
{title}	Task title
{notes}	Task notes/description
{user_prompt}	Additional user instructions from the launch dialog