Agent Virtual Office CLI
Agent Virtual Office рисует состояние Claude Code, Codex и Gemini CLI как мини-офис в браузере через хуки и HTTP
- 70 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Хуки жизненного цикла выполняют локальный адаптер на событиях агента и пишут метаданные статуса в локальные файлы
- Запуск через GitHub слушает LAN без аутентификации, а токен защищает только запись по API
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/agent-virtual-officeОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки жизненного цикла выполняют локальный адаптер на событиях агента и пишут метаданные статуса в локальные файлы
- Запуск через GitHub слушает LAN без аутентификации, а токен защищает только запись по API
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Agent Virtual Office запускает в браузере пиксельный или классический «офис», где персонажи-роли (PM, архитектор, разработчик, QA, DevOps, исследователь, привратник, дизайнер) отражают состояние ваших агентов. Кольца статуса следуют отчетам инструментов: работающий агент сидит за столом лицом к экрану, между задачами персонажи пьют кофе и собираются у доски. Список со статусом и недавней активностью открывает кнопка меню, она удобна даже в боковой панели IDE. Запуск без клонирования: `npx github:KbWen/agent-virtual-office --no-host`. Команда `npx github:KbWen/agent-virtual-office setup` ставит хуки жизненного цикла Claude Code, с флагами `--platform codex` и `--platform gemini` настраиваются Codex CLI и Gemini CLI. Любой инструмент может сообщить статус обычным запросом: `POST /api/status` с телом вроде `{"dev":"working","workflow":"Sprint 42"}` или `POST /api/event` для разового события CI, например `deploy-success`. Сервер нужен только локальный: облачной серверной части, базы данных и WebSocket нет. Живой статус показывается лишь тогда, когда подключенный источник его прислал, а фоновые сцены остаются декорацией. Интерфейс на английском и традиционном китайском.
Для кого. Разработчикам, которые запускают нескольких агентов в фоне и хотят видеть их состояние краем глаза, не листая терминалы.
Подходит, если
- Три агента работают в разных терминалах, и нужен один экран, где видно, кто занят, кто ждет разрешения
- Сборка в CI заканчивается, и в офисе должен появляться сигнал `deploy-success`
- Хочется боковую панель в IDE со списком агентов и недавней активностью
- Команда на общем сервере Docker с Nginx и PM2 следит за статусом пайплайна
- Нужно подключить к одному офису Claude Code, Codex CLI и Gemini CLI через хуки
Не подходит, если
- Нужно доказательство, что агент выполнил инструмент: ручные отчеты и сигналы файлов показывают только присланные данные
- Статус должен быть закрыт от сети: запуск через GitHub по умолчанию слушает LAN, закрывает это флаг `--no-host`
- Нужен учет токенов и стоимости: офис показывает только состояния
- Агент недоступен для хуков и транскриптов: источника статуса не будет
Пример запроса к агенту
Запусти Agent Virtual Office командой npx github:KbWen/agent-virtual-office --no-host и подключи хуки Claude CodeОграничения
- Запуск из GitHub по умолчанию слушает все интерфейсы без аутентификации, для доступа только с этой машины нужен флаг `--no-host`.
- Переменная `OFFICE_API_TOKEN` защищает запись по API, но не чтение статуса и не поток SSE.
- Хуки Codex запускают локальный адаптер: перед разрешением проверьте все шесть записей в окне Review hook.
- Состояние «думает» выводится по времени. Событие `Stop` переводит агента в «простой» и не означает «готово». Npm-пакет с таким же именем принадлежит другому репозиторию.
Как отключить. Хуки для Claude Code убирают из `.claude/settings.json`, для Codex и Gemini из конфигурации проекта, а сам офис останавливают Ctrl+C. Пакет ставить не нужно, `npx` ничего глобально не оставляет.
Частые вопросы
Как запустить Agent Virtual Office без клонирования?
Выполните `npx github:KbWen/agent-virtual-office --no-host` и откройте вкладку, которую покажет браузер. Одноименный пакет в реестре npm принадлежит другому проекту, поэтому в команде нужен префикс `github:`.
Как подключить Claude Code?
Выполните `npx github:KbWen/agent-virtual-office setup`: команда ставит хуки жизненного цикла. Статус появится, когда Claude Code начнет присылать события.
Работает ли офис с Codex и Gemini CLI?
Да. В корне проекта выполните setup с `--platform codex` или `--platform gemini`. У Codex после установки откроется окно Review hook, где проверяют шесть записей.
Можно ли подключить свой инструмент?
Да, офис принимает обычные HTTP-запросы: `POST /api/status` задает состояние, `POST /api/event` шлет разовое событие, например из CI.
Нужны ли база данных или облако?
Нет. Облачной серверной части, базы и WebSocket нет, статус держит локальный сервер.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПиксельный офис в браузере: каждая сессия Claude Code или Codex сидит за столом, печатает и поднимает руку, когда ждет ответа.
TUI поверх tmux ведет сессии Claude Code, Codex и других агентов одним списком: статус, быстрые промпты, worktree и ревью диффа
Локальные комнаты для встреч Codex и Claude Code: агенты переписываются между собой, человек читает и пишет из браузера.
Многоагентная обвязка с проверкой результата по артефактам: стоп-хуки, независимый судья и журнал событий для Claude Code, Codex, Cursor и других
Общая доска для Claude Code, Codex и других агентов: вопрос, на котором встал агент, всплывает наверх за секунды.
Открытый кодовый агент для терминала, браузера и десктопа, который работает с моделями от OpenAI и Claude до Ollama
Коротко о README
README показывает офис с персонажами и сценами, затем дает быстрый старт через `npx`, раздел подключения агентов (Claude Code, Codex, Gemini CLI, Antigravity и любой HTTP-источник) и пояснения о том, что хуки Codex показывают и чего не показывают.