codemap_label_create

Create a new label with emoji, name, description, and optional colors

labelsorganizationmetadata

Parameters

NameTypeRequiredDescription
emojistring✅ RequiredSingle emoji character
namestring✅ RequiredDisplay name (spaces allowed, any length)
descriptionstring✅ RequiredFull description of the label's purpose
bgColorstring❌ OptionalBackground hex color (default: #4ECDC4)
fgColorstring❌ OptionalForeground hex color (default: #FFFFFF)

Usage Examples

MCP Usage (for AI Agents like Claude)

json
{
  "name": "codemap_label_create",
  "arguments": {
    "emoji": "🔒",
    "name": "Security",
    "description": "Security-critical code requiring extra review"
  }
}

Example Output

JSON Response

json
{
  "ok": true,
  "label": {
    "id": "lbl_security_009275",
    "emoji": "🔒",
    "name": "Security",
    "description": "Security-critical code requiring extra review",
    "bgColor": "#FF6B6B",
    "fgColor": "#FFFFFF",
    "createdAt": 1775428312956,
    "updatedAt": 1775428312956
  }
}

Tips & Best Practices

💡 Tips

  • Choose meaningful emojis for visual recognition at a glance
  • Use common, recognizable emojis (🔒 for security, ⚡ for performance)
  • Avoid obscure emojis that may not render well on all systems
  • Clear names like "Security Critical" not "Sec"
  • Use title case for consistency
  • Keep names under 30 characters when possible
  • Be descriptive but concise
  • Explain when and why the label should be used
  • Include examples of what should be labeled
  • Mention any team processes or workflows related to the label
  • Default colors work well for most cases
  • Use custom colors sparingly to avoid visual clutter
  • Maintain good contrast between background and foreground
  • Consider colorblind-friendly palettes for team environments
  • Start small - create labels as needs arise, don't over-engineer
  • Review labels quarterly to identify unused ones
  • Delete or archive labels that are no longer relevant
  • Document label meanings in team wiki or README
  • 🚧 Work In Progress
  • ✅ Complete
  • 🐛 Has Bug
  • 📝 Needs Docs
  • 🔒 Security Critical
  • ⚡ Performance Critical
  • 🔄 Refactor Needed
  • 🧪 Needs Tests
  • 🏗️ Infrastructure
  • 🔌 API
  • 🎨 UI Component
  • 📊 Data Model

Related Tools