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