slashdocs CLI
CLI и скилл: агент публикует отчеты как HTML-документы, команда их комментирует, а каждая версия сохраняется
- 410 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент загружает содержимое отчетов на сервер slashdocs, а права по умолчанию на новые документы задает администратор, и они могут включать просмотр или правку
- Для входа CLI хранит учетные данные, а ключи сервисных аккаунтов дают доступ к документам без участия человека
Установка
- Работает в
Ручная установка
git clone https://github.com/razorpay/slashdocs.git && cd slashdocs && make buildСборка из исходников дает bin/slashdocs-server и bin/slashdocs. Готовые архивы CLI лежат в релизах репозитория, а сервер отдает установщик по адресу /install.sh.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент загружает содержимое отчетов на сервер slashdocs, а права по умолчанию на новые документы задает администратор, и они могут включать просмотр или правку
- Для входа CLI хранит учетные данные, а ключи сервисных аккаунтов дают доступ к документам без участия человека
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
slashdocs от Razorpay выкладывает отчет агента как один самодостаточный HTML-файл вместо стены текста в чате. Люди открывают документ в браузере, комментируют конкретные слова, делятся ссылкой, а агент читает комментарии и публикует следующую версию. Все версии неизменяемы, параллельные правки решаются оптимистичной блокировкой. Агент работает через командную строку `slashdocs`. Команда `docs create` загружает файл, `docs pull` и `docs push` забирают и обновляют документ, `docs comments` показывает, создает и закрывает комментарии, `docs list` ищет по тексту последней версии с фильтрами `from:`, `in:`, `label:` и датами. Флаг `--json` выдает структурированный ответ. Перед созданием документа скилл велит выполнить `slashdocs guidelines`: там правила сборки одного HTML-файла, картинок и темы. Есть три способа подключения. Режим `--local` работает на вашем компьютере без сервера и входа, но без общего доступа, истории версий, поиска и уведомлений. Полный режим требует сервер slashdocs: один бинарник на Go со встроенным интерфейсом на React, Postgres и хранилище, совместимое с S3. Агентам, у которых нет CLI, сервер отдает MCP по адресу `/mcp` с входом через браузер.
Для кого. Для команд, где агенты пишут длинные артефакты, такие как ревью архитектуры, разборы инцидентов и спецификации, а люди должны обсудить их и вернуть правки.
Подходит, если
- Агент пишет отчет, разбор инцидента или спецификацию, которую неудобно читать в чате
- Коллегам нужно оставлять комментарии к конкретным словам документа и закрывать их, а агенту потом читать их и править
- Нужна история версий документа от агента и возможность вернуться к прежней
- Нужно сохранять результаты браузерных тестов, дашборды и диаграммы Mermaid или SVG в виде переносимых HTML-файлов
- Хочется попробовать без сервера и входа: режим `--local` хранит документы в папке `~/slashdocs`
Не подходит, если
- Пользователь просит Markdown, простой текст, PDF или ответ в чате: скилл в этих случаях не публикует в slashdocs
- Нужна полноценная совместная работа без собственного сервера: общий доступ, история и поиск есть только на сервере slashdocs
- Нельзя держать и администрировать свой сервер: полный режим требует Postgres и S3-совместимое хранилище
- Нужно создавать сервисные аккаунты или ключи через MCP: так сделать нельзя, ключи выпускаются в веб-приложении или CLI
Пример запроса к агенту
Подготовь разбор инцидента как HTML-документ, опубликуй в slashdocs и пришли ссылку, а потом прочитай комментарии и выложи новую версиюОграничения
Большинство возможностей требует сервера slashdocs: вы держите Postgres и хранилище, совместимое с S3, а для входа людей настраиваете OpenID Connect (Google, Okta, Entra ID, Keycloak, Dex и другие). Быстрый старт через `docker compose up` поднимает сервер с Postgres, шлюзом S3 и тестовым провайдером Dex, а режим входа Dex предназначен только для разработки. Приложение и отрисовка документов должны жить на разных именах хостов, иначе изоляция cookie не работает.
Загруженный HTML считается недоверенным и открывается в изолированном фрейме. Правила по умолчанию для общего доступа к новым документам задаются на сервере переменной окружения, и по умолчанию документ приватный, но администратор может раздать права на просмотр, комментирование или правку. Режим `--local` не поддерживает общий доступ, версии, полнотекстовый поиск, метки и уведомления. Сервис не собирает телеметрию. Проект раньше назывался aidocs, и старые ссылки продолжают работать.
Как отключить. Удалите папку скилла из каталога скиллов агента и бинарник `slashdocs` из `PATH`. Ключи сервисных аккаунтов отзываются в веб-приложении на сервере. Документы на сервере остаются, их удаляет администратор.
Частые вопросы
Как установить slashdocs для Claude Code?
Скилл и CLI ставятся установщиком `curl ... | sh` с вашего сервера slashdocs по адресу `/install.sh`. Можно собрать из исходников: `git clone https://github.com/razorpay/slashdocs.git`, затем `make build`, бинарник появится в `bin/slashdocs`. Автономные архивы CLI есть в релизах GitHub.
Нужен ли сервер для проверки?
Нет. Режим `slashdocs --local` работает на вашем компьютере: документы лежат в `~/slashdocs`, комментарии поддерживаются. Общего доступа, версий, поиска, меток и уведомлений в нем нет.
Почему документ в одном HTML-файле?
Такой файл легко создать агенту, версионировать, архивировать и передавать через CLI. Картинки встраиваются в виде data URL с base64, диаграммы строятся на Mermaid, встроенном SVG или HTML и CSS.
Как агент получает комментарии?
Через `slashdocs docs comments list <id>` или инструменты MCP. Комментарий привязан к цитате из текста, его можно закрыть и снова открыть. Агент читает правки и выкладывает новую версию с кратким описанием изменений.
Как подключить MCP?
Добавьте в MCP-клиент адрес `https://ваш-хост/mcp`. Клиент откроет страницу входа и согласия, а потом получит короткоживущий токен по схеме authorization code с PKCE. Для агентов без экрана подойдет ключ сервисного аккаунта в заголовке Bearer.
Безопасно ли открывать HTML от агента?
Загруженный HTML считается недоверенным. Приложение и отрисовка документов обязаны работать на разных именах хостов, а документ открывается в изолированном фрейме, так что браузер не пускает его к вашему сеансу.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI Artifact Share: агент публикует HTML, Markdown и статические сайты по стабильной ссылке и обновляет ее новыми версиями
Плагин с CLI и скиллами для Claude Code и Codex: HTML от агента уходит в личный архив на AWS, читается и с телефона.
Сложные ответы, файлы, папки и выгрузки из сервисов агент оформляет страницей HTML с готовым стилем и проверкой в браузере
Скилл, MCP-сервер и CLI превращают Markdown от агента в короткую ссылку на веб-страницу, которую открывают без входа.
CLI fl выкладывает папку с Markdown и HTML как сайт одной командой и возвращает агенту адрес и ссылку для передачи.
Скилл и программа docx: агент заполняет формы, правит таблицы и ведет рецензирование Word с отслеживаемыми правками
Коротко о README
Описание от Razorpay называет проект рабочим пространством для организаций с агентами и перечисляет, какие документы можно в нем вести. Далее идут быстрый старт через Docker Compose, установка из исходников, образ Docker и подключение клиента MCP. В конце даны быстрый старт CLI, схема архитектуры, правила разработки и заявление об отсутствии телеметрии.