🕐 Koku - Time Display

Precise time moments in your VS Code status bar with global timezone support.

⏰ Real-time clock in your status bar | 🌍 Global timezone support | ⚡ Lightweight & fast

✨ Features

• 🕐 Real-time clock display in VS Code status bar
• 🌍 Timezone offset support - configure any timezone from UTC-23 to UTC+23
• 🎨 Clean HH:MM format - no distracting seconds
• 💡 Smart tooltips - hover to see timezone information
• ⚡ Performance optimized - updates every second for accuracy
• 🎛️ Toggle on/off - show/hide clock via command palette
• 🎌 Japanese-inspired - "Koku" (刻) represents precise time moments

🚀 Usage

Installation

1. Install the extension
2. The clock automatically appears in your status bar (right side)

Configuration

1. Open VS Code Settings (Ctrl+, / Cmd+,)
2. Search for "koku"
3. Set Koku: Time Offset to your desired timezone offset

Examples:

• 0 - UTC (Coordinated Universal Time)
• 9 - JST (Japan Standard Time)
• -5 - EST (Eastern Standard Time)
• -8 - PST (Pacific Standard Time)
• 1 - CET (Central European Time)

Toggle Display

• Use Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
• Search for "Toggle Clock Display"

🛠️ Development

This project uses Dev Containers for a consistent development environment.

Dev Container Setup

1. Install VS Code Dev Container extension
2. Open this folder in VS Code
3. Run "Dev Containers: Reopen in Container" from Command Palette

Manual Setup

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Watch mode compilation
npm run watch

🔧 Debug

1. Press F5 or run "Run Extension" from Debug view
2. A new VS Code window opens with the extension loaded
3. Check the status bar for the clock display

📦 Build

npm run compile

📄 License

MIT License