Как превратить задачи Claude Code в наглядную канбан-доску

Когда я впервые запустил Claude Code для рефакторинга монолита, терминал быстро превратился в бесконечный водопад логов. Модель бодро декомпозировала задачу на десяток шагов, запускала тесты, правила код и периодически застревала на зависимостях. Понять в этой каше вывода, какая подзадача сейчас выполняется и что именно ее блокирует, оказалось отдельным квестом.

В терминале за этим следить неудобно. Репозиторий claude-task-viewer решает как раз эту проблему, разворачивая локальный веб-дашборд в формате канбан-доски и таймлайна.

Что это за проект

claude-task-viewer — легковесный локальный интерфейс для наблюдения за задачами Claude Code. Главная идея автора звучит просто: наблюдение вместо контроля. Утилита не пытается сама ставить задачи или менять статус тикетов за нейросеть. Она лишь считывает состояние сессий и визуализирует граф подзадач, который генерирует агент.

Инструмент подойдет разработчикам, которые активно гоняют Claude Code в фоновом режиме на длинных задачах и не хотят постоянно переключаться в окно терминала, чтобы проверить прогресс.

Главные возможности на практике

Интерфейс выглядит минималистично, но закрывает все базовые сценарии отслеживания работы.

Наглядный статус и связи между задачами

Дашборд показывает колонки со статусами: отложенные, в процессе и завершенные. Если одна задача блокирует другую, в карточке отображаются связи blockedBy и blocks. Это помогает сразу увидеть критический путь и понять, почему агент завис на определенном шаге. В карточке также выводится поле activeForm, где видно конкретное текущее действие модели прямо в эту секунду.

Канбан и таймлайн в виде диаграммы Ганта

В шапке можно переключить вид с доски на временную шкалу. Задачи выстраиваются горизонтальными полосами с момента создания до последнего обновления. Временная ось масштабируется автоматически: секунды, минуты или часы в зависимости от длительности сессии. Если навести курсор, появится точный таймстемп и общее время выполнения.

Звуковые оповещения и уведомления на рабочем столе

Когда Claude завершает длинную задачу, браузер воспроизводит двухтональный звуковой сигнал и присылает системное уведомление. По клику на уведомление можно сразу перейти к карточке сессии. Это удобно, когда агент выполняет сборку или прогон тестов на 15-20 минут, а вы в это время пишете документацию в другой вкладке.

Автоматическая архивация и быстрый поиск

Сессии, где нет активных задач и которые не менялись больше недели, автоматически уходят в свернутую секцию архива. Доска не захламляется старыми экспериментами. При этом встроенный нечеткий поиск ищет по названиям сессий, описаниям задач и путям проектов даже внутри архива.

Как устроен обмен данными

Под капотом нет тяжелых баз данных. Claude Code хранит задачи локально в каталоге ~/.claude/tasks/, где для каждой сессии выделена папка с json-файлами:

~/.claude/tasks/
  └── {session-uuid}/
      ├── 1.json
      ├── 2.json
      └── ...

Типичная структура файла задачи выглядит так:

{
  "id": "1",
  "subject": "Implement user authentication",
  "description": "Add JWT-based auth with refresh tokens",
  "activeForm": "Setting up auth middleware",
  "status": "in_progress",
  "blocks": ["2", "4"],
  "blockedBy": []
}

Бэкенд на Node.js следит за файловой системой и транслирует изменения в браузер через Server-Sent Events (SSE). Никакого постоянного поллинга или ручных обновлений страницы: как только Claude Code создает или правит json-файл, карточка на доске мгновенно перемещается.

Для взаимодействия с интерфейсом предусмотрен простой REST API. Через него можно запросить список сессий, посмотреть сырые данные или удалить зависшую задачу:

# Получить список сессий
curl http://localhost:3456/api/sessions

# Забрать все задачи конкретной сессии
curl http://localhost:3456/api/sessions/:id

Как запустить

Утилиту можно запустить без предварительной установки через npx:

npx claude-task-viewer

После старта сервер откроется на http://localhost:3456.

Если стандартный порт занят или у вас несколько профилей Claude, параметры передаются через флаги окружения:

# Запуск на другом порту с автоматическим открытием вкладки в браузере
PORT=8080 npx claude-task-viewer --open

# Использование нестандартного каталога конфигурации
npx claude-task-viewer --dir=~/.claude-work

Для сборки из исходников достаточно склонировать репозиторий:

git clone https://github.com/L1AD/claude-task-viewer.git
cd claude-task-viewer
npm install
npm start

Управлять доской можно с клавиатуры: клавиша ? вызывает справку, D удаляет выбранную карточку с проверкой зависимостей, а Esc закрывает модальные окна.

В сухом остатке

claude-task-viewer делает ровно одну вещь: дает прозрачность процессам Claude Code без усложнений. Здесь нет перегруженных настроек или попыток навязать собственный воркфлоу управления проектами.

Если вы регулярно отдаете агенту многосоставные задачи и устали разглядывать сырые логи в консоли, стоит держать эту утилиту открытой во второй вкладке браузера. Она экономит внимание и сразу дает понять, чем занята модель.