witr CLI
witr выясняет, какой процесс занял порт или файл, и показывает цепочку запуска вместе со службой или контейнером.
- 22 929 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- witr читает сведения системы и процессов; интерактивные действия позволяют управлять выбранными процессами.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/pranshuparmar/witr/main/install.sh | bashПервый способ Quick Install для Linux, macOS и FreeBSD. Прочитайте скрипт перед запуском.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- witr читает сведения системы и процессов; интерактивные действия позволяют управлять выбранными процессами.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
witr связывает процесс с причиной его запуска. Можно указать имя, PID, порт, контейнер или открытый файл и получить цепочку родителей вместе с контекстом службы. Так агент видит, что удерживает процесс в работе, прежде чем предлагать остановку. Результат доступен как отчет для человека и JSON для сценария. Без цели открывается интерактивная панель с процессами и портами. Официальный агентный скилл объясняет коды завершения и требует согласования перед остановкой найденных программ.
Для кого. Дежурным инженерам, которые выясняют причину занятого порта или повторного появления остановленного процесса.
Подходит, если
- Сервер разработки не стартует, потому что нужный порт уже занят.
- Процесс возникает снова после остановки, и нужно найти управляющую службу.
- Открытый файл мешает операции, но владелец дескриптора неизвестен.
- Агенту нужен структурированный отчет о контейнере и его цепочке запуска.
Не подходит, если
- Требуется незаметно остановить чужую службу вместо выяснения ее владельца.
- Нужно собрать длительную историю метрик без отдельной системы наблюдения.
- Вы ожидаете одинаковую доступность всех данных о процессах на каждой ОС.
Пример запроса к агенту
Выясни через witr, что занимает порт 8080 и кто запускает этот процесс. Покажи JSON-отчет без переменных окружения и ничего не останавливай.Ограничения
Часть сведений о процессах других пользователей требует повышенных прав; в macOS защита SIP может скрывать данные даже с ними. Для разбора контейнера нужен CLI соответствующей среды выполнения в PATH. Возможности платформ различаются: например, Windows не показывает файловые блокировки и действия с процессами в интерактивной панели. Параметр вывода окружения может раскрыть чувствительные переменные, поэтому перед передачей отчета агенту или коллеге выбирайте только необходимые поля.
Как отключить. Завершите интерактивный просмотр и удалите witr способом установки. Отключите агентный скилл отдельно, если добавляли его в клиент.
Частые вопросы
Как проверить занятый порт?
Выполните `witr --port 8080 --json`, заменив номер нужным. В ответе посмотрите процесс и источник его запуска.
Код завершения 1 означает сбой?
Нет. Процесс найден, но есть предупреждения. Прочитайте их перед следующими действиями.
Что делать при неоднозначном имени?
Уточните PID и повторите запрос с `--pid`. Это позволит избежать выбора не того процесса.
Почему запуск без цели не работает в CI?
Интерактивной панели нужен терминал. Укажите процесс, порт или другую цель; один `--json` цель не заменяет.
Скилл устанавливает сам бинарник?
Нет. witr нужно установить отдельно. После этого скилл помогает агенту выбирать команды и читать результаты.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПоиск по процессам и настраиваемые столбцы помогают найти нагрузку, открытый порт и дочерние команды в терминале.
Терминальная диагностика объединяет трассировку и ping, чтобы агент помог сопоставить маршрут, задержки и потери ответов.
bottom показывает процессы, нагрузку CPU, память, сеть и диски в терминале с графиками, поиском и настройкой виджетов.
PM2, менеджер процессов, сохраняет список фоновых приложений для запуска после перезагрузки и показывает их состояние в терминале.
Терминальный интерфейс показывает контейнеры, сервисы и образы Docker для совместного разбора окружения пользователем и агентом.
Нативный терминал для macOS на базе Ghostty с вертикальными вкладками и уведомлениями, когда агенту нужен ответ
Коротко о README
witr поддерживает Linux, macOS, Windows и FreeBSD. В одном запросе можно смешивать несколько целей, сохраняя их порядок в отчете.