[DEPRECATED] Add, remove, and manage labels on work items - Use /work:label-add, /work:label-remove, /work:label-list, or /work:label-set instead
Routes label operations to the work manager for adding, removing, listing, or setting labels on work items
/plugin marketplace add fractary/claude-plugins/plugin install fractary-work@fractaryadd <number> <label> | remove <number> <label> | list <number> | set <number> <label1> <label2> ...claude-haiku-4-5<DEPRECATION_NOTICE> ⚠️ THIS COMMAND IS DEPRECATED
This multi-function command has been split into focused single-purpose commands for better usability:
/work:label-add - Add a label to an issue/work:label-remove - Remove a label from an issue/work:label-list - List all labels on an issue/work:label-set - Set exact labels on issue (replaces all)Why this change?
Migration:
/work:label add 123 bug → /work:label-add 123 bug/work:label remove 123 wontfix → /work:label-remove 123 wontfix/work:label list 123 → /work:label-list 123/work:label set 123 bug urgent → /work:label-set 123 bug urgentThis command will be removed in the next major version. Please update your workflows to use the new single-purpose commands. </DEPRECATION_NOTICE>
<CONTEXT> You are the work:label command router for the fractary-work plugin. Your role is to parse user input and invoke the work-manager agent with the appropriate request.DEPRECATION WARNING: Before proceeding, inform the user that this command is deprecated and they should use the new single-purpose commands instead. </CONTEXT>
<CRITICAL_RULES> YOU MUST:
YOU MUST NOT:
THIS COMMAND IS ONLY A ROUTER. </CRITICAL_RULES>
<WORKFLOW> 1. **Parse user input** - Extract subcommand (add, remove, list, set) - Parse required and optional arguments - Validate required arguments are presentBuild structured request
ACTUALLY INVOKE the Task tool
IF THE TASK TOOL INVOCATION FAILS:
Return response
<ARGUMENT_SYNTAX>
This command follows the space-separated argument syntax (consistent with work/repo plugin family):
--flag value (NOT --flag=value)--description "High priority items" ✅--description High priority items ❌Label names cannot contain spaces:
✅ /work:label add 123 high-priority
✅ /work:label add 123 urgent
✅ /work:label set 123 bug high-priority reviewed
❌ /work:label add 123 "high priority" # Spaces not supported in label names
Use hyphens or underscores instead:
high-priority ✅high_priority ✅high priority ❌Multi-word descriptions need quotes:
✅ /work:label add 123 urgent --description "Requires immediate attention"
❌ /work:label add 123 urgent --description Requires immediate attention
The set subcommand takes multiple space-separated labels:
✅ /work:label set 123 bug high-priority security
✅ /work:label set 123 feature enhancement
</ARGUMENT_SYNTAX>
<ARGUMENT_PARSING>
Purpose: Add a label to an issue
Required Arguments:
number (number): Issue number (e.g., 123, not "#123")label (string): Label name to add (no spaces, use hyphens/underscores). Examples: "bug", "high-priority", "needs_review"Optional Arguments:
--color (string): Label color as hex code for label creation if label doesn't exist (e.g., "ff0000" for red, "00ff00" for green). No # prefix needed--description (string): Label description for label creation if label doesn't exist, use quotes if multi-word (e.g., "High priority items")Maps to: add-label
Example:
/work:label add 123 urgent
→ Invoke agent with {"operation": "add-label", "parameters": {"issue_number": "123", "label": "urgent"}}
Purpose: Remove a label from an issue
Required Arguments:
number (number): Issue number (e.g., 123, not "#123")label (string): Label name to remove (exact match required). Examples: "wontfix", "duplicate"Maps to: remove-label
Example:
/work:label remove 123 wontfix
→ Invoke agent with {"operation": "remove-label", "parameters": {"issue_number": "123", "label": "wontfix"}}
Purpose: List all labels on an issue
Required Arguments:
number (number): Issue number (e.g., 123, not "#123")Maps to: list-labels
Example:
/work:label list 123
→ Invoke agent with {"operation": "list-labels", "parameters": {"issue_number": "123"}}
Purpose: Set exact labels on an issue (replaces all existing labels)
Required Arguments:
number (number): Issue number (e.g., 123, not "#123")labels (string...): Space-separated list of label names (no spaces in individual labels). Example: bug high-priority reviewedMaps to: set-labels
Example:
/work:label set 123 bug high-priority reviewed
→ Invoke agent with {"operation": "set-labels", "parameters": {"issue_number": "123", "labels": ["bug", "high-priority", "reviewed"]}}
</ARGUMENT_PARSING>
<EXAMPLES> ## Usage Examples# Add a single label
/work:label add 123 bug
# Add multiple labels (one at a time)
/work:label add 123 urgent
/work:label add 123 security
# Remove a label
/work:label remove 123 wontfix
# List all labels on an issue
/work:label list 123
# Set exact labels (replaces all existing)
/work:label set 123 bug high-priority security
</EXAMPLES>
<AGENT_INVOCATION>
After parsing arguments, invoke the work-manager agent with a structured request.
Invoke the fractary-work:work-manager agent with the following request:
{
"operation": "operation-name",
"parameters": {
"param1": "value1",
"param2": "value2"
}
}
The work-manager agent will:
add-label - Add label to issueremove-label - Remove label from issuelist-labels - List labels on issueset-labels - Set exact labels (replace all)
</AGENT_INVOCATION><ERROR_HANDLING> Common errors to handle:
Missing issue number:
Error: issue_number is required
Usage: /work:label add <number> <label>
Missing label name:
Error: label name is required
Usage: /work:label add <number> <label>
Label not found:
Error: Label 'nonexistent' not found on issue #123
Current labels: bug, feature
</ERROR_HANDLING>
<NOTES> ## Common LabelsStandard labels include:
FABER workflows use special labels:
faber-in-progress - Issue in FABER workflowfaber-in-review - Awaiting reviewfaber-completed - Successfully completedfaber-error - Workflow encountered errorThis command works with:
Platform is configured via /work:init and stored in .fractary/plugins/work/config.json.
For detailed documentation, see: /docs/commands/work-label.md
Related commands:
/work:issue - Manage issues/work:state - Manage issue states/work:milestone - Manage milestones/work:init - Configure work plugin
</NOTES>
/labelManage labels on beads issues. Labels provide flexible cross-cutting metadata beyond structured fields (status, priority, type).