Metadata-Version: 2.5
Name: skrepka
Version: 0.19.0
Summary: Careful collaborative editing for Google Docs: reply to comments and edit text without ghosting anchors and without flattening styles.
Project-URL: Homepage, https://github.com/slvfmts/skrepka
Project-URL: Issues, https://github.com/slvfmts/skrepka/issues
Author: Slava Ufimtsev
License: MIT
License-File: LICENSE
Keywords: claude,comments,editing,google-docs,markdown
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business
Classifier: Topic :: Text Processing :: Markup :: Markdown
Requires-Python: >=3.11
Requires-Dist: beautifulsoup4>=4.12
Requires-Dist: google-api-python-client>=2.100
Requires-Dist: google-auth-httplib2>=0.1
Requires-Dist: google-auth-oauthlib>=1.0
Requires-Dist: markdown-it-py>=3.0
Requires-Dist: markdownify>=0.11
Requires-Dist: requests>=2.31
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Description-Content-Type: text/markdown

# skrepka 📎

ИИ-соавтор в Google Документах. Агент работает из вашего терминала прямо в документе: читает комментарии, отвечает на них и правит текст на месте.

[In English](https://github.com/slvfmts/skrepka/blob/main/README.en.md) · [Приватность](https://github.com/slvfmts/skrepka/blob/main/PRIVACY.md) · [Безопасность](https://github.com/slvfmts/skrepka/blob/main/SECURITY.md)

## Зачем

Работа над текстом с ИИ обычно идёт в двух окнах: документ и чат с агентом. Скопировать абзац в чат, вставить ответ обратно, руками починить оформление. Пока текст ходит туда-сюда, теряются правки и комментарии.

skrepka убирает это копирование. Вы оставляете по тексту обычные комментарии: про структуру, логику, формулировки. Потом зовёте агента в документ, он читает треды, отвечает и правит текст на месте. Заказчик приходит, комментирует там же, работа продолжается тем же способом. Комментарии при этом не рвутся: даже когда прокомментированный абзац переписан целиком, тред остаётся и переезжает на новый текст. Где сделать это безопасно нельзя, skrepka отказывает по одной операции, называет причину и правит остальной документ — [что именно она не делает](https://github.com/slvfmts/skrepka/blob/main/docs/LIMITATIONS.md). Закрывает треды только человек.

## Для кого

Редакторам, копирайтерам и контент-менеджерам, которые ведут и согласовывают тексты в Google Docs, а к работе подключают ИИ-агента: Claude Code, Codex или другого. Быть разработчиком не нужно, доступ к Google настраивает мастер `skrepka init`.

## Что умеет

Главный сценарий — разобрать комментарии. Вы говорите агенту «отработай комментарии», он читает треды, отвечает по делу и вносит правки в текст.

Кроме этого skrepka выгружает документ в markdown и заливает правки обратно, создаёт документы из markdown и разбирает предложенные правки. Полный список сценариев — в [docs/PLUGIN.md](https://github.com/slvfmts/skrepka/blob/main/docs/PLUGIN.md).

## Как это выглядит

Работу ведёт агент, но команды видны, и вот весь цикл:

```bash
skrepka comments DOC --output comments.json     # прочитать треды
skrepka patch DOC ops.json --dry-run            # примерить правки
skrepka patch DOC ops.json                      # применить
skrepka reply DOC --file replies.json           # ответить в треды
```

Третья строка — единственная, которая меняет документ. Вторая говорит по каждой правке, что с ней будет, и не пишет ничего: примерить дёшево, поэтому пробовать можно без риска. Треды при этом остаются живыми, а закрывает их человек.

## Как начать

Нужен macOS или Linux: защиты файлового ввода-вывода опираются на механизмы Unix, Windows не поддержан.

1. Поставьте skrepka: `pipx install skrepka`.
2. Настройте доступ к Google: `skrepka init`. Первая настройка занимает 15–30 минут, инструкция со снимками экрана — в [docs/QUICKSTART.md](https://github.com/slvfmts/skrepka/blob/main/docs/QUICKSTART.md).
3. Подключите навыки к агенту: [docs/PLUGIN.md](https://github.com/slvfmts/skrepka/blob/main/docs/PLUGIN.md).

Дальше попросите агента отработать комментарии в тестовом документе.

Вы заводите собственный проект Google Cloud и работаете от своего имени. У skrepka нет сервера и телеметрии: автор skrepka ваших документов и токенов не видит. Подробности в [PRIVACY.md](https://github.com/slvfmts/skrepka/blob/main/PRIVACY.md).

## Документация

| Файл | Что внутри |
|---|---|
| [docs/QUICKSTART.md](https://github.com/slvfmts/skrepka/blob/main/docs/QUICKSTART.md) | Настройка доступа к Google по шагам |
| [docs/PLUGIN.md](https://github.com/slvfmts/skrepka/blob/main/docs/PLUGIN.md) | Навыки для Claude Code и Codex |
| [docs/LIMITATIONS.md](https://github.com/slvfmts/skrepka/blob/main/docs/LIMITATIONS.md) | Что skrepka не делает |
| [docs/LIMITATIONS-TECHNICAL.md](https://github.com/slvfmts/skrepka/blob/main/docs/LIMITATIONS-TECHNICAL.md) | То же подробно: команды, коды причин, поведение API |
| [PRIVACY.md](https://github.com/slvfmts/skrepka/blob/main/PRIVACY.md) | Какие данные и куда идут |
| [SECURITY.md](https://github.com/slvfmts/skrepka/blob/main/SECURITY.md) | Модель угроз и как сообщить об уязвимости |

## Лицензия

MIT
