ZenStory CLI
Команда zenstory и навык дают Claude Code и Codex читать и править главы, наброски и карточки героев в проекте ZenStory.
- 98 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- С правом `write` агент создает, перезаписывает и удаляет файлы проекта в облачном аккаунте.
- Ключ API открывает все проекты аккаунта, его нельзя вставлять в чат агента.
Установка
- Работает в
Ручная установка
npx zenstory skill installИз раздела Connect external agents. Для Codex добавьте `--target codex`. Ключ API создается в Settings, Agent.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- С правом `write` агент создает, перезаписывает и удаляет файлы проекта в облачном аккаунте.
- Ключ API открывает все проекты аккаунта, его нельзя вставлять в чат агента.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ZenStory — браузерная рабочая среда для романов, рассказов и сценариев коротких драм. Проект хранит большую часть материала файлами: наброски, главы, карточки героев, мир и заметки. Для внешних агентов в репозитории лежит CLI `zenstory` и стандартный навык Agent Skills. Агент получает контекст проекта, ищет по файлам, создает и обновляет главы, переносит файлы по папкам и откатывает версии. Для скриптов у каждой команды есть вывод `--json`. Ключ API создается в настройках ZenStory, а запись в файлы включается отдельным правом `write`.
Для кого. Авторам веб-романов и сценаристам, которые ведут проект в ZenStory и хотят писать главы своим агентом.
Подходит, если
- Claude Code должен продолжить главу и сначала поднять контекст: героев, мир и прошлые главы.
- Черновик надо сохранить обратно в проект, не копируя текст руками из терминала.
- Нужно найти по проекту, в какой главе появился конкретный персонаж.
- Правка агента оказалась неудачной, и файл надо откатить к прошлой версии.
Не подходит, если
- Проект живет в Word или Google Docs: CLI работает только с API ZenStory.
- Нужна полностью автономная работа без аккаунта: без ключа API команды не выполняются.
- Вы хотите писать только внутри браузерного окна с встроенными агентами.
Пример запроса к агенту
Через zenstory подними контекст проекта, прочитай план третьей главы и напиши черновик с учетом карточки героини.Ограничения
Требуются Node.js 20 или новее и ключ API ZenStory (начинается с `eg_`, создается в Settings, раздел Agent). Без права `write` агент только читает. Команды `projects delete` и `files delete` просят флаг `--yes`. Интерфейс продукта и тексты рассчитаны в первую очередь на китайскую веб-литературу. Сама рабочая среда лицензирована AGPL-3.0, а облачная версия работает на app.zenstory.ai. Лимиты запросов задает сервер: код ответа 5 команды означает превышение частоты.
Как отключить. Удалите навык из каталога агента, отзовите ключ в настройках ZenStory и выйдите командой `zenstory logout`. Глобальный пакет снимается командой `npm uninstall -g zenstory`.
Частые вопросы
Как подключить zenstory к Claude Code?
Создайте ключ API в Settings, раздел Agent, и выполните `npx zenstory skill install`. Для Codex и OpenClaw добавьте `--target codex` или `--target openclaw`.
Может ли агент удалить мои главы?
Только с правом `write` и флагом `--yes` у команд удаления. Версии файла сохраняются, а `files rollback` возвращает прежнюю.
Как передать ключ без истории оболочки?
Через stdin: `printf %s "$KEY" | zenstory login --key -`. Сам ключ в аргументе `--key` лучше не указывать.
Работает ли это на собственном сервере?
Да, `zenstory login --api-base <адрес>/api/v1` направляет команды на вашу установку ZenStory.
Где хранятся данные проекта?
В аккаунте ZenStory на app.zenstory.ai или на вашем сервере, если вы развернули рабочую среду сами. CLI не хранит проект локально.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыНабор из 13 скиллов для написания сетевой прозы в кодинг-агенте: разбор рейтингов и хитов, план и текст, чистка ИИ-стиля, обложка
24 скилла для прозы в Markdown, от замысла до печати, и команда story, которая находит противоречия в сюжете раньше читателей
Плагин для романов и сериальной прозы: агент muse ведет от идеи до черновика, а писатель, критик, редактор и проверка канона работают отдельными агентами
Скилл для написания романа с девятью агентами: сеттинг, план томов и глав, проза, проверка на машинный стиль и архив с памятью героев
Скилл для Codex ведет роман от первой идеи до книги: план, главы, правки и непрерывность сюжета лежат в файлах Markdown.
Скилл помогает Codex планировать китайский роман, править сцены и сверять действия героев с предыдущими главами
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| ZenStory (эта карточка) | нет | 98 | |
| Oh Story | нет | 8 559 | набор навыков для письма внутри агента; zenstory связывает агента с готовой рабочей средой и ее проектами |
| Webnovel Writer | нет | 7 939 | локальный конвейер написания романа; zenstory работает с проектами в ZenStory по API |
Коротко о README
Основной репозиторий — вся рабочая среда: веб-клиент, сервер на Python и набор агентов-писателей. Для внешних агентов предназначена папка `apps/cli` с пакетом `zenstory` без runtime-зависимостей.