Skip to content
Back to search

ExelCode

Free terminal AI chat & coding agent powered by Gemini — zero API keys, zero cookies, zero dependencies. Pure Python 3.9+ for Linux, Windows & Termux.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/exelka--exelcode/badge.svg)](/listings/exelka--exelcode)

HTML

<a href="/listings/exelka--exelcode"><img src="/api/listings/exelka--exelcode/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 445 lines · 1 finding marked
  1. # ExelCode
  2. Консольный ИИ-чат и coding-агент на Gemini **без API-ключа, cookies и сторонних библиотек**.
  3. Использует анонимный веб-протокол `gemini.google.com`.
  4. ```
  5. ╭─ ExelCode 1.8.21 ──────────────────────────────────────────────╮
  6. │ чат: Новый чат модель: auto→3.5… │
  7. │ папка: ~/project /help │
  8. ╰───────────────────────────────────────────────────────────────╯
  9. user › explain HTTP/2 in simple terms, briefly
  10. agent · 3.5 Flash-Lite · 1.8s
  11. HTTP/2 is a newer version of the protocol used to load web pages.
  12. • multiplexing, header compression (HPACK), server push
  13. 286 chars · 1.8s · model 3.5 Flash-Lite · /copy
  14. ```
  15. ## Возможности
  16. - 💬 интерактивный чат со **стримингом** ответа;
  17. - 🧠 **долговременная память** — факты о вас (`/remember`);
  18. - 🗂 **чаты сохраняются** автоматически, можно открывать, переименовывать, удалять;
  19. - 🗜 **сжатие истории**: старая часть диалога пересказывается и живёт в памяти чата;
  20. - 🎛 **выбор модели** (`/model`), с показом фактической модели в подписи;
  21. - 🎭 **роль ассистента** (`/system`) — например, «отвечай как строгий редактор»;
  22. - 🔁 `/retry`, экспорт в markdown, статистика;
  23. - 🤖 **агент**: читает файлы проекта, создаёт и меняет их с diff, бэкапом и откатом; умеет читать фрагменты больших файлов и запускать проверки с авто-исправлением;
  24. - 🛡 **защита от опасных команд**: `rm -rf`, `sudo`, `curl | sh`, `git reset --hard` и подобные блокируются в auto-режиме и явно предупреждаются в `ask`;
  25. - 🧠 **состояние агента в чате**: недавние файлы и последняя задача сохраняются и помогают в «продолжай»;
  26. - ⚡ **умный режим**: сам понимает, когда нужно создать/изменить файл, а когда просто ответить текстом;
  27. - ⚙️ **`/settings`**: все настройки в одном месте, включая таймауты, лимиты и компактный UI;
  28. - 🩺 **`/debug`**: диагностика версии, путей, прокси, git и Gemini-протокола;
  29. - 🔄 **обновления при старте**: на каждом запуске проверяет версию и предлагает обновиться;
  30. - 📱 **компактный UI** для Termux и узких терминалов;
  31. - ⌨️ автодополнение команд по `Tab` и подсказки по `/`;
  32. - 🎨 markdown в терминале: списки, код, заголовки, переносы;
  33. - 🌈 **подсветка синтаксиса** в блоках кода: Python, JS/TS, C/C++/C#/Java, Go,
  34. Rust, Bash, Ruby, PHP, SQL, JSON, YAML, TOML, HTML/XML, CSS и diff;
  35. - 📦 только стандартная библиотека Python 3.9+;
  36. - 📱 работает в Termux и на обычном Linux.
  37. ## Запуск
  38. ```bash
  39. cd ExelCode
  40. python3 main.py
  41. ```
  42. Или через лаунчер:
  43. ```bash
  44. ./bin/aifree
  45. ```
  46. Один вопрос без REPL:
  47. ```bash
  48. python3 main.py -p "объясни, что такое HTTP/2, в двух абзацах"
  49. python3 main.py -p "..." --json
  50. ```
  51. ### Windows
  52. ```bat
  53. cd ExelCode
  54. python main.py
  55. :: или через лаунчер
  56. bin\aifree.cmd
  57. ```
  58. - нужен Python 3.9+ из `python.org` или Microsoft Store (необязательно);
  59. - в примерах ниже `python3` заменяйте на `python` — агент подменяет
  60. `python3` на текущий интерпретатор сам, когда запускает проверки;
  61. - данные лежат в `%LOCALAPPDATA%\ExelCode`, конфиг — в
  62. `%APPDATA%\ExelCode\config.json` (поддерживаются старые переменные `AIFREE_HOME` / `AIFREE_CONFIG` для обратной совместимости);
  63. - вывод переключается в UTF-8, ANSI-цвета включаются автоматически
  64. в Windows 10+ (в старом `cmd.exe` без VT цвета отключаются флагом
  65. `--no-color`);
  66. - автодополнение по `Tab` и история ввода требуют `readline` и работают
  67. в Linux/Termux; в Windows остальные команды доступны без изменений.
  68. Полезные флаги:
  69. ```bash
  70. python3 main.py --new # новый чат
  71. python3 main.py --chat 2 # открыть второй чат из списка
  72. python3 main.py --list # список чатов
  73. python3 main.py --models # список моделей
  74. python3 main.py -m flash # выбрать модель
  75. python3 main.py --no-stream # без стриминга
  76. python3 main.py --ephemeral -p "..." # не сохранять чат
  77. python3 main.py --check # проверить связь с Gemini
  78. python3 main.py --debug # диагностика (можно с --json)
  79. python3 main.py --agent --workspace ~/project --yes -p "создай hello.py"
  80. python3 main.py --agent --workspace ~/project --dry-run -p "..."
  81. python3 main.py --agent --agent-mode plan -p "покажи план"
  82. python3 main.py --agent --undo # откатить последние изменения агента
  83. python3 main.py --agent --backups # точки отката
  84. ```
  85. ## Команды в чате
  86. `/help` показывает команды по группам, сокращения и подсказки, а
  87. `/help <команда>` — подробное описание и примеры (например, `/help agent`).
  88. ### Чат
  89. | Команда | Что делает |
  90. |---|---|
  91. | `/new [название]` | создать новый чат и переключиться на него; текущий сохраняется |
  92. | `/chats` | список сохранённых чатов: номер, название, число сообщений, время |
  93. | `/open <номер\|id>` | открыть чат по номеру из `/chats` или по id |
  94. | `/rename <название>` | переименовать текущий чат (без аргумента покажет название) |
  95. | `/delete [номер\|id\|all]` | удалить чат с подтверждением; `all` — удалить все чаты и глобальную память |
  96. | `/reset [all]` | очистить историю текущего чата; `all` — сбросить настройки/чаты/память/кэш/данные |
  97. | `/export [файл]` | сохранить чат в markdown; без аргумента — в папку exports |
  98. | `/retry` | удалить последний ответ и заново отправить последний вопрос |
  99. ### Ответ и модель
  100. | Команда | Что делает |
  101. |---|---|
  102. | `/model [имя\|номер]` | выбрать модель: без аргумента — меню, можно `auto`/`flash`/`lite` или номер |
  103. | `/models` | список доступных маршрутов моделей и их описание |
  104. | `/stream on\|off` | включить/выключить печать ответа по мере генерации (сохраняется) |
  105. | `/copy` | скопировать последний ответ в буфер обмена |
  106. | `/system [текст]` | задать роль ассистента; `reset` — сбросить, без аргумента — показать |
  107. ### Память
  108. | Команда | Что делает |
  109. |---|---|
  110. | `/memory` | показать факты о вас, которые добавляются в каждый запрос |
  111. | `/memory clear` | очистить всю долговременную память (с подтверждением) |
  112. | `/remember <факт>` | запомнить факт; без аргумента спросит текст |
  113. | `/forget <номер>` | забыть факт по номеру из `/memory` |
  114. ### Агент
  115. | Команда | Что делает |
  116. |---|---|
  117. | `/agent [задача]` | без аргумента — меню; с текстом — задача по файлам в папке проекта |
  118. | `/workspace [путь]` | папка проекта агента; `.` — текущая, `reset`/`~` — домашняя |
  119. | `/agentmode [режим]` | `ask` — спрашивать, `auto` — применять сразу, `plan` — только план и diff |
  120. | `/smart on\|off` | сам решает: обычный вопрос — чат, просьба изменить файлы — агент |
  121. | `/agentchat on\|off` | отправлять агенту все обычные сообщения (выключает `/smart`) |
  122. | `/run <команда>` | выполнить команду в папке агента с подтверждением и предупреждениями |
  123. | `/undo` | откатить последние изменения агента из бэкапа |
  124. | `/backups` | список точек отката: время, число файлов, статус, путь |
  125. Подкоманды `/agent`: `menu`, `workspace <путь>`, `mode <режим>`, `undo`,
  126. `backups`, `run <команда>`, `on`/`off` (то же, что `/agentchat`), `smart`.
  127. Задачу можно начать со слова `plan`, `auto` или `ask`, чтобы выбрать режим
  128. только для этого запуска.
  129. ### Обновления и диагностика
  130. | Команда | Что делает |
  131. |---|---|
  132. | `/update` | проверить версию на GitHub, установить и перезапустить |
  133. | `/check` | короткий тестовый запрос в Gemini: время ответа и модель |
  134. | `/debug [--no-net]` | версия, Python, платформа, пути, прокси, git, доступность `cfb2h` |
  135. | `/proxy [режим\|команда]` | прокси: `off/auto/always`, список, добавить/удалить свой прокси |
  136. | `/settings [ключ значение]` | все настройки и их изменение (`/settings timeout 90`) |
  137. ### Интерфейс
  138. | Команда | Что делает |
  139. |---|---|
  140. | `/stats` | чат, модель, сообщения, пересказ, память, папка и режим агента, пути |
  141. | `/clear` | очистить экран и заново нарисовать баннер (в пайпе — пустая строка) |
  142. | `/compact [auto\|on\|off]` | компактный UI: `auto` в Termux/узких экранах, `on`/`off` вручную |
  143. | `/about` | версия, протокол и папка данных |
  144. | `/help [команда]` | список команд по группам или подробная справка по одной |
  145. | `/quit` | сохранить чат и историю ввода и выйти (`/exit`, `/q`) |
  146. Сокращения: `/h` `/ ?` — справка, `/ls` `/list` — чаты, `/rm` — удалить,
  147. `/title` — переименовать, `/mem` — запомнить, `/cls` — очистить экран,
  148. `/ws` — папка, `/amode` `/mode` — режим, `/do` — агент, `/achat` — чат→агент,
  149. `/dbg` — диагностика, `/config` `/cfg` — настройки, `/version` — о программе.
  150. Дополнительно:
  151. - перенос строки в запросе — `\` в конце строки;
  152. - `Ctrl-C` во время ответа останавливает генерацию и сохраняет часть ответа;
  153. - `Ctrl-C` в приглашении `user ›` (или `agent ›`) — выход;
  154. - `Tab` — автодополнение команд (`/ag` → `/agent`) и аргументов (`/smart o` → `on`, пути, номера чатов).
  155. ## Настройки, диагностика и компактный режим
  156. `/settings` показывает все текущие значения. Менять можно точечно:
  157. ```text
  158. /settings timeout 90
  159. /settings compact_ui on # auto | on | off
  160. /settings agent_run_timeout 120
  161. /settings agent_max_diff_lines 80
  162. ```
  163. `/debug` собирает сведения для багрепорта: версию, Python, платформу, пути,
  164. прокси, git-ветку/коммит, кэш обновлений и доступность `cfb2h`.
  165. `/debug --no-net` не ходит в сеть, `--debug --json` даёт машинный вывод.
  166. На узких экранах и в Termux включается компактный вывод: баннер без рамки,
  167. короче подписи и diff. Управление — `/settings compact_ui auto|on|off`
  168. или переменная `EXELCODE_COMPACT=1/0`. По умолчанию `auto`; в Termux при
  169. активном компактном режиме под баннером показывается `✓ Termux UI`.
  170. ## Прокси
  171. По умолчанию включён режим `auto`: прямое соединение, а при сетевой ошибке
  172. (таймаут, DNS, обрыв соединения) ExelCode автоматически пробует прокси по
  173. очереди и пишет в чат, что подключает прокси (в комплекте 50, если один
  174. не отвечает — берётся следующий).
  175. ```text
  176. /proxy auto # по умолчанию: fallback при сетевой ошибке
  177. /proxy always # всегда через прокси
  178. /proxy off # выключить
  179. /proxy list # список (50 встроенных + свои)
  180. /proxy add 1.2.3.4:8080
  181. /proxy remove 1
  182. ```
  183. HTTP-ошибки от Google (403/429/5xx) не считаются «пропал интернет» и не
  184. переключают на прокси. Мёртвые прокси временно пропускаются.
  185. В комплекте есть 50 бесплатных HTTP-прокси; свои добавляются в
  186. `~/.local/share/exelcode/proxies.txt` (Windows: `%LOCALAPPDATA%\ExelCode\proxies.txt`).
  187. Бесплатные прокси ненадёжны и потенциально небезопасны — не используйте
  188. их для чувствительных данных и учитывайте, что это сторонние серверы.
  189. ## Подсветка кода
  190. Блоки ``` с языком красятся без Pygments и без интернета:
  191. - ключевые слова — фиолетовым, строки — зелёным, числа — жёлтым;
  192. - комментарии — серым, функции — голубым, встроенные имена — синим;
  193. - JSON/YAML/TOML — ключи и значения, diff — добавления и удаления;
  194. - многострочные строки и комментарии сохраняют цвет между строками;
  195. - неизвестный язык — базовая подсветка строк, чисел и комментариев.
  196. Цвета отключаются флагом `--no-color`, переменной `NO_COLOR` или когда вывод
  197. идёт не в терминал (например, в файл или в пайп).
  198. ## Агент
  199. Агент работает прямо внутри приложения — CLI-команды для каждой задачи не нужны.
  200. **Рекомендуемый режим:**
  201. ```text
  202. /smart on
  203. ```
  204. После этого можно писать обычным языком без `/agent`:
  205. - `создай file.py с print("Hello, World!")` → агент сам создаст файл (автоматически);
  206. - `объясни, что такое HTTP/2` → обычный ответ в чате.
  207. Команды агента:
  208. - `/smart on|off` — умный режим: сам решает, ответить текстом или выполнить действие;
  209. - `/agent [задача]` — меню агента или явная задача по файлам;
  210. - `/agentchat on|off` — отправлять агенту **все** обычные сообщения;
  211. - `/workspace [путь]` — папка проекта (без аргумента — спросит);
  212. - `/agentmode [ask|auto|plan]` — подтверждение: спрашивать / авто / только план;
  213. - `/run <команда>` — запустить команду в папке проекта;
  214. - `/undo`, `/backups` — откат и точки восстановления.
  215. Важно: обычный чат без `/smart`, `/agent` и `/agentchat` **не создаёт файлы на диске** — он только отвечает текстом/кодом.
  216. ### Что умеет
  217. - исследует дерево и запрашивает нужные файлы;
  218. - читает **фрагменты больших файлов**: `READ: path.py:1-120`;
  219. - создаёт, точечно правит (`patch`) и удаляет файлы;
  220. - показывает **план и diff** перед записью;
  221. - сохраняет **бэкап** каждого применения и умеет откатывать;
  222. - может запрашивать **проверки** (`run`: тесты, линтер, запуск) и, получив вывод/код возврата, вносить исправления в несколько шагов.
  223. Протокол (формирует модель, вам писать его вручную не нужно):
  224. ````
  225. READ: relative/path.py
  226. READ: relative/path.py:10-80
  227. ```file path="relative/path.py"
  228. …
  229. ```
  230. ```patch path="relative/path.py"
  231. <<<<<<< SEARCH
  232. …
  233. =======
  234. …
  235. >>>>>>> REPLACE
  236. ```
  237. ```delete path="relative/path.py"
  238. ```
  239. ```run
  240. python3 -m pytest -q
  241. ```
  242. ````
  243. ### Режимы
  244. - `ask` — спрашивать перед записью файлов и запуском команд (по умолчанию);
  245. - `auto` — применять изменения и запускать проверки без вопросов;
  246. - `plan` — только показать план/diff/запрошенные команды, ничего не менять.
  247. CLI-аналоги: `--agent-mode ask|auto|plan`, `--yes`, `--dry-run`.
  248. ```bash
  249. # интерактивно (в чате): /agent → меню
  250. python3 main.py
  251. # одной строкой
  252. python3 main.py --agent --workspace ~/project -p "добавь тесты и почини падающие"
  253. python3 main.py --agent --workspace ~/project --agent-mode plan -p "покажи план"
  254. python3 main.py --workspace ~/project --undo
  255. ```
  256. Безопасность:
  257. - пути только относительные, внутри `--workspace`;
  258. - запрещены `..`, `~`, `.git`, `.env`, ключи, бинарные файлы;
  259. - `SEARCH` в patch должен совпадать ровно один раз;
  260. - перед записью — подтверждение и резервная копия; команды запускаются с подтверждением;
  261. - опасные команды (`rm -rf`, `sudo`, `curl | sh`, `git reset --hard`, `del /s`,
  262. `mkfs`, `shutdown` и т.п.) в auto-режиме **блокируются**, а в `ask`
  263. показываются с явным предупреждением;
  264. - откат: `/undo` или `--undo`, список — `/backups`/`--backups`;
  265. - при не-интерактивном запуске без `--yes` агент работает в режиме плана.
  266. Конфиг (`~/.config/exelcode/config.json`, на Windows — `%APPDATA%\ExelCode\config.json`):
  267. ```json
  268. {
  269. "agent_workspace": "/path/to/project",
  270. "agent_mode": "auto",
  271. "agent_chat": false,
  272. "smart_route": true,
  273. "agent_context_chars": 30000,
  274. "agent_max_rounds": 6,
  275. "agent_max_edit_rounds": 4,
  276. "agent_max_fix_rounds": 4,
  277. "agent_run_timeout": 60,
  278. "agent_run_output_chars": 8000,
  279. "agent_max_diff_lines": 120,
  280. "compact_ui": "auto",
  281. "proxy_mode": "auto"
  282. }
  283. ```
  284. ## Модели
  285. | id | Что это |
  286. |---|---|
  287. | `auto` | автовыбор Google: может попасться Hydrogen, иначе Flash с веб-доступом |
  288. | `flash` | маршрут Gemini 3.6 Flash |
  289. | `lite` | Gemini 3.5 Flash-Lite |
  290. Без входа в Google анонимные запросы фактически обслуживает **3.5 Flash-Lite**,
  291. поэтому в подписи ответа показывается реальная модель, которую вернул сервер.
  292. Если Google откроет анонимный доступ к другим моделям, достаточно добавить их
  293. hex-id в `aifree/gemini.py` → `MODELS`.
  294. ## Память и контекст
  295. - **Краткосрочная память** — последние сообщения чата; они попадают в промпт.
  296. - **Долговременная память** — список фактов в `memory.json`, добавляется в каждый запрос.
  297. - **Пересказ** — когда в чате накапливается больше 16 сообщений, старая часть
  298. сжимается Gemini в 5–10 пунктов и заменяет её в контексте. Сами сообщения
  299. остаются в файле чата и в экспорте.
  300. Промпт собирается как один запрос: `<system>`, `<memory>`, `<summary>`,
    • Warning: Contains a <system> block, a common wrapper for instructions hidden in a tool description
    • Line 376 on GitHub
  301. `<dialogue>`, `<user>`. Это надёжно работает с анонимным веб-протоколом, который
  302. не хранит серверную сессию.
  303. ## Где лежат данные
  304. ```
  305. ~/.local/share/exelcode/
  306. ├── chats/<id>.json # chats
  307. ├── memory.json # long-term memory
  308. ├── exports/ # markdown exports
  309. ├── backups/ # agent backups
  310. ├── update_check.json # кэш проверки обновлений
  311. └── history # readline history
  312. ~/.config/exelcode/config.json # model, stream, last chat
  313. ```
  314. Override with `EXELCODE_HOME` / `EXELCODE_CONFIG` (legacy `AIFREE_HOME` / `AIFREE_CONFIG` also supported).
  315. On Windows by default: `%LOCALAPPDATA%\ExelCode\` for data and `%APPDATA%\ExelCode\config.json` for config.
  316. ## Как это работает
  317. 1. `GET https://gemini.google.com/app` — берём номер сборки `cfb2h`.
  318. 2. `POST .../BardChatUi/data/.../StreamGenerate` с form-полем `f.req`
  319. (массив из 99 слотов, модель задаётся заголовком `x-goog-ext-525001261-jspb`).
  320. 3. Читаем поток `wrb.fr` построчно; кадры содержат накопительный текст,
  321. поэтому приложение печатает только приращение.
  322. 4. Если запрос не удался — один повтор на запасной модели и свежий `cfb2h`.
  323. ## Ограничения
  324. - Это **неофициальный** веб-протокол. Google может изменить его в любой момент,
  325. включить капчу или ограничить частоту запросов.
  326. - Анонимный режим обычно отдаёт только **3.5 Flash-Lite**.
  327. - Бесплатный режим Google может использовать запросы для улучшения продуктов.
  328. **Не отправляйте пароли, ключи и чужие персональные данные.**
  329. - Нет вложений, картинок и инструментов — только текст.
  330. - Один запрос = один ответ; серверная история не используется, контекст
  331. собирается локально.
  332. - Агент меняет файлы и запускает команды только после подтверждения (кроме режима `auto`) и только внутри `--workspace`; не подтверждайте опасные команды и не запускайте агента на папках без бэкапа или git.
  333. ## Тесты
  334. Быстрые тесты без сети (90 тестов), включая фикстуры Gemini и smoke-тесты CLI:
  335. ```bash
  336. python3 -m unittest discover -s tests -v
  337. python -m unittest discover -s tests -v # Windows
  338. ```
  339. ## Структура
  340. ```
  341. ExelCode/
  342. ├── main.py # entry point
  343. ├── bin/aifree(.cmd) # launcher
  344. ├── aifree/ # core package (cli, ui, gemini, agent, store, prompt, render, highlight, config, console, update, diagnostics)
  345. ├── tests/ # offline tests + fixtures/gemini
  346. ├── README.md
  347. └── ПРОГРЕСС.md
  348. ```
  349. ## Если что-то сломалось
  350. - `Google отклонил анонимный запрос (403)` — подождите несколько минут.
  351. - `429` — слишком часто; сделайте паузу.
  352. - `Gemini: на странице нет cfb2h` — Google поменял страницу; проверьте
  353. `PAGE_URL`/`RPC_URL` в `aifree/gemini.py`.
  354. - Ответов нет вообще — проверьте сеть: `curl -I https://gemini.google.com/app`.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.