shoulder CLI
TUI показывает, что делают в проекте Claude Code, Codex, Gemini CLI и opencode: открытый файл, правки и команды вживую
- 76 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Читает локальные журналы сессий агентов, в которых бывают код и фрагменты секретов, но ничего не пишет и не отправляет
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/shoulderОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Читает локальные журналы сессий агентов, в которых бывают код и фрагменты секретов, но ничего не пишет и не отправляет
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
shoulder следит за работой кодовых агентов в проекте и показывает ее вживую. Он читает журналы сессий, которые агенты уже пишут: Claude Code вместе с субагентами, Codex, Gemini CLI, opencode 2.x и omp. Агенты настраивать не нужно, каждый появляется в списке через несколько секунд после старта в том же проекте. Экран разделен на панели. Слева список агентов и измененных файлов, точка рядом с файлом показывает, какой агент в нем сейчас. В центре файл выбранного агента с курсором и меткой вроде `A1 editing`, внутри показаны изменения относительно последнего коммита: удаленные строки красным над новыми. Под файлом идут команды агента и их вывод с цветами, справа журнал действий: чтение, поиск, правки, команды, ответы и запросы. Полоса под каждым агентом показывает заполненность контекстного окна. Клавиша `s` включает разделение на панели по агентам, `e` открывает файл в редакторе, `x` прячет завершенных. Флаги `--since`, `--all`, `--splits`, `--signs` и `--hide-done` меняют вид. Программа только читает: не отправляет ввод агенту, не меняет файлы и не выходит в сеть.
Для кого. Разработчикам, которые запускают несколько агентов в одном репозитории и хотят видеть, какой файл и какую команду каждый сейчас трогает.
Подходит, если
- Claude Code и Codex работают в одном проекте, и надо следить, не правят ли они одни и те же файлы
- Хочется читать изменения по ходу работы, до завершения задачи
- Запущенная команда агента зависла, и ее вывод нужен сразу
- Контекстное окно агента заполняется, и это стоит видеть по полосе
- Журнал действий агента нужен для разбора, что он читал и менял
Не подходит, если
- Нужно управлять агентом из интерфейса: shoulder не отправляет ввод
- Нужны агенты вне поддерживаемого списка: Claude Code, Codex, Gemini CLI, opencode 2.x и omp
- Нужна запись журнала в файл для отчета: программа только показывает
Пример запроса к агенту
Запусти shoulder в каталоге проекта и покажи, какой агент правит `src/api.ts` прямо сейчас.Ограничения
Ставится командой `go install` и требует Go 1.26 или новее, либо готовым бинарным файлом для linux и darwin на amd64 и arm64. Показывает сессии за последний час, период меняет флаг `--since`. Следит за корнем git-репозитория каталога и видит сессии, начатые в нем или ниже. Папки сессий агентов читаются по умолчанию, другие пути задают переменные `CLAUDE_CONFIG_DIR`, `CODEX_HOME`, `GEMINI_CLI_HOME`, `XDG_DATA_HOME` и `PI_CODING_AGENT_DIR`. База opencode открывается только на чтение.
Как отключить. Удалите бинарный файл `shoulder` из `$GOPATH/bin` или из `/usr/local/bin`. Настройки лежат в `~/.config/shoulder/config.toml`.
Частые вопросы
Какие агенты поддерживает shoulder?
Claude Code с субагентами, Codex, Gemini CLI, opencode 2.x и omp. Настраивать агентов не нужно, программа читает их журналы сессий.
Может ли shoulder менять файлы или управлять агентом?
Нет. Он только читает журналы, не отправляет ввод агенту, не пишет в файлы и не подключается к сети.
Как показать агентов всех проектов?
Запустите `shoulder --all` или задайте `all = true` в `~/.config/shoulder/config.toml`.
Как поменять клавиши?
Добавьте таблицу `[keys]` в `~/.config/shoulder/config.toml`, например `hunk_next = "n"`. При неизвестном действии или дубле клавиш программа остановится с ошибкой.
Как проверить скачанный бинарный файл?
Сравните его с `checksums.txt` из релиза командой `sha256sum -c checksums.txt --ignore-missing`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыВыводит скрытые мысли, вызовы инструментов и подагентов Claude Code в отдельный терминал с деревом сессий в реальном времени
Окно для Claude Code, Codex, Gemini CLI и OpenCode: терминалы, пул-реквесты, изменения и подтверждения вызовов в одном месте
Xylocopa — браузерный оркестратор агентов Claude Code: задачи GTD, параллельные агенты в деревьях git, подтверждения с телефона.
Critty открывает терминальный интерфейс, где человек комментирует дифф, отвечает на вопросы и разрешает действия агента.
Монитор сессий Claude Code, Cursor, Codex и еще шести агентов в терминале, окне или через HTTP API, с чисткой и поиском по чатам
Conduit запускает команду агентов в терминале: вкладки с Codex, Claude Code, Gemini CLI и OpenCode поверх рабочих копий git.
Коротко о README
Описаны установка через Go, готовые бинарные файлы и Nix, запуск в каталоге проекта, таблица флагов, поддерживаемые агенты, устройство экрана, открытие файла в редакторе и настройка клавиш.