Skip to content

Plugin Vision

Switch to Zen Mode

Plugins require:

  • Versioned API contracts
  • Error isolation between plugins
  • Dependency management
  • Documentation and community support

This complexity is beyond Mutsumi’s current scope (v0.4.0 beta). The design philosophy is: keep it minimal until the core is rock-solid.

Today, the “plugin” for Mutsumi is any program that writes JSON:

  • AI agents (Claude Code, Codex CLI, Gemini CLI)
  • Shell scripts
  • Cron jobs
  • Custom bots

The tasks.json file is the universal interface. No SDK required.

ConceptDescription
Custom view widgetsUser-defined Textual widgets loaded at runtime
Data transformersPlugins that pre-process tasks before rendering
Notification integrationsSlack, Discord, desktop notification plugins
Import/exportConvert to/from Todoist, Notion, Taskwarrior formats
Template tasksRecurring task templates (daily standup, sprint planning)

Any future plugin system must respect:

  1. No network calls — Plugins cannot phone home
  2. No arbitrary code execution — TOML/JSON config only, no eval
  3. Graceful degradation — Missing plugins don’t crash the app
  4. User data is sacred — Plugins cannot delete or corrupt tasks

Plugin system is planned for post-1.0 release. Focus for v1.0 remains on stabilizing core features.