octo-cli

Установка

Работает в

• Claude Code

Ручная установка

npm install -g @mininglamp-oss/octo-cli

Что делает

octo-cli — один исполняемый файл на Go, через который агент вызывает REST API экосистемы Octo командами оболочки. Ставится так: `npm install -g @mininglamp-oss/octo-cli`, `go install github.com/Mininglamp-OSS/octo-cli/cmd/octo-cli@latest`, скриптом `install.sh` или архивом из релизов. Входа для человека нет: авторизация идет токеном бота из `OCTO_TOKEN` или `OCTO_BOT_TOKEN`. Дерево команд собирается при запуске из встроенных описаний OpenAPI, поэтому новые методы появляются с обновлением описаний, а не кода. Команды разбиты по областям: `message` (отправка, правка, поиск), `group`, `thread`, `file`, `drive` (сетевой диск), `docs` (документы, таблицы, доски и презентации), `html` (интерактивные HTML-документы), `mail` (почта агента), `bot`, `event` и `loop` (управление задачами и исполнителями). Перед правкой таблицы или доски команда сначала читает содержимое вместе с токеном версии, а правка идет с этим токеном, чтобы не затереть чужие изменения. Метод, которого нет в дереве, вызывается командой `octo-cli api GET /v1/...`. Каждый успешный вызов печатает на stdout JSON с полями `ok`, `identity`, `data`, сведениями о страницах и лимитах, ошибки идут на stderr с кодом выхода 3 для авторизации, 2 для проверки и 1 для остального. Ключи `--dry-run`, `--jq`, `--page-all` и `--format` показывают запрос, выбирают поле и обходят страницы. В бинарник встроены инструкции для агентов: `octo-cli skills` перечисляет их, а `octo-cli skills --install <каталог>` записывает все скиллы вместе со справочными файлами.

Для кого. Для команд, которые уже работают в экосистеме Octo и хотят дать агенту (Claude Code, OpenClaw и похожим) управление сообщениями, документами, диском и почтой через токен бота.

Пример запроса к агенту

Найди в чатах Octo сообщения со словами «квартальный отчет» и создай документ со списком найденных файлов

Ограничения

• Токен принимает четыре вида: `app_*`, `bf_*`, `uk_*` и `octo_loop_*`. Клиент не проверяет права локально, сервер отвечает `FORBIDDEN`. Бот с токеном `app_*` не пишет в группы, не работает с ветками и не ищет сообщения.
• По умолчанию клиент обращается к `https://im.deepminer.com.cn`, другой адрес задается переменной `OCTO_API_BASE_URL`. Профили и токены хранятся в каталоге `~/.octo-cli`.
• Для задач Loop в режиме `OCTO_CREDENTIAL_MODE=task` доступен урезанный набор команд. Автор подчеркивает, что этот режим не защищает от процесса, который может менять собственное окружение.
• Обновление черновика письма заменяет его целиком: пропущенные поля cc, bcc, текст, html и вложения исчезают. Команда `docs import --mode replace` перезаписывает доску.
• Установка через Homebrew помечена как скорая. Лицензия Apache-2.0.

Как отключить. Удалите бинарник командой `npm uninstall -g @mininglamp-oss/octo-cli` или файл `octo-cli` из каталога установки. Токен уберите из `OCTO_TOKEN` и `OCTO_BOT_TOKEN`, а сохраненные профили удалите вместе с каталогом `~/.octo-cli`.

Коротко о README

Документация репозитория описывает устройство клиента: описания OpenAPI, реестр, движок команд и сетевой слой. Дальше идут таблица областей, четыре способа установки, примеры по сообщениям, почте, документам, таблицам, доскам и HTML, раздел об авторизации с таблицей видов токена, список переменных окружения, формат ответа и коды выхода. Отдельный раздел перечисляет скиллы для агентов из папки `skills/`. Рядом лежат исходники в `cmd` и `internal`, обертка для npm, журнал изменений и правила для участников.