Project Checklist

Manage a simple markdown checklist that Claude is reminded about at session start.

Current checklist: !

cat "${CLAUDE_PROJECT_DIR:-.}/.bluera/bluera-base/checklist.md" 2>/dev/null || echo "_No checklist exists yet. Use 'add' to create one._"

---

File Location

.bluera/bluera-base/checklist.md

- Committed to repo (shared with team)

File Format

Standard markdown with checkbox syntax:

# Project Checklist

## Category Name
[ ] Unchecked item
[x] Checked item

## Another Category
[ ] Another item

Subcommands

show (default)

Read and display the checklist. If no checklist exists, inform the user.

add <item>

Append a new unchecked item to the checklist:

1. If checklist doesn't exist, create it with a header
2. Append

   [ ] <item>

   to the end of the file
3. Display the updated checklist

check <item>

Mark an item as complete:

1. Read the checklist
2. Find the item (fuzzy match on text)
3. Change

   [ ]

   to

   [x]

   for that line
4. Display the updated checklist

If multiple items match, ask user to clarify.

edit

Tell the user the file path so they can edit directly:

Checklist location: .bluera/bluera-base/checklist.md

You can edit this file directly with any text editor.
Format: [ ] for unchecked, [x] for checked items.

Session Reminder

When a session starts, if the checklist has unchecked items, Claude receives a reminder in context showing the pending items. This happens automatically via the

checklist-remind.sh

hook.

Algorithm

1. Parse the subcommand from arguments
2. Execute the appropriate action:

   • show

     : Read and display

     .bluera/bluera-base/checklist.md

   • add

     : Append item, create file if needed

   • check

     : Find and mark item complete

   • edit

     : Display file path for manual editing
3. For

   add

   and

   check

   , show updated checklist after modification