AI Assistant Plugin for Super Productivity

May 8, 2026 · View on GitHub

An OpenAI-powered AI assistant plugin that lets you manage tasks, projects, and tags via natural language chat.

Features

🤖 Chat with AI to manage your tasks
📋 Create, update, delete, complete tasks — single or bulk
📁 Manage projects and tags
⏱️ Start/stop timers, set current task, plan for today
🏷️ Add/remove individual tags without replacing others
📊 Worklog reports: time per day/project/tag, estimate accuracy
🔄 Agentic tool calling — AI auto-executes operations (up to 5 rounds)
📝 Markdown rendering for AI responses (headers, tables, code blocks, lists)
⚙️ Configurable: API key, base URL, model, temperature

Installation

Download the latest ai-assistant-plugin.zip from Releases
Open Super Productivity → Settings → Plugins → Load unpacked
Select the zip file
Click the ⚙️ button in the plugin panel to configure your API key

Configuration

Click the ⚙️ button in the top-right corner of the plugin panel:

Field	Default	Description
API Key	(required)	Your OpenAI API key
Base URL	`https://api.openai.com/v1`	OpenAI-compatible endpoint
Model	`gpt-4o`	Model name
Max Tokens	`4096`	Max response tokens
Temperature	`0.7`	Response creativity (0-2)

Supports any OpenAI-compatible API (DeepSeek, Claude via proxy, local models, etc.)

Supported Operations

Category	Tools	Description
Tasks	`create_task`, `get_tasks`, `update_task`, `complete_task`, `delete_task`	Full CRUD with advanced filters (search, overdue, planned, recurring)
Bulk	`bulk_complete_tasks`, `bulk_update_tasks`	Batch operations, up to 100 tasks
Tags	`add_tag_to_task`, `remove_tag_from_task`	Add/remove single tags without replacing others
Subtasks	`create_task_with_subtasks`	Create parent + subtasks in one call
Planning	`plan_tasks_for_today`	Add/remove tasks from Today view
Timer	`get_current_task`, `start_task`, `stop_task`	Time tracking control
Reorder	`reorder_tasks`, `move_task_to_project`	Reorder tasks, move between projects
Worklog	`get_worklog`	Time reports by day/project/tag with estimate accuracy
Projects	`get_projects`, `create_project`, `update_project`	Project management
Tags	`get_tags`, `create_tag`, `update_tag`	Tag management
Context	`set_active_work_context`	Switch active project/tag view
UI	`show_notification`	Show snackbar notifications

Task Filters (`get_tasks`)

Filter	Description
`project_id`	Filter by project
`tag_id`	Filter by tag
`search_query`	Case-insensitive title/notes search
`parents_only`	Exclude subtasks
`overdue`	Due date before today
`unscheduled`	No due date set
`planned_for_today`	Planned for today
`recurring_only`	Only recurring tasks

Development

├── manifest.json        # Plugin metadata
├── plugin.js            # Background: register buttons/shortcuts
├── index.html           # Chat UI + OpenAI integration (all inline)
└── icon.svg             # Plugin icon

Build / Package

cd ~/server/ai-assistant-plugin && python3 -c "
import zipfile
with zipfile.ZipFile('ai-assistant-plugin.zip', 'w', zipfile.ZIP_DEFLATED) as zf:
    for f in ['manifest.json', 'plugin.js', 'index.html', 'icon.svg']:
        zf.write(f, f)
        print(f'  added: {f}')
"

Output: ai-assistant-plugin.zip in the project root.

Requirements

Super Productivity v13.0.0+
OpenAI-compatible API key

License

MIT