agensic v0.3.0

Знайте, что выполнялось, где, когда и кем

Недостающий уровень наблюдаемости для терминальных рабочих процессов на базе ИИ

Signed Provenance Tracked Sessions Git Time Travel Replayable Sessions IDE style Tab Autocomplete

---

Agensic модернизирует ваш существующий терминальный рабочий процесс для эпохи ИИ. Он создан для разработчиков, которые хотят повышения продуктивности от ИИ-агентов прямо в своей оболочке, но не готовы идти на компромисс в отношении аудита, контроля и конфиденциальности.

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

Вместо того чтобы сводить всю активность терминала к одной неоднозначной «истории оболочки», Agensic выступает в роли криминалистического наблюдателя и умного второго пилота. Он бесшовно отслеживает интерактивные сессии кодирования с ИИ, криптографически подписывает команды, выполненные агентами, и обеспечивает молниеносное, основанное на истории автодополнение в стиле IDE через Tab.

---

📋 Содержание

1. Поддерживаемые платформы
2. Установка
3. Быстрый старт
4. Agensic Provenance
   • Возможности
   • Поддерживаемые метки
5. Agensic Sessions
   • Возможности
   • Поддерживаемые агенты
6. Agensic Autocomplete
   • Возможности
   • Поддерживаемые провайдеры
7. Доступные команды
8. Безопасность и конфиденциальность
9. Создатель проекта
10. Поддержка
11. Лицензия

---

💻 Поддерживаемые платформы

Agensic разработан для глубокой интеграции с вашей средой оболочки.

• macOS (Zsh) — полная поддержка ✅

• Linux (Bash) — полная поддержка ✅

---

🚀 Установка

Самый быстрый путь — управляемый установщик в одну строку:

curl -fsSL https://raw.githubusercontent.com/Alex188dot/agensic/main/bootstrap.sh | bash

Если вы предпочитаете клонировать вручную:

git clone https://github.com/Alex188dot/agensic.git
cd agensic
bash ./install.sh

Если у вас уже установлен uv, установщик будет использовать его автоматически для более быстрой настройки.

При первом запуске Agensic предложит вам выбрать предпочитаемого LLM-провайдера и настроить API-ключи для автодополнения команд.

В качестве альтернативы вы можете настроить LLM-провайдера и API-ключи, выполнив:

agensic setup

⚡ Быстрый старт

После настройки откройте новый терминал — Agensic автоматически начнёт отслеживать вашу активность в терминале и предлагать варианты автодополнения по мере ввода!

🤖 Бесшовное автоотслеживание агентов

Начните работать как обычно, например, используя вашего любимого ИИ-помощника по кодингу, такого как Claude Code, Codex CLI и т.д.:

claude

или

codex

См. раздел Поддерживаемые агенты для полного списка всех поддерживаемых агентов. Если вашего агента нет в списке, вы можете добавить его, выполнив agensic --add_agent "executable", а затем использовать его обычным образом, чтобы Agensic мог его отслеживать.

После завершения вы можете использовать Agensic для просмотра истории сессий:

agensic sessions

или просмотреть криминалистическую информацию о происхождении (provenance):

agensic provenance

---

🧾 Agensic Provenance

Agensic предоставляет вам криминалистическую стенограмму для каждой команды. Он классифицирует произошедшее, записывает богатые метаданные и формирует чёткий след аудита, чтобы вы могли определить, была ли команда введена вручную, принята из подсказки или выполнена непосредственно агентом.

✨ Возможности

🔍 Полноэкранный обозреватель происхождения

Нужно ответить на вопрос: «Что именно здесь выполнялось и кто это инициировал?» Выполните agensic provenance, чтобы открыть полноэкранный просмотрщик происхождения. Фильтруйте по метке, агенту, провайдеру или временному окну, просматривайте точный след команд и экспортируйте текущее представление в JSON или CSV, когда вам потребуется долговечная запись для отладки, разбора инцидента или соблюдения требований.

🛡️ Криптографическое происхождение и подпись команд

Перестаньте гадать, человек или ИИ сломал сборку. Agensic захватывает богатые метаданные для каждой команды и использует локальное подписание Ed25519, чтобы пометить выполненные агентом запуски неоспоримой меткой AI_EXECUTED. Вы получаете чёткую, поддающуюся аудиту временную шкалу, разделяющую нажатия клавиш человека, предложения ИИ и автоматические выполнения.

🏷️ Структурированные атрибутивные метки

Agensic не сводит историю терминала к сырому списку строк. Каждая отслеживаемая команда классифицируется по метке происхождения, что даёт вам единообразный способ фильтрации запусков, исследования поведения и понимания того, как команда попала в вашу оболочку.

🔖 Поддерживаемые метки

Agensic в настоящее время поддерживает следующие метки происхождения:

• AI_EXECUTED для команд, выполненных непосредственно агентом ИИ с подписанным доказательством
• HUMAN_TYPED для команд, вручную введённых человеком в оболочке
• AI_SUGGESTED_HUMAN_RAN для команд, предложенных внешним вызовом ИИ LLM, а затем выполненных человеком
• AG_SUGGESTED_HUMAN_RAN для команд, предложенных Agensic, а затем выполненных человеком
• INVALID_PROOF для команд, поступивших с метаданными доказательства, которые не прошли проверку
• UNKNOWN для команд, по которым имеющихся данных недостаточно для присвоения более строгой атрибутивной метки

---

🕵️‍♂️ Agensic Sessions

Agensic записывает интерактивные сессии агентов, предоставляя вам неоспоримое доказательство произошедшего и возможность безопасно манипулировать состоянием репозитория с помощью функции Time Travel.

✨ Возможности

▶️ Воспроизводимые сессии

Нужно провести аудит прошлой ночной сессии, чтобы понять, что произошло? Выполните agensic sessions и выберите сессию, которую хотите воспроизвести. Наш молниеносный полноэкранный TUI позволяет мгновенно просматривать временные шкалы, инспектировать полезные нагрузки и воспроизводить сессию. Когда вам нужно поделиться доказательствами для разбора инцидента, экспортируйте точный набор данных в JSON или CSV одним нажатием клавиши.

⏪ Time Travel