# Агенти командного рядка

Використовуйте агента, якого ви вже запускаєте з термінала, у своєму робочому просторі для написання.

Підключіть уже встановленого агента до Oleafly. Режим **Агент командного рядка** використовує середовище виконання та вхід цього агента, тож ви можете працювати поруч із рукописом інструментами, якими вже користуєтесь.

![Налаштування → Асистент ШІ → Агенти командного рядка. Згори перевірте встановлених агентів, потім розгорніть агента, щоб завершити його налаштування.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-cli-agents-dark-window-v2.png#view=519,89,883,902)

## Підключіть агента

1. Відкрийте **Налаштування → Асистент ШІ → Агенти командного рядка** і виберіть **Перевірити встановлених агентів**.
2. Розгорніть свого агента. Рядок **Програма** показує програму, яку знайшов Oleafly, і де вона.
3. Виберіть **Перевірити**. Якщо картка просить встановити міст, спершу виберіть **Встановити міст**.
4. Увійдіть через власний інструмент командного рядка агента. Картка показує його **Команду входу**, а з відкритим проєктом **Відкрити термінал для входу** дає термінал, щоб її виконати.
5. Відкрийте асистента, перейдіть у режим **Агент командного рядка** і виберіть агента.
6. Почніть з невеликого завдання, як-от пояснення структури проєкту або доопрацювання одного абзацу.

Якщо ви переходите на агента, який ще не готовий, асистент показує картку налаштування, де сказано, чого не вистачає. Її кнопка **Налаштувати**, як-от **Налаштувати Claude Code**, відкриває цього агента в Налаштуваннях. Коли бракує лише моста, **Встановити міст** на картці встановлює його.

Автентифікація, доступ до моделей і оплата належать вибраному агентові. Обліковим записом або підпискою, яка підтримує CLI, можна користуватися відповідно до умов того постачальника; Oleafly не додає окремої підписки на ШІ.

## Виберіть програму

Під написом **Програма** картка показує файл, який запускає Oleafly, і звідки він: **Знайдено автоматично**, **Вибрано вами** або **Встановлено через Oleafly**. Для деяких агентів цей рядок натомість міститься в подробицях **Міст ACP**.

Щоб використати іншу копію, виберіть **Вибрати…** і вкажіть файл. Якщо Oleafly нічого не знайшов, рядок каже **Не знайдено на цьому комп’ютері** та дає поле для розташування. Введіть або вставте шлях, потім натисніть Enter або виберіть **Перевірити**. Файл, який ви обрали або ввели, зберігається, лише коли він проходить перевірку. **Використовувати автоматичне виявлення** відкидає ваш вибір.

Oleafly шукає в теках, куди встановлювачі кладуть агентів:

- У Windows він знаходить агентів, установлених через npm, pnpm, Scoop, winget і подібні інструменти, на будь-якому диску. Він зчитує шлях пошуку щоразу наново, тож **Перевірити встановлених агентів** знаходить і агента, встановленого, поки Oleafly був відкритий.
- У macOS він знаходить агентів у теках, про які зазвичай знає лише ваша оболонка, як-от `~/.local/bin` або тека nvm, навіть коли ви відкриваєте Oleafly з Dock або Finder.

Коли Oleafly знаходить файл із правильною назвою, який не може використати, налаштування повідомляє, що знайдено і чому. Типовий випадок у Windows — скрипт PowerShell, коли Oleafly потрібна версія `.cmd` або `.exe`. **Файли, пропущені Oleafly** перелічують кожен такий файл із причиною, наприклад тека, настільна програма, оболонка або середовище виконання, як-от `node`, або копія в мережевому розташуванні.

Шляхи в Налаштуваннях лишаються розмитими, поки ви не наведете на них вказівник або не перейдете до них табуляцією, тож знімок екрана Налаштувань не показує, де живуть ваші файли.

## Перевірте агента

**Перевірити** запускає агента в порожній теці, що належить Oleafly, подалі від вашого проєкту, і чекає на відповідь. Нічого не зберігається. Коли перевірка проходить, ви бачите назву й версію агента. Коли вона провалюється, ви отримуєте одне речення з причиною і одну дію, яку варто спробувати:

| Що повідомляє перевірка | Що спробувати |
| --- | --- |
| Файла немає, або це тека, настільна програма чи файл, який Oleafly не може запустити | **Вибрати…** і вказати саму програму |
| Міст ще не встановлено | **Встановити міст** |
| Агенту потрібен Node.js або новіша його версія | **Завантажити Node.js** |
| Агент запустився, але не відповів, зупинився завчасно або надіслав відповідь, яку Oleafly не зміг прочитати | **Копіювати подробиці** або **Відкрити термінал**, щоб запустити агента власноруч |

Якщо вибраний вами файл провалює перевірку з причини, відмінної від самого файла, **Однаково використовувати** зберігає його попри це.

## Каталог агентів

| Агент | Команда CLI |
| --- | --- |
| Claude Code | `claude` |
| Codex CLI | `codex` |
| Gemini CLI | `gemini` |
| Pi | `pi` |
| OpenCode | `opencode` |
| OpenClaw | `openclaw` |
| Cline | `cline` |
| Hermes Agent | `hermes` |
| CodeBuddy | `codebuddy` |
| Kimi Code | `kimi` |
| Grok Build | `grok` |
| Cursor | `cursor-agent` або `agent` |
| DeepSeek Harness | `dsh` |
| Qoder | `qodercli` |

Каталог визначає підтримувані шляхи запуску. Доступні моделі, вкладення, відновлення сесій і звітування про використання залежать від того, що відкриває агент. Налаштування повідомляє про відсутні вимоги до початку сесії.

Pi працює через міст pi-acp, версії 0.0.34, і Oleafly спрямовує міст на вашу програму Pi. У Windows він обробляє теки проєктів із пробілами в назвах.

## Працюйте поруч із рукописом

Дайте агентові конкретне прохання і стежте за його відповідями, роботою інструментів та запитами на дозвіл у панелі асистента. Відкрийте отриманий вихідний файл і скомпілюйте його в Oleafly.

> Прочитайте вступ і методи. Перелічіть усі терміни, які вводяться непослідовно, із зазначенням файлів.

Для окремої копії та фінального рецензування виберіть доступного агента в [Дослідницькі завдання](/docs/research-tasks/). На тій сторінці перелічено платформні вимоги для ізольованої роботи.

## Стартові точки для дослідження

Нова розмова відкривається на домашній сторінці агента, де є стартові точки для дослідження. Вибір однієї заповнює повідомлення, але не надсилає його, тож ви можете спершу прочитати й скоригувати його. Якщо розмови ще не відкрито, вона починає нову.

| Стартова точка | Що вона просить |
| --- | --- |
| **Пошук літератури** | Анотований перелік для читання за дослідницьким питанням проєкту, з навичкою `oleafly-literature-sweep` |
| **Суміжні роботи** | Розділ про суміжні роботи на основі переліку для читання та бібліографії, з `oleafly-related-work` |
| **Перевірка цитувань** | Перевірка тверджень рукопису за їхніми цитованими джерелами, з `oleafly-verify-claims` |
| **Рецензування рукопису** | Рецензування повного рукопису, з `oleafly-review-manuscript` |
| **Перевірка відтворюваності** | Чого бракує кожному результату для відтворення: код, дані, версії програмного забезпечення, випадкові початкові значення й інструкції збірки |
| **Перевірка рисунків** | Перевірка кожного рисунка й таблиці: підписи, мітки, перехресні посилання, підписи осей і одиниці, читабельність і кольори, що витримують градації сірого |
| **Огляд змін у Git** | Зведення незафіксованих змін і нещодавніх комітів, яке позначає правки, що виглядають ненавмисними. Показується лише в репозиторії Git |
| **Очищення джерел** | Відкриває **Очищення бібліотеки джерел**, яке стандартизує ключі цитувань і видаляє дублікати після попереднього перегляду змін |

Перевірки й рецензування рукопису просять агента лишити файли рукопису без змін і записати свої висновки у файл у `research/`, як-от `research/figure-audit.md`.

Навичка, яку ви оберете, зі стартової точки або з переліку навичок на домашній сторінці, показується як мітка над повідомленням. Oleafly надсилає інструкції навички разом із вашим повідомленням, тож агенти, які не отримують інструментів Oleafly, як-от Pi, усе одно можуть виконати її інструкції. Клацніть мітку, щоб прибрати її. Якщо навичку вимкнено для проєкту, стартова точка заповнює повідомлення без неї.

## Запити на дозвіл

Коли агент питає дозвіл перед дією, картка повідомляє, що агент **потребує дозволу**, і пропонує власні варіанти агента. Якщо запит змінив би файли, картка їх перелічує. **Показати зміну** відкриває різницю для файла, щоб ви могли прочитати її до відповіді. Зміна, завелика для показу, повідомляє про це, і ви можете переглянути її після ходу. **Відхилити** скасовує запит, не надаючи дозволу. Якщо запит лишити без відповіді на дві хвилини, він спливає, і агентові доводиться запитати знову.

## Перегляд і скасування змін

Після ходу, який змінив файли, рядок під відповіддю показує, скільки їх. **Переглянути** показує кожну зміну, а **Скасувати** і **Повторити** працюють для окремого файла або для всього ходу. У [Перегляд і скасування ходу](/docs/ai-chat/#review-and-undo-a-turn) пояснено, як це працює і чого воно не торкається.

## Розмови та експорт

У заголовку асистента є **Нова розмова**, **Збережені розмови** та **Налаштування агента**. Кожна розмова запам’ятовує коміт Git, на якому перебував проєкт на її початку.

Щоб зберегти копію поза Oleafly, відкрийте **Збережені розмови** та виберіть **Експортувати розмову…**, потім вкажіть Markdown або JSON у діалозі збереження. Файл Markdown починається з проєкту, агента, моделі, коміта, на якому розмова почалася (із зазначенням незафіксованих змін), а також часу початку й останнього оновлення. Далі йдуть повідомлення, навички, виклики інструментів і змінені файли. JSON містить повний запис.

## Власні агенти

Виберіть **Знайти більше агентів**, щоб шукати в реєстрі ACP агентів, опублікованих іншими командами, або **Додати власного агента**, щоб вставити визначення власноруч. Перегляньте його виконуваний файл або пакунок, аргументи та вимоги з’єднання перед запуском. Реєстрація визначення не встановлює агента і не запускає його.

## Натомість використовуйте зовнішній клієнт

Якщо вам зручніше лишатися у власному інтерфейсі агента, підключіть його через MCP. [MCP-сервер Oleafly](/docs/mcp/) дає йому інструменти проєкту із застосунку, поки Oleafly відкритий. [Команда `oleafly`](/docs/cli/#connect-an-agent-over-mcp) працює і тоді, коли застосунок закрито, а [навичка `oleafly-cli`](/docs/cli/#the-oleafly-cli-skill) навчає вашого агента її команд.