Криптографическая криминалистика терминала и воспроизведение сессий для AI-агентов. Отслеживает, подписывает и аудирует каждую команду с метками происхождения, воспроизводимыми сессиями и Git-путешествиями во времени. Приоритет конфиденциальности с локальным хранилищем SQLite и редактированием секретов.
<p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/4480e118bb0f8f08f64f7da7573729d0dc6641679e7781e4c4050d939ea4d1b2.png" alt="Логотип Agensic" width="100%" /> </p> <h2 align="center">Знайте, что выполнялось, где, когда и кем</h2> <h3 align="center">Недостающий уровень наблюдаемости для терминальных рабочих процессов на базе ИИ</h3> <p align="center"> <code>Signed Provenance</code> <code>Tracked Sessions</code> <code>Git Time Travel</code> <code>Replayable Sessions</code> <code>IDE style Tab Autocomplete</code> </p> --- Agensic модернизирует ваш существующий терминальный рабочий процесс для эпохи ИИ. Он создан для разработчиков, которые хотят повышения продуктивности от ИИ-агентов прямо в своей оболочке, но не готовы идти на компромисс в отношении **аудита, контроля и конфиденциальности**. Поскольку ИИ-агенты всё чаще берут на себя командную строку и выполняют задачи автономно, видимость и контроль становятся критически важными. Agensic рассматривает **команды терминала как граждан первого сорта** и предоставляет надёжную платформу для отслеживания, инспекции и управления ими. Вместо того чтобы сводить всю активность терминала к одной неоднозначной «истории оболочки», Agensic выступает в роли криминалистического наблюдателя и умного второго пилота. Он бесшовно отслеживает интерактивные сессии кодирования с ИИ, криптографически подписывает команды, выполненные агентами, и обеспечивает молниеносное, основанное на истории автодополнение в стиле IDE через Tab. --- ## 📋 Содержание 1. [Поддерживаемые платформы](#-platform-support) 2. [Установка](#-installation) 3. [Быстрый старт](#-quick-start) 4. [Agensic Provenance](#-agensic-provenance) - [Возможности](#-features-provenance) - [Поддерживаемые метки](#-supported-labels) 5. [Agensic Sessions](#-agensic-sessions) - [Возможности](#-features-sessions) - [Поддерживаемые агенты](#-supported-agents) 6. [Agensic Autocomplete](#-agensic-autocomplete) - [Возможности](#-features-autocomplete) - [Поддерживаемые провайдеры](#-supported-providers) 7. [Доступные команды](#-available-commands) 8. [Безопасность и конфиденциальность](#-safety--privacy) 9. [Создатель проекта](#-project-creator) 10. [Поддержка](#-support) 11. [Лицензия](#-license) --- ## 💻 <a id="-platform-support"></a>Поддерживаемые платформы Agensic разработан для глубокой интеграции с вашей средой оболочки. - macOS (Zsh) — полная поддержка ✅ - Linux (Bash) — полная поддержка ✅ --- ## 🚀 <a id="-installation"></a>Установка Самый быстрый путь — управляемый установщик в одну строку: ```bash curl -fsSL https://raw.githubusercontent.com/Alex188dot/agensic/main/bootstrap.sh | bash ``` Если вы предпочитаете клонировать вручную: ```bash git clone https://github.com/Alex188dot/agensic.git cd agensic bash ./install.sh ``` Если у вас уже установлен `uv`, установщик будет использовать его автоматически для более быстрой настройки. При первом запуске Agensic предложит вам выбрать предпочитаемого LLM-провайдера и настроить API-ключи для автодополнения команд. В качестве альтернативы вы можете настроить LLM-провайдера и API-ключи, выполнив: ```bash agensic setup ``` ## ⚡ <a id="-quick-start"></a>Быстрый старт После настройки **откройте новый терминал** — Agensic автоматически начнёт отслеживать вашу активность в терминале и предлагать варианты автодополнения по мере ввода! ### 🤖 Бесшовное автоотслеживание агентов Начните работать как обычно, например, используя вашего любимого ИИ-помощника по кодингу, такого как Claude Code, Codex CLI и т.д.: ```bash claude ``` или ```bash codex ``` См. раздел [Поддерживаемые агенты](#-supported-agents) для полного списка всех поддерживаемых агентов. Если вашего агента нет в списке, вы можете добавить его, выполнив <code>agensic --add_agent "executable"</code>, а затем использовать его обычным образом, чтобы Agensic мог его отслеживать. После завершения вы можете использовать Agensic для просмотра истории сессий: ```bash agensic sessions ``` или просмотреть криминалистическую информацию о происхождении (provenance): ```bash agensic provenance ``` --- ## 🧾 <a id="-agensic-provenance"></a>Agensic Provenance Agensic предоставляет вам криминалистическую стенограмму для каждой команды. Он классифицирует произошедшее, записывает богатые метаданные и формирует чёткий след аудита, чтобы вы могли определить, была ли команда введена вручную, принята из подсказки или выполнена непосредственно агентом. <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/954db235102e042437af9e18befe1d48176d543e55a5bd8ba5cc3ff7a8396f41.gif" alt="Демонстрация Agensic provenance" width="75%" /> </p> ### <a id="-features-provenance"></a>✨ Возможности ### 🔍 Полноэкранный обозреватель происхождения <p> Нужно ответить на вопрос: «Что именно здесь выполнялось и кто это инициировал?» Выполните <code>agensic provenance</code>, чтобы открыть полноэкранный просмотрщик происхождения. Фильтруйте по метке, агенту, провайдеру или временному окну, просматривайте точный след команд и экспортируйте текущее представление в JSON или CSV, когда вам потребуется долговечная запись для отладки, разбора инцидента или соблюдения требований. </p> ### 🛡️ Криптографическое происхождение и подпись команд <p> Перестаньте гадать, человек или ИИ сломал сборку. Agensic захватывает богатые метаданные для каждой команды и использует локальное подписание Ed25519, чтобы пометить выполненные агентом запуски неоспоримой меткой <code>AI_EXECUTED</code>. Вы получаете чёткую, поддающуюся аудиту временную шкалу, разделяющую нажатия клавиш человека, предложения ИИ и автоматические выполнения. </p> ### 🏷️ Структурированные атрибутивные метки <p> Agensic не сводит историю терминала к сырому списку строк. Каждая отслеживаемая команда классифицируется по метке происхождения, что даёт вам единообразный способ фильтрации запусков, исследования поведения и понимания того, как команда попала в вашу оболочку. </p> ### <a id="-supported-labels"></a>🔖 Поддерживаемые метки Agensic в настоящее время поддерживает следующие метки происхождения: - <code>AI_EXECUTED</code> для команд, выполненных непосредственно агентом ИИ с подписанным доказательством - <code>HUMAN_TYPED</code> для команд, вручную введённых человеком в оболочке - <code>AI_SUGGESTED_HUMAN_RAN</code> для команд, предложенных внешним вызовом ИИ LLM, а затем выполненных человеком - <code>AG_SUGGESTED_HUMAN_RAN</code> для команд, предложенных Agensic, а затем выполненных человеком - <code>INVALID_PROOF</code> для команд, поступивших с метаданными доказательства, которые не прошли проверку - <code>UNKNOWN</code> для команд, по которым имеющихся данных недостаточно для присвоения более строгой атрибутивной метки --- ## 🕵️♂️ <a id="-agensic-sessions"></a>Agensic Sessions Agensic записывает интерактивные сессии агентов, предоставляя вам неоспоримое доказательство произошедшего и возможность безопасно манипулировать состоянием репозитория с помощью функции Time Travel. <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/5a2de01b27f96092f2a728dcd93c9368336747306cea978c81b18ad3b6714f5e.gif" alt="Демонстрация воспроизведения Agensic" width="75%" /> </p> ### <a id="-features-sessions"></a>✨ Возможности ### ▶️ Воспроизводимые сессии <p> Нужно провести аудит прошлой ночной сессии, чтобы понять, что произошло? Выполните <code>agensic sessions</code> и выберите сессию, которую хотите воспроизвести. Наш молниеносный полноэкранный TUI позволяет мгновенно просматривать временные шкалы, инспектировать полезные нагрузки и воспроизводить сессию. Когда вам нужно поделиться доказательствами для разбора инцидента, экспортируйте точный набор данных в JSON или CSV одним нажатием клавиши. </p> ### ⏪ Time Travel <p> Когда-нибудь задавались вопросом: «Как выглядел мой репозиторий непосредственно перед тем, как агент сделал тот разрушительный коммит?» Time Travel позволяет вам отмотать репозиторий назад к точному состоянию Git, захваченному в определённой контрольной точке сессии. Agensic безопасно восстанавливает неотслеживаемые и изменённые файлы в новую ветку, гарантируя, что вы никогда случайно не уничтожите живое рабочее дерево во время расследования. </p> ### 🗄️ Устойчивое локальное состояние <p> Ваши данные остаются вашими. Agensic использует надёжную серверную часть SQLite с журналом событий только для добавления и автоматическим созданием снэпшотов. Это означает, что ваша криминалистическая история переживёт неожиданные крахи терминала, перезагрузки системы и длительное локальное использование без повреждений. </p> ### <a id="-supported-agents"></a>🤖 Поддерживаемые агенты Agensic предоставляет поддержку набора предварительно настроенных встроенных агентов, которые можно отслеживать: - Claude Code - Codex CLI - Gemini CLI - OpenClaw - OpenCode - Kimi Code - Mini Agent - Qwen Code - GitHub Copilot CLI - Kiro CLI - Cline CLI - Cursor CLI - Nanoclaw - Droid - Hermes Agent - Ollama - Mistral Vibe - Aider - Pi.dev - Kilo Code - Continue CLI Пользовательские агенты: вставьте любой исполняемый файл агента в настройки Agensic, и он будет работать сразу без какой-либо конфигурации. --- ## ⚡ <a id="-agensic-autocomplete"></a>Agensic Autocomplete Agensic переосмысливает подсказки в терминале. Контекстно-зависимые, семантические и всегда быстрые, в стиле IDE, удовлетворяющие автодополнению через Tab. <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/f710d6a7c01b14691b1d825894e1640c2a92ff1642178a5aed2b3d7d0ac241e3.gif" alt="Демонстрация автодополнения Agensic" width="50%" /> </p> ### <a id="-features-autocomplete"></a>✨ Возможности ### 🚀 Молниеносные предложения из локальной истории <p> Попрощайтесь с задержками ввода. По мере ввода Agensic запрашивает хранилище вашей фактической истории команд. Предложения появляются мгновенно в виде призрачного текста, который можно легко принять с помощью <code>Tab</code>. Поскольку он учится на ваших шаблонах и опирается на то, что вы действительно делаете, предложения очень точны и учитывают контекст репозитория. </p> ### 🧠 Семантический поиск и исправление опечаток <p> Люди ошибаются, Agensic их исправляет. Если вы введёте <code>dokcer</code>, Agensic мгновенно предложит <code>Вы, вероятно, имели в виду: docker</code>. Не можете вспомнить точный синтаксис? Семантическое переранжирование спасает ваше намерение, находя правильную команду, даже если ваш префикс не совпадает идеально: если вы введёте <code>docker records</code>, вы получите <code>Вы, вероятно, имели в виду: docker logs</code> (при условии, что вы ранее выполняли <code>docker logs</code>). </p> ### 💡 Резервный вызов ИИ по требованию <p> ИИ — это мощный резерв, а не налог на каждое нажатие клавиши. Agensic устанавливает лимиты LLM на каждую строку, чтобы предотвратить спам подсказок. Когда локальной истории недостаточно, будет активирован автоматический резервный вызов LLM. В качестве альтернативы вы всегда можете нажать <code>Ctrl+Space</code>, чтобы вручную получить интеллектуальную подсказку от вашего предпочитаемого локального или хостируемого LLM. </p> ### 💬 Режимы команд на естественном языке <p> Забудьте о точном синтаксисе, просто опишите, что вам нужно. Введите что-то вроде: <code># как я могу найти все файлы размером более 10 МБ в этой папке?</code>. Agensic генерирует 3 готовых к использованию команды оболочки и вставляет наиболее вероятный вариант прямо в вашу следующую строку. Нужны указания вместо команд? Используйте режим помощника, чтобы получить пошаговые ответы прямо в терминале: <code>## Как установить Node на macOS?</code>. Хотите понять команду перед её выполнением? Используйте: <code>agensic --explain "ваша команда здесь"</code> </p> ### 🛡️ Сохранение Tab и блокировка рискованных команд <p> Agensic уважает ваш терминал. Он не перехватывает <code>Tab</code>, когда вы завершаете пути к файлам или сценарии, так что нативное завершение оболочки побеждает там, где оно лучше всего. Что более важно, разрушительные команды (например, <code>rm -rf</code>, <code>mkfs</code> или <code>dd</code>) строго блокируются в пулах предложений, так что вы никогда случайно не выполните катастрофическую команду. </p> ### <a id="-supported-providers"></a>🌐 Поддерживаемые провайдеры Agensic вписывается в ваш стек, независимо от того, запускаете ли вы модели локально или используете хостируемые конечные точки. - **Локальные:** Ollama, LM Studio - **Хостируемые:** OpenAI, Anthropic, Gemini, Azure, DeepSeek, Groq, Mistral, Qwen (DashScope), MiniMax, Moonshot, OpenRouter, Xiaomi MiMo, Z.AI, AWS SageMaker - **Пользовательские:** любая конечная точка, совместимая с OpenAI - **Только история:** работайте полностью офлайн без вызовов ИИ, используя только вашу локальную историю команд ## 🧰 <a id="-available-commands"></a>Доступные команды В таблице ниже перечислены все команды CLI, доступные в Agensic. | Команда | Что делает | | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | <code>agensic --help</code> | Показать основную справку CLI и все стандартные пользовательские команды | | <code>agensic --version</code> | Вывести установленную версию Agensic и завершить работу | | <code>agensic update</code> | Загрузить и установить последний опубликованный релиз Agensic на GitHub | | <code>agensic setup</code> | Открыть интерактивный процесс настройки для Agensic Sessions и Autocomplete | | <code>agensic enable-startup</code> | Настроить Agensic для автоматического запуска при входе в систему или загрузке | | <code>agensic first-run</code> | Запустить процесс первичной настройки | | <code>agensic start</code> | Запустить фоновый демон Agensic вручную | | <code>agensic stop</code> | Остановить демон Agensic | | <code>agensic logs</code> | Просматривать вывод лога демона в реальном времени | | <code>agensic test</code> | Отправить тестовый запрос автодополнения демону для проверки подключения | | <code>agensic provenance</code> | Открыть представление истории происхождения команд. Поддерживает фильтры, такие как <code>--limit</code>, <code>--label</code> и <code>--contains</code> | | <code>agensic sessions</code> | Открыть браузер отслеживаемых сессий. Используйте <code>--text</code> для вывода в виде простого текста | ## 🔒 <a id="-safety--privacy"></a>Безопасность и конфиденциальность Agensic работает по принципу минимальных привилегий и максимальной конфиденциальности: - **Локальная аутентификация:** все маршруты API на localhost строго аутентифицируются с автоматической ротацией токенов - **Редактирование секретов:** значения с высокой энтропией, учётные данные в URL и известные форматы секретов (например, ключи AWS или JWT) удаляются и маскируются **до того**, как какие-либо данные покинут вашу машину для вызова LLM - **Ограничения команд:** разрушительные команды жёстко блокируются как в механизме предложений, так и в контуре обратной связи - **Ограничение скорости:** исходящие вызовы LLM ограничены строгими тайм-аутами и лимитами для предотвращения злоупотребления API --- ## <a id="-project-creator"></a>👤 Создатель проекта Alessio Leodori ## <a id="-support"></a>🤝 Поддержка Нашли Agensic полезным? Поставьте звезду ⭐️ репозиторию и расскажите друзьям! Это поможет нам расти 🌱 ## 📄 <a id="-license"></a>Лицензия Agensic имеет открытый исходный код и лицензирован в соответствии с **Apache-2.0 License**.
