codemap_label_unassign

Remove label assignments. Supports wildcards and batch operations.

labelsunassignremovebatch

Parameters

NameTypeRequiredDescription
targetstring|array✅ RequiredTarget path(s) or glob patterns
labelIdstring|array❌ OptionalLabel ID(s) to remove (omit to remove all labels from target)

Usage Examples

MCP Usage (for AI Agents like Claude)

json
{
  "name": "codemap_label_unassign",
  "arguments": {
    "labelId": "lbl_work_in_progress_241291",
    "target": "src/features/complete-feature.ts"
  }
}

Example Output

JSON Response

json
{
  "ok": true,
  "unassigned": 2,
  "targets": [
    "src/components/Header.vue",
    "src/components/Footer.vue"
  ]
}
ℹ️When to Use This Tool
  • Remove labels when work is complete
  • Clean up incorrect label assignments
  • Clear all labels from deprecated files
  • Batch remove labels from completed features
💡Pro Tips
  • Omit labelId to remove ALL labels from target
  • Use wildcards for batch operations
  • Verify with label_search before unassigning
  • Unassign is idempotent - safe to run multiple times
💡Common Patterns
Feature complete: Remove WIP labels
Cleanup: Remove all labels from deprecated files
Reorganization: Remove old labels before reassigning new ones

Related Tools