AgentOps

Кодовые агенты не ведут собственный учёт.

AgentOps — операционный слой для кодовых агентов. Он добавляет ведение журнала, валидацию, примитивы и потоки выполнения, чтобы каждая сессия начиналась с того места, где закончилась предыдущая.

Установка · Быстрый старт · Скиллы · CLI · Доктрина · Документация

Что даёт AgentOps

AgentOps предоставляет кодовому агенту четыре вещи, которых у него нет по умолчанию:

В сессии 1 агент тратит два часа на отладку таймаута. В сессии 15 новый агент находит решение за секунды, потому что репозиторий сохранил этот урок.

Под капотом AgentOps работает как компилятор контекста: сырой сигнал сессии превращается в переиспользуемые знания, накопленные предотвращения ошибок и улучшенный контекст для следующей работы.

flowchart LR
    S[Работа в сессии] --> B[Журналирование]
    S --> V[Валидация]
    B --> F[Маховик знаний]
    V --> F
    F --> N[Следующая сессия]
    N --> S

Локально и прозрачно: .agents/ — это обычный текст, который можно искать через grep, сравнивать через diff, ревьюить и коммитить по желанию. Телеметрия и облачные сервисы не требуются.

Установка

Выберите нужную среду выполнения.

Claude Code

claude plugin marketplace add boshu2/agentops
claude plugin install agentops@agentops-marketplace

Codex CLI на macOS, Linux или WSL

curl -fsSL https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install-codex.sh | bash

Codex CLI на Windows PowerShell

irm https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install-codex.ps1 | iex

OpenCode

curl -fsSL https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install-opencode.sh | bash

Другие агенты с поддержкой скиллов

После установки перезапустите агента. Затем введите /quickstart в чате агента.

CLI ao необязателен, но рекомендуется. Он открывает нативное для репозитория журналирование, поиск, проверку состояния и терминальные рабочие процессы.

macOS

brew tap boshu2/agentops https://github.com/boshu2/homebrew-agentops
brew install agentops
ao version

Windows PowerShell

irm https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install-ao.ps1 | iex
ao version

Также можно установить CLI из бинарных релизов или собрать из исходников.

Устранение неполадок: docs/troubleshooting.md · Конфигурация: docs/ENV-VARS.md

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

Внутри репозитория выполните одну команду в чате агента:

Она определит состояние настройки, объяснит систему и предложит следующее действие.

Затем попробуйте минимально полезный поток:

Или запустите полный цикл от обнаружения до валидации:

Если CLI установлен, проверьте локальную настройку:

ao doctor
ao demo

Новый проект? Используйте интерактивный путь через CLI:

Полный каталог: docs/SKILLS.md · Не знаете, что запустить? Маршрутизатор скиллов

Пример работы

Одна команда: валидация PR

> /council validate this PR

[council] 3 judges spawned independently
[judge-1] PASS - token bucket implementation correct
[judge-2] WARN - rate limiting missing on /login endpoint
[judge-3] PASS - Redis integration follows middleware pattern
Consensus: WARN - add rate limiting to /login before shipping

Полный цикл: от исследования до постмортема

> /rpi "add retry backoff to rate limiter"

[research]    Found 3 prior learnings on rate limiting
[plan]        2 issues, 1 wave
[pre-mortem]  Council validates the plan
[crank]       Executes the scoped work
[vibe]        Council validates the code
[post-mortem] Captures new learnings in .agents/
[flywheel]    Next session starts with better context

Цель не в том, чтобы сделать промпт больше. Цель — репозиторий, который помнит, что сработало.

Скиллы

Каждый скилл работает самостоятельно. Потоки объединяют их, когда нужна большая структура.