Kaiten Time Logger for VS Code

🚀 Логирование времени в Kaiten прямо из VS Code после коммита

Расширение для VS Code, которое автоматически (или вручную) открывает модальное окно для логирования времени в Kaiten после выполнения git коммита.

📋 Особенности

• ✅ Автоматическое определение карточки из названия ветки (поддерживает форматы: feat/DEV-12345, DEV-12345, bugfix/DEV-12345_description и др.)
• ✅ Просмотр уже залогированного времени по карточке
• ✅ Выбор роли из списка доступных ролей (с запоминанием последней выбранной)
• ✅ Информация о текущем пользователе (имя, email, роль, часовой пояс)
• ✅ Статистика времени за сегодня (общее время и разбивка по карточкам)
• ✅ Автоматическое открытие после коммита (опционально)
• ✅ Сохранение настроек (токен, базовый URL, последняя роль)
• ✅ Поддержка времени в минутах и часах

🚀 Установка

Из VSIX файла

1. Скачайте файл kaiten-time-logger-0.0.1.vsix
2. В VS Code нажмите Cmd/Ctrl+Shift+P
3. Выберите Extensions: Install from VSIX...
4. Укажите путь к скачанному файлу

Из исходников

git clone https://github.com/yourusername/kaiten-time-logger.git
cd kaiten-time-logger
bun add -d @vscode/vsce
bun run build
code --install-extension *.vsix

🎯 Использование

Первоначальная настройка

При первом запуске расширение запросит:

1. Базовый URL вашего Kaiten пространства
2. API токен (как получить см. ниже)

Команды

Модальное окно

После вызова команды открывается окно с полями:

• ID карточки - автоматически определяется из названия ветки (если включено)
• Затраченное время - можно выбрать минуты или часы
• Дата выполнения - по умолчанию сегодня
• Роль - выпадающий список из ваших ролей в Kaiten
• Комментарий - описание выполненной работы (опционально)

Отображение уже залогированного времени

Если ID карточки определен (автоматически или вручную), расширение покажет:

• Общее время по карточке
• Разбивку по дням с комментариями

⚙️ Настройки

Расширение добавляет следующие настройки в VS Code:

{
  "kaitenTimeLogger.baseUrl": "https://your-space.kaiten.ru",
  "kaitenTimeLogger.apiToken": "your-api-token",
  "kaitenTimeLogger.lastSelectedRole": -1,
  "kaitenTimeLogger.autoOpenAfterCommit": false,
  "kaitenTimeLogger.autoDetectCardFromBranch": true
}

🔑 Как получить API токен Kaiten

1. Зайдите в ваш Kaiten
2. Перейдите в Настройки (Settings)
3. Найдите раздел API Токены (API Tokens)
4. Создайте новый токен с правами:
   • Чтение информации о пользователе
   • Создание временных логов
   • Чтение ролей
5. Скопируйте полученный токен

🌿 Поддерживаемые форматы веток

Расширение умеет определять ID карточки из следующих форматов:

• feat/DEV-12345
• DEV-12345
• bugfix/DEV-12345_description
• feature/TASK-123
• release/DEV-123
• hotfix/DEV-123
• Любые другие форматы с числами (опционально)

🛠 Разработка

# Клонирование репозитория
git clone https://github.com/yourusername/kaiten-time-logger.git
cd kaiten-time-logger

# Установка зависимостей
bun install

# Запуск в режиме отладки
F5

# Сборка расширения
bun run build

# Установка собранного расширения
code --install-extension *.vsix

📁 Структура проекта

kaiten-time-logger/
├── src/
│   ├── apiClient.js       # API запросы к Kaiten
│   ├── branchParser.js    # Парсинг названий веток
│   ├── modalView.js       # Модальное окно
│   ├── settingsManager.js # Управление настройками
│   └── timeTracker.js     # Трекинг времени
├── extension.js           # Главный файл расширения
├── package.json          # Конфигурация расширения
├── LICENSE.md            # Лицензия
└── README.md             # Документация

📝 Лицензия

Распространяется под лицензией MIT. См. файл LICENSE для подробностей.

🙏 Благодарности

• Kaiten API за отличную документацию

📧 Контакты

• Автор: Pavel Kononov
• Email: depik400@yandex.ru
• GitHub: https://github.com/depik400

⭐ Поставьте звезду проекту, если он вам помог!