codemap_checklist_list

View all checklist items. Optionally filter by trigger (session:start or session:close).

checklistworkflowsession

Usage Examples

MCP Usage (for AI Agents like Claude)

json

{
  "name": "codemap_checklist_list",
  "arguments": {}
}

Example Output

JSON Response

json

{
  "success": true,
  "checklists": [
    {
      "id": "session-start-default",
      "trigger": "session:start",
      "items": [
        {
          "id": "0",
          "text": "Review NEXT_SESSION.md for context from last session",
          "priority": "high"
        },
        {
          "id": "1",
          "text": "Pull latest changes from main branch",
          "priority": "high"
        }
      ]
    },
    {
      "id": "session:close-default",
      "trigger": "session:close",
      "items": [
        {
          "id": "0",
          "text": "Run npm test to verify all tests pass",
          "priority": "high"
        },
        {
          "id": "1",
          "text": "Update NEXT_SESSION.md if work incomplete",
          "priority": "high"
        },
        {
          "id": "2",
          "text": "Add notations to groups documenting patterns found",
          "priority": "medium"
        }
      ]
    }
  ],
  "count": 2,
  "totalItems": 5
}

ℹ️When to Use This Tool

codemap_checklist_list

Session planning - See what items will be shown at session start/close before beginning work
Before removing items - Always list to confirm item IDs before calling codemap_checklist_remove_item
Monthly reviews - Check which checklists are still relevant, identify stale items
Onboarding - Show new team members the established workflow processes
Debugging workflows - Verify checklist items match expected workflow gates

session:start

session:close

💡Common Patterns

List All Checklists

{
  "name": "codemap_checklist_list",
  "arguments": {}
}

Returns both session:start and session:close checklists.

Filter by Trigger

{
  "name": "codemap_checklist_list",
  "arguments": {
    "trigger": "session:close"
  }
}

Shows only the session close checklist (useful before running codemap_close).

Before Removing Items

// Step 1: List to see IDs
{
  "name": "codemap_checklist_list",
  "arguments": {
    "trigger": "session:close"
  }
}

// Response shows item IDs like "0", "1", "2"...
// Step 2: Remove specific item by ID

💡Pro Tips

Use itemId from list results - Item IDs in the output (like "id": "0") are what you pass to codemap_checklist_remove_item. Don't guess IDs.

Filter when focused - If you only care about session close items, use trigger: "session:close" to avoid noise from unrelated checklists.

Count matters - The totalItems field shows how many checklist items exist across all triggers. Keep this under 10 total to avoid checklist fatigue.

Review regularly - Run this monthly to identify items that are no longer relevant (automated elsewhere, workflow changed, tool deprecated).

✅Best Practices

List before removing - Always call codemap_checklist_list to confirm item IDs before using codemap_checklist_remove_item. Item IDs can shift when items are added/removed.
Check priorities - If you find yourself ignoring HIGH priority items, they should be demoted to MEDIUM or removed entirely. Priority inflation defeats the purpose of priorities.

⚠️Common Mistakes

❌ Mistake: Guessing item IDs when trying to remove an item
✅ Instead: Always call codemap_checklist_list first to see the current item IDs, then use those exact IDs with codemap_checklist_remove_item

❌ Mistake: Never reviewing checklists, letting stale items accumulate over months
✅ Instead: Run codemap_checklist_list monthly and remove items that are: (1) never actually done, (2) automated elsewhere (pre-commit hooks), or (3) no longer relevant to current workflow