# AgentCode: README для пользователя

AgentCode — это локальный AI-помощник для задач с файлами и кодом на твоём Mac.

Он открывается в браузере через OpenCode, но работает через локальный узел на твоём компьютере. Поэтому когда ты просишь прочитать файл, создать отчёт или проверить проект, AgentCode обращается к файлам именно этого Mac.

## Что он умеет

- Читать локальные файлы и кратко пересказывать их.
- Искать папки и составлять дерево файлов.
- Создавать отчёты на рабочем столе или в рабочей папке.
- Писать небольшие скрипты и запускать безопасные проверки.
- Помогать с кодом: найти ошибку, предложить правку, запустить тесты.
- Для тяжёлых code-задач отправлять работу в серверный pipeline с моделями.
- Честно отвечать, если задачу нельзя выполнить без инструмента или доступа.

## Как установить на Mac

```bash
curl -fsSL https://agentcode.5nota.com/install-mac.sh | bash
```

После установки проверь:

```bash
agentcode health
agentcode open
```

`agentcode open` откроет локальный AgentCode/OpenCode.

## Как пользоваться

Пиши задачи обычным языком. Хорошая задача содержит:

- что сделать;
- где лежат исходные файлы или папка;
- куда положить результат;
- что считать успешным результатом.

Пример:

```text
Прочитай файл /Users/me/Desktop/notes.txt и сделай краткое резюме.
Результат сохрани на рабочий стол в файл notes_summary.txt.
```

Для задач по коду смотри короткую инструкцию:

- `HOW_TO_RUN_CODING_TASK.md` — как формулировать code-задачу, как запускать hard benchmark и как понимать результат.

## Демо перед первым использованием

Чтобы быстро понять, зачем нужен AgentCode, можно поставить демо-набор:

```bash
agentcode demo install
agentcode demo list
agentcode open
```

В демо входят пять коротких показов: отчёт по папке, извлечение данных из файла, создание и запуск скрипта, исправление бага в мини-проекте и честный отказ от неподключённого GUI-инструмента.

## Как должен выглядеть хороший ответ

Хороший ответ AgentCode говорит одно из четырёх:

- `Готово`: что сделано и где результат.
- `Нужно подтверждение`: какое опасное действие надо подтвердить.
- `Не могу`: какого файла, доступа или инструмента не хватает.
- `Ошибка`: что сломалось и что попробовать дальше.

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

## Главная формулировка продукта

AgentCode — это локальный агент для задач с файлами и кодом, который работает через твой компьютер и серверные модели.

Это не универсальный автономный ИИ-разработчик и не замена человеку на реальных чувствительных проектах.

## Private beta

Если AgentCode ставится первому пользователю, используй beta-договорённость:

- `BETA_AGREEMENT.md` — что входит в beta и за что платит пользователь;
- `BETA_ONBOARDING_CHECKLIST.md` — что сделать на первой встрече.

## Проверка длинных задач

Для проверки самостоятельности есть отдельный прогон:

- `PRODUCT_LONG_AUTONOMY_TEST.md` — длинные простые задачи, остановка циклов, частичный прогресс и самопроверка результата.

Для проверки качества кодового агента есть отдельный benchmark:

- `HARD_CODING_BENCHMARK.md` — набор из 36 coding-задач;
- `HARD_CODING_BENCHMARK_LIVE_REPORT.md` — честный live-прогон от 2026-07-01: 17/36 pass, то есть кодовый loop ещё требует усиления перед сильными product claims.