🌱 Twig
🌱 TWIG AS MCP · v0.20.1
🌱 Twig отвечает AI-агентам через Model Context Protocol. Claude Code, Codex, Cursor и любой MCP-клиент получают не простыню вывода git, а короткий ответ: что изменено — сразу с диффами, коммит целиком одним вызовом, поиск по коду в истории, blame и то, что вы выделили в окне.
Claude Code · Codex · Cursor · любой MCP-клиент
ВЫПосмотри мои изменения и предложи, как разбить их на коммиты.
get_workspace_contextmain · впереди origin на 1 · 1 изменён, 1 новый444 Бlist_changes · diffsREADME.md +1 −0 · notes.todo +2 −0, с патчами386 БАГЕНТДва коммита: правка README.md отдельно, а notes.todo похож на личные заметки — его лучше не коммитить. Застейджить и закоммитить можно в 🌱 Twig.
Размеры ответов измерены на демо-песочнице 🌱 Twig. Текст агента — иллюстрация.
В САМОМ ПРИЛОЖЕНИИ
Включение, что получит агент и готовые
команды подключения — в одном окне.
ПОЧЕМУ ЭТО КРУТО
Агент может запустить git diff и сам. Поэтому инструмент здесь есть, только если он экономит агенту токены или вызовы — или даёт то, чего у git нет: что вы выделили в окне и ваше подтверждение коммита. Остальное агент спрашивает у git.
Файл — одна строка, как в git status --short, с числом строк; дифф — обычные ханки без заголовков diff --git и index. Ничего не экранируется в JSON, поэтому ответ не больше вывода git, а сводка — в 2–3 раза меньше (замер). Ветка, upstream и идущий merge или rebase — в короткой сводке.
Все изменения с диффами — одним вызовом, коммит с сообщением и патчами — тоже. Lock-файлы и огромные файлы приходят одной строкой с причиной и командой git, которая их прочитает, а всё, что не влезло в ответ, дочитывается ещё одной командой. Поиск по истории возвращает только строки вокруг совпадения — в 3–63 раза меньше, чем git log -S … -p (замер).
Агент видит, какой коммит, диапазон сравнения или файл открыт в 🌱 Twig. Выделили строку в графе — спросили агента. Копировать хэш и путь больше не нужно.
Нет инструментов commit, stage, checkout, reset, push и нет запуска команд. План коммитов агент предлагает, а выполняете его вы — в 🌱 Twig, где staging построчный и почти каждое действие можно отменить.
Любая команда Git, которую вызвал агент, попадает в консоль 🌱 Twig с плашкой MCP: argv, каталог, вывод, код. Ваши действия во вкладке «My» не смешиваются с чтениями агента.
Обычный Model Context Protocol поверх stdio: никаких SDK провайдеров, аккаунтов и серверов. Мост запускается на исполняемом файле самого 🌱 Twig — отдельный Node.js не нужен.
СВОДКА → ВСЁ СРАЗУ → КОММИТ
Настоящие ответы 🌱 Twig на демо-песочнице, сокращённые для читаемости. Справа от названия — размер полного ответа. Для сравнения: git status --short + git diff --numstat + git diff там же — 354 Б, и нового файла в них нет.
get_workspace_context≈440 БВетка, upstream, расхождение, идущая операция, счётчики файлов и другие подключённые репозитории. Без диффов.
{"branch": {
"name": "main",
"upstream": "origin/main",
"ahead": 1, "behind": 0 },
"operation": null,
"workingTree": {
"clean": false,
"staged": 0, "unstaged": 1,
"untracked": 1 }}list_changes85 БКаждый файл одной строкой, как в git status --short, с числом строк. Постранично.
on main: 1 unstaged, 1 untracked
unstaged:
M +1 -0 README.md
untracked:
? notes.todolist_changes diffs: true386 БТо же самое, но под каждым файлом — его ханки. Новый файл — как добавление. Всё одним вызовом.
unstaged:
## M +1 -0 README.md
@@ -6,3 +6,4 @@ …
Keep the details close…
+One unstaged edit.
untracked:
## ? +2 -0 notes.todo
@@ -0,0 +1,2 @@
+- try the reverse blame view
+- run the demo automationget_commit459 БКоммит одним вызовом: сообщение, автор, родители и патч каждого файла. git show того же коммита — 528 Б.
992e33cc9ae1… Refine the workspace layout
author: Maya Chen <maya@twig.example> …
parents: f8b8d92289f1
1 file, +2 -0:
## M +2 -0 README.md
@@ -4,3 +4,5 @@ …
Reset it any time from…
+
+Keep the details close to the history.Lock-файлы, минифицированные сборки и файлы больше 400 изменённых строк приходят одной строкой со счётчиками и причиной — 12 МБ сгенерированного JSON стоят одну строку. Каждая такая строка называет команду, которая прочитает файл. Мелкие файлы ложатся в бюджет ответа первыми; то, что не влезло, ответ в конце перечисляет одной командой git diff или git show. Файл никогда не обрывается посередине.
ЗАМЕР · CLAUDE OPUS 5.5
Один и тот же вопрос агенту — через git в терминале и через 🌱 Twig. Изменения настоящие, из истории наших проектов, возвращённые в рабочее дерево. Токены посчитал сам Claude.
меньше на вопросе «что изменено?»: 102–555 токенов против 295–1 112.
на чтении всех диффов и на разборе коммита. Код 🌱 Twig не сжимает: дифф стоит почти столько же, сколько у git.
вместо 5–9, чтобы агент прочитал всё нужное для сообщения коммита; коммит целиком — за 1–2.
| Изменение | git | 🌱 Twig | Разница |
|---|---|---|---|
Что изменено?git status + git diff --stat против list_changes | |||
| Исправление4 файла, +80 −2 | 2952 вызова | 1021 вызов | −65 % |
| Небольшая функция7 файлов, +154 −7 | 4012 вызова | 1691 вызов | −58 % |
| Крупная функция28 файлов, +1048 −44 | 1 1122 вызова | 5551 вызов | −50 % |
| Функция с новой зависимостью14 файлов, +726 −41, с package-lock.json | 6162 вызова | 3091 вызов | −50 % |
Прочитать всё для сообщения коммитаgit status, diff --stat, diff, log --oneline -10, cat новых файлов против list_changes diffs: true + git log --oneline -10 и дочитывание | |||
| Исправление4 файла, +80 −2 | 3 9035 вызовов | 3 5222 вызова | −10 % |
| Небольшая функция7 файлов, +154 −7 | 10 2406 вызовов | 9 7122 вызова | −5 % |
| Крупная функция28 файлов, +1048 −44 | 43 8259 вызовов | 41 9165 вызовов | −4 % |
| Функция с новой зависимостью14 файлов, +726 −41, с package-lock.json | 48 0639 вызовов | 43 8733 вызова | −9 % |
Разобрать коммит целикомgit show против get_commit и дочитывание того, что не влезло | |||
| Исправление4 файла, +80 −2 | 3 9651 вызов | 3 7801 вызов | −5 % |
| Небольшая функция7 файлов, +154 −7 | 10 3561 вызов | 9 9441 вызов | −4 % |
| Крупная функция28 файлов, +1048 −44 | 44 2781 вызов | 43 2472 вызова | −2 % |
| Функция с новой зависимостью14 файлов, +726 −41, с package-lock.json | 48 6891 вызов | 44 3852 вызова | −9 % |
git без выгоды (дифф одного файла, ханк по id, список коммитов, патч коммита отдельно от коммита), убраны. Claude Code с поиском инструментов загружает только те, что вызваны. На маленьком изменении описания всё равно дороже всей экономии.git show для всего, что не влезло, — это второй вызов, а не восемнадцать, как раньше.claude -p; его размер — разница входных токенов с ним и без него.git читает через cat — самый дешёвый способ. Всё, что 🌱 Twig пометил «не поместилось», дочитано той командой git, которую назвал ответ, — знания у обоих одинаковые. Список коммитов на стороне 🌱 Twig — тоже git log --oneline: короче его не сделать.node scripts/mcp-tokens.mjs --count — тексты всех ответов остаются в artifacts/mcp-tokens/.ПОИСК И BLAME · ТОТ ЖЕ ЗАМЕР
git log -S находит коммит, но отдаёт все ханки каждого найденного файла. search_history отдаёт несколько строк вокруг каждого совпадения. git blame — строка на строку, а get_blame — кусок на коммит и тему коммита один раз.
меньше на вопросе «когда появился или исчез этот код?»: 893–9 202 токена против 3 969–189 272 у git log -S … -p.
даже против того же вывода через grep -C3 — конвейера, который ещё надо написать и который теряет тему коммита, дату и номера строк.
на «кто и зачем менял эти строки»: −92…−95 %, 414–1 017 токенов против 5 120–19 922 у git blame и git log -1 на каждый коммит.
| Вопрос | git | 🌱 Twig | Разница |
|---|---|---|---|
Когда этот код появился или исчез?git log -S'…' -p против search_history; «с grep» — тот же вывод через grep -E -C3 '^(commit |diff --git )|…' | |||
plainFs1 коммит · 🌱 Twig | 3 969с grep: 1 816 | 1 3961 вызов | −65 %к grep −23 % |
readPreviousTag1 коммит · 🌱 Twig | 10 572с grep: 1 307 | 8931 вызов | −92 %к grep −32 % |
validateRevision2 коммита · 🌱 Twig | 38 448с grep: 4 045 | 3 4131 вызов | −91 %к grep −16 % |
undo.perform7 коммитов · 🌱 Twig | 107 882с grep: 12 286 | 9 2021 вызов | −91 %к grep −25 % |
requestAnimationFrame9 коммитов · Ghost Garden | 189 272с grep: 4 745 | 2 9921 вызов | −98 %к grep −37 % |
Кто и зачем менял эти строки?git blame + git log -1 на каждый найденный коммит против get_blame | |||
main/mcp/tools/history.jsстроки 90–144 · 2 коммита | 5 1203 вызова | 4141 вызов | −92 % |
HistoryWorkspace.jsxстроки 400–460 · 4 коммита | 6 9415 вызовов | 4341 вызов | −94 % |
main/git/history.jsвесь файл, 219 строк · 8 коммитов | 19 9229 вызовов | 1 0171 вызов | −95 % |
grep выигрыш скромнее: в обоих случаях агент читает примерно одни и те же строки кода, а 🌱 Twig вдобавок даёт тему коммита, дату и номера строк.git show, который прочитает файл целиком.get_blame не возвращает код: агент обычно уже прочитал файл. С code: true код приходит, этот вариант не мерили.git log -S'запрос' -p; для blame — git blame -L и git log -1 на каждый коммит, который он назвал.grep — для честности: такой конвейер агенты пишут редко.node scripts/mcp-tokens.mjs --only=search --count.9 ИНСТРУМЕНТОВ · 6 ЧИТАЮТ, 3 ПРЕДЛАГАЮТ КОММИТ
Обёрток над тем, что git и так отвечает коротко — git log --oneline, git diff -- файл, — нет: это агент запускает сам. Каждый инструмент принимает необязательный repository — имя, корень или любой путь внутри. Без него читается репозиторий рабочей папки агента, если он подключён, иначе открытый в 🌱 Twig — и тогда ответ первым делом называет его.
get_workspace_contextСводка: ветка, upstream, операция, счётчики файлов, выделенное в окне и остальные подключённые репозитории.
list_changesИзменённые файлы строками, как в git status, с +/− строк. С diffs: true — сразу с патчами, lock-файлы — строкой с командой git diff. Постранично.
get_commitКоммит одним вызовом: сообщение, автор, родители и патч каждого файла. Lock-файлы и огромные файлы — строкой с командой git show.
search_historyКогда код появился или исчез (-S, -G), по сообщению или автору. Возвращает только строки вокруг совпадения, а не дифф коммита.
get_blameКто и зачем менял строки: куски строк по коммитам и тема каждого коммита один раз. Номера строк — как в редакторе.
get_ui_contextЧто открыто в окне: вид, коммит, диапазон, файл. Чего 🌱 Twig не хранит — null.
propose_commitПредлагает коммит всех изменений с сообщением агента. Окно показывает файлы и сообщение, а переключатели — поднять ли версию и поставить ли тег; Commit, Commit & Push или Cancel — ваш выбор. Выключен, пока вы не разрешите.
new_versionПредлагает выпуск: коммит с поднятой версией (patch, minor или major) и тегом по образцу прошлого — v1.2.3 → v1.2.4. Версию и тег вы меняете переключателями; Commit & Push отправляет коммит и тег.
await_commitЖдёт вашего ответа дальше, если вы думаете дольше ~45 секунд, и отвечает тем же: хэш коммита, пуш или отмена.
СЦЕНАРИИ
Под каждой просьбой — инструменты, которые агенту хватит вызвать.
Агент одним вызовом читает все изменения с диффами и предлагает группы с сообщениями. Застейджить можно построчно в 🌱 Twig.
workspace → list_changes diffs
Индекс отдельно от рабочего дерева — то, что действительно уйдёт в коммит, с патчами.
list_changes diffs → staged:
Агент узнаёт выделенный коммит из окна и читает его сообщение и патчи одним вызовом.
get_ui_context → get_commit
Список коммитов агент берёт у git — короче не бывает, — затем подробности только по интересным.
git log --oneline → get_commit
Коммиты, где строка появилась или исчезла, и несколько строк вокруг каждого места — без диффов целиком.
search_history → get_commit
Кто последним менял строки 40–60 и тема каждого коммита — одним вызовом. Дальше — тот самый коммит.
get_blame → get_commit
ПОДКЛЮЧЕНИЕ · МИНУТА
Точная команда для вашей установки — в самом 🌱 Twig: кнопка MCP рядом с BugHunter, затем Copy.
Кнопка MCP в панели инструментов → MCP server: On. Выбор переживает перезапуск.
Скопируйте строку для Claude Code, таблицу для Codex или JSON для Cursor — пути уже подставлены.
Перезапустите агента и спросите о репозитории. Если 🌱 Twig закрыт, агент получит понятный ответ, а не тишину.
claude mcp add --scope user twig \
--env ELECTRON_RUN_AS_NODE=1 -- \
'/Applications/🌱 Twig.app/Contents/MacOS/🌱 Twig' \
'/Users/you/Library/Application Support/twig/mcp/twig-mcp.mjs'[mcp_servers.twig]
command = "/Applications/🌱 Twig.app/…/🌱 Twig"
args = ["…/twig/mcp/twig-mcp.mjs"]
env = { ELECTRON_RUN_AS_NODE = "1" }{ "mcpServers": { "twig": {
"command": "/Applications/🌱 Twig.app/…/🌱 Twig",
"args": ["…/twig/mcp/twig-mcp.mjs"],
"env": { "ELECTRON_RUN_AS_NODE": "1" } } } }Пути — пример для macOS. В Windows и Linux 🌱 Twig подставит свои; они показаны в окне MCP.
МОДЕЛЬ БЕЗОПАСНОСТИ
До выбора в 🌱 Twig нет ни сокета, ни слушателя. Выключили — сокет исчезает.
Unix-сокет в папке, которую открывает только ваша учётная запись (0700, сокет 0600); в Windows — named pipe. TCP нет.
Нет run_command, shell и инструментов записи. Чтения рабочего дерева не трогают индекс: GIT_OPTIONAL_LOCKS=0.
Агент не может указать произвольную папку: только подключённые в 🌱 Twig, пути проверяются на выход из репозитория.
Проверка 🌱 Twig вызывает каждый инструмент на настоящих репозиториях — с конфликтом merge, staged и unstaged правками, большими диффами — и сверяет папку .git и рабочее дерево побайтно до и после. Выделение в окне хранится только в памяти и никуда не записывается.
ЧЕСТНО
null.stage_hunk, create_branch — с тем же подтверждением в окне и тем же Undo, что у propose_commit.MACOS / WINDOWS / LINUX
MCP-сервер встроен в приложение: отдельная установка не нужна.
Версия 0.20.1Предварительная версия