opencode-bar AGENTS.md

Important Restriction

• All of comments in code base, commit message, PR content and title should be written in English.
  • If you find any Korean text, please translate it to English.
• UI Language
  • All user-facing text in the app MUST be in English.
• Default review language: English.

Obey design decisions that specifically decided before by me

• All the decision is speicifed in @AGENTS-design-decisions.md file.

Coding Rules

Branding Guides

• Official Brand: OpenCode Bar
  • Don't use mis-capitalized or malformed forms like Opencode Bar or versions without the space (e.g. OpenCodeBar).
• File Name:
  • OpenCode Bar if it allows whitespace.
  • OpenCode-Bar if it allows dash.
  • opencode-bar (all lowercase) if the environment prefers lowercase file names.
  • opencodebar (all lowercase, no separators) if it doesn't allow whitespace or dashes.
• Bundle ID: com.copilotmonitor.CopilotMonitor

UI Styling Rules

• No colors for text emphasis: Do NOT use NSColor attributes like .foregroundColor for menu items or labels.
• DO NOT USE SPACES TO ALIGN TEXT: Don't use spaces like " Words:" to align the spacing.
• Use instead:
  • Bold: NSFont.boldSystemFont(ofSize:) for important text
  • Underline: .underlineStyle: NSUnderlineStyle.single.rawValue for critical warnings
  • SF Symbols: Use NSImage(systemSymbolName:accessibilityDescription:) for menu item icons
  • Emphasis: Use system colors like secondaryLabelColor and etc.
  • Offset: Use offset for aligning text with other items and lines. Use the below constants.
• Do NOT use:
  • Emoji: Never use emoji for menu item icons. Always use SF Symbols instead.
  • RGB color: Use only pre-defined colors by system (systemGreen, systemOrange, and etc) to consider dark/light mode compatiblity.
• Exception:
  • While you can't use color for text, progress bars and status indicators can use system color.
  • You can use color for text which is right-aligned text only.
• Others
  • Never use random spaces for separating label
    • BEST:
      • Left: "OpenRouter"
      • Right: "$37.42" - Additional Custom View Label on the right with right-aligned text (by offset calculating)
    • OK: "OpenRouter: $37.42"
    • OK: "OpenRouter ($37.42)"
    • NO: "OpenRouter $37.42" (stupid random spaces)
  • USD
    • Use only two decimals when expressing dollars. (e.g. $00.00)