---
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](references/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](references/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 lune`
- `Implement ACP event sink in Crush`
- `Investigate why lune habit track silently fails`

### Status

New tasks usually get status `later`.

### Note structure

**Tasks:**

```markdown
> [Friendly greeting], [context if helpful]
>
> [What needs doing and why]
>
> [Optional: relevant links, files, or commands if they'd help]
```

**Handoffs:**

```markdown
> [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:

```markdown
---

[New content here]
```

---

If `lunatask` or `lune` MCP tools are unavailable, see [cli.md](references/cli.md). If the CLI is also unavailable, see [installing-lune.md](references/installing-lune.md).