name: creating-tasks-through-lunatask description: Creates tasks in Lunatask for todos, reminders, deferred work, and handoffs. Use when the user wants to capture something for later, whether for themselves or for a future agent session. compatibility: Requires Lunatask MCP or CLI tools license: AGPL-3.0-or-later metadata: author: Amolith amolith@secluded.site
Tasks: Reminders, todos, bug reports, feature ideas. Self-contained; the note captures what and why for the user.
Handoffs: Work a future agent will pick up in a fresh context window. Requires careful framing so the receiving agent knows where to start and what we learned. See handoff.md before creating these.
If unclear which type, ask the user "is this a task or a handoff?"
Tone
Always include a warm, friendly, personal, and conversational note from you to the user. Address them by name if you know it. Otherwise, just start with a friendly greeting omitting their name. Task notes are exclusively a friendly note from you to the user, while handoffs also include a thorough prompt for another agent to pick up. See handoff.md#tone for more detail.
Formatting
Title
Titles must be clear:
- Useful and concise
- Conversational
- Include the project name
Examples:
Accept 'complete' as status alias in luneImplement ACP event sink in CrushInvestigate why lune habit track silently fails
Status
New tasks usually get status later.
Note structure
Tasks:
> [Friendly greeting], [context if helpful]
>
> [What needs doing and why]
>
> [Optional: relevant links, files, or commands if they'd help]
Handoffs:
> [Friendly greeting], [context if helpful]
>
> [What needs doing and why]
---
[See references/handoff.md for how to write this section]
References
Include relevant links when they'd help—issues, commits, docs, files. For handoffs, gather these proactively from previous messages; for tasks, include what's useful.
Appending to existing notes
Only append; never overwrite unless explicitly asked.
Lunatask only supports full replacement, so reproduce the original note verbatim, then add:
---
[New content here]
If lunatask or lune MCP tools are unavailable, see cli.md. If the CLI is also unavailable, see installing-lune.md.