Установка на Windows

Поставьте CLI-плагин PanDev Metrics на Windows примерно за 3 минуты. После этого активность вашего терминала (имя команды + timestamp) появится в дашбордах PanDev Metrics.

Перед началом

• Windows 10 или 11 с PowerShell (5.1 или новее, предустановлен)
• Учётка PanDev Metrics
• Ваш API-токен — откройте веб-приложение PanDev Metrics, перейдите в Settings → Plugins → CLI и скопируйте значение из шага Введите ваш токен. Токен начинается с pandev_. Он уже несёт в себе ваш воркспейс и сервер, больше ничего настраивать не нужно.

Шаг 1 — Установите плагин

Откройте PowerShell от имени администратора (правый клик по PowerShell → Запуск от имени администратора) и выполните:

iwr -useb https://raw.githubusercontent.com/pandev-metriks/pandev-cli/main/install.ps1 | iex

Скрипт скачивает бинарник CLI, добавляет его в PATH и регистрирует фоновый демон, чтобы он запускался вместе с сессией.

примечание

Скрипт установки нужно запускать из PowerShell с правами администратора — он регистрирует фоновый демон на системном уровне.

Если скрипт заблокирован

PowerShell может блокировать удалённые скрипты в зависимости от execution policy. Разрешите их для текущей сессии и выполните команду снова:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned

Это действует только на текущее окно PowerShell — общесистемную политику не меняет.

Шаг 2 — Авторизуйтесь

Войдите по API-токену:

pandev login -t <YOUR_TOKEN_HERE>

Замените <YOUR_TOKEN_HERE> на токен, скопированный из веб-приложения. Токен хранится локально, демон сам переподключается после рестартов.

Шаг 3 — Проверьте

Убедитесь, что демон работает и авторизован:

pandev status

Проверьте, что heartbeat'ы накапливаются:

pandev time

Можно также открыть Settings → Plugin → CLI plugin в веб-приложении PanDev Metrics — ваша машина должна появиться там со свежим временем heartbeat.

Полезные команды

pandev --help                 # Список всех команд плагина
pandev status                 # Состояние демона и авторизации
pandev time                   # Активность CLI за сегодня
pandev login -t <TOKEN>       # Переавторизация с новым токеном

Обновление

Запустите скрипт установки повторно из PowerShell с правами администратора, чтобы подтянуть свежую версию:

iwr -useb https://raw.githubusercontent.com/pandev-metriks/pandev-cli/main/install.ps1 | iex

Удаление

Удаление — два действия и проверка. Порядок важен: первое действие выполняет сама команда pandev, а после второго её на машине уже не будет.

1. Уберите хуки из профилей shell

pandev uninstall-hooks

Команда вычищает блоки PanDev из профиля PowerShell ($PROFILE) и из ~/.bashrc Git Bash. Windows не даёт пакету выполнить собственный код в момент удаления, поэтому сделать это нужно заранее.

2. Удалите пакет

В обычном окне PowerShell — права администратора не нужны:

Get-AppxPackage PandevInc.PandevCLIPlugin | Remove-AppxPackage

То же самое через интерфейс Windows: Параметры → Приложения → Установленные приложения (в Windows 10 — Приложения и возможности), найдите PanDev CLI Plugin и нажмите Удалить.

Вместе с пакетом Windows убирает команду pandev, фоновый демон с его автозапуском и локальные данные плагина: сохранённый токен, логи и очередь ещё не отправленных событий.

3. Проверьте результат

В том же окне PowerShell:

if (Get-AppxPackage PandevInc.PandevCLIPlugin) { 'PanDev CLI is still installed' } else { 'PanDev CLI removed' }

Ответ PanDev CLI removed означает, что пакет удалён. Команда pandev после этого больше не находится — так и должно быть.

Полная очистка: сертификат издателя и политика PowerShell

После удаления пакета на машине остаются две настройки, сделанные при установке. Работе системы они не мешают, убирать их необязательно.

Сертификат издателя. Windows ставит пакеты не из Microsoft Store только от издателя, которому доверяет машина, поэтому установщик добавил сертификат PanDev в хранилище Доверенные лица локального компьютера. Чтобы убрать его, откройте PowerShell от имени администратора и выполните:

Get-ChildItem Cert:\LocalMachine\TrustedPeople | Where-Object Subject -like 'CN=PanDev*' | Remove-Item

Политика выполнения скриптов. Чтобы хук в профиле PowerShell загружался, при первом pandev login для вашего пользователя была выставлена политика RemoteSigned. Вернуть значение по умолчанию:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Undefined

Если RemoteSigned вы задавали сами или политика нужна другим инструментам, этот шаг пропустите.

Troubleshooting

iwr ... | iex падает с ошибкой выполнения скрипта

Execution policy PowerShell блокирует удалённые скрипты. Разрешите их для текущей сессии и повторите установку:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned

pandev: command not found после установки

Установщик добавляет CLI в PATH, но текущее окно PowerShell открылось до этого изменения. Закройте и снова откройте PowerShell, затем выполните pandev status.

pandev status пишет «not authenticated»

Повторите pandev login -t <YOUR_TOKEN_HERE> со свежим токеном из веб-приложения. Убедитесь, что скопировали токен целиком, без лишних пробелов в начале и конце.

pandev status показывает, что демон не запущен

Запустите скрипт установки (Шаг 1) ещё раз, чтобы перерегистрировать демон, затем снова проверьте pandev status.

Self-signed certificate на on-prem сервере

Плагин использует хранилище сертификатов Windows. Импортируйте корневой CA вашей организации в Доверенные корневые центры сертификации (certmgr.msc → Доверенные корневые центры сертификации → Сертификаты → Импорт).

Нет данных на дашборде через 30 минут

Проверьте три вещи:

1. pandev status сообщает, что авторизован и работает
2. pandev time показывает ненулевое значение
3. Токен принадлежит тому же аккаунту, что вы смотрите в UI PanDev Metrics

После удаления плагина Git Bash после каждой команды пишет command_queue.jsonl: No such file or directory

Пакет удалили, не выполнив перед этим pandev uninstall-hooks: хук остался в ~/.bashrc и пытается писать в папку плагина, которой больше нет. Откройте файл в Git Bash:

nano ~/.bashrc

В nano удалите блок хука целиком:

1. Ctrl+W, введите HOOK START, Enter — курсор встанет на первую строку блока: # --- PANDEV GIT BASH HOOK START ---.
2. Home, затем Alt+A — начало выделения, внизу появится Mark Set.
3. Стрелкой ↓ ведите выделение, пока оно не закроет строку # --- PANDEV GIT BASH HOOK END --- целиком.
4. Ctrl+K — удалить выделенное.
5. Ctrl+O, затем Enter — сохранить файл.
6. Ctrl+X — выйти из nano.

Выделять мышью бесполезно: nano такого выделения не видит, и Ctrl+K удалит одну строку вместо блока. После этого откройте новое окно Git Bash — сообщение больше не появляется.

Такой же блок в профиле PowerShell (от # --- PANDEV POWERSHELL HOOK START --- до # --- PANDEV POWERSHELL HOOK END ---) после удаления пакета ничего не делает и ошибок не даёт. При желании уберите его так же: notepad $PROFILE.

FAQ

Где взять токен?

Откройте веб-приложение PanDev Metrics, перейдите в Settings → Plugins, нажмите CLI и скопируйте значение из шага Введите ваш токен. В том же шаге есть Перевыпустить токен и Отозвать токен.

Токен выдаётся для того воркспейса, под которым вы сейчас авторизованы, и активен он один на воркспейс — этот же токен подходит для IDE-плагинов и браузерных расширений.

Какие терминалы поддерживаются?

Плагин встраивается в shell, поэтому heartbeat'ы дают и PowerShell, и Windows Terminal. Команды внутри WSL ловит сборка под Linux.

Нужны права администратора?

Да. Скрипт установки запускайте из PowerShell, открытого от имени администратора — он регистрирует фоновый демон на системном уровне. После установки повседневные команды (pandev status, pandev time, pandev login) работают в обычном окне без прав администратора.

Как сменить аккаунт или сервер?

Запустите pandev login -t <NEW_TOKEN> с токеном нужного аккаунта. Новый токен заменит старый.

Похожее

• CLI-плагин — обзор — что собирается, модель приватности
• Установка на macOS
• Установка на Linux
• Браузерные расширения — обзор