# Подключение агента к Taskless

**Агенту**

Тебя попросили подключить Taskless, трекер задач с MCP-сервером для агентов. Это делает одна команда.

Перед запуском спроси человека, есть ли у него своя папка с заметками или памятью для агентов. Если есть, добавь её к команде: `curl -fsSL https://taskless.ru/connect.sh | sh -s -- --memory-dir ~/notes`.

macOS и Linux

`curl -fsSL https://taskless.ru/connect.sh | sh`

Windows, PowerShell

`irm https://taskless.ru/connect.ps1 | iex`

Команда найдёт на этом компьютере Claude Code и Codex и допишет им сервер Taskless и плагин. Подключение Grok и ZCode — скоро. Перед правкой файла она сохраняет копию. Подробно в разделе [«Что меняет установщик»](https://taskless.ru/invite-agent#changes).

Скажи человеку: «Сейчас откроется браузер. Войди в Taskless, сверь код с тем, что в терминале, и нажми „Разрешить“». Когда установщик закончит, перескажи его отчёт.

Установщик напечатает, что с личной памятью Taskless и какую память агентов нашёл, и порядок действий. Без „да“ человека ничего не включай и не отправляй.

Перед запуском можно спросить человека. Если не запускаешь скрипты вслепую, [проверь заранее](https://taskless.ru/invite-agent#dry-run) с `--dry-run`.

Для человека

## Подключи своего агента к Taskless

Отправь агенту эту фразу. Установку он запустит сам, от тебя нужно войти в браузере и нажать «Разрешить».

подключи taskless https://taskless.ru/invite-agent

Подходит для Claude Code и Codex. Grok и ZCode — скоро. Если агент работает в браузере, без терминала, для него [свой путь](https://taskless.ru/invite-agent#no-terminal).

## Что произойдёт

1. Агент запускает команду, установщик находит на компьютере Claude Code и Codex.
2. В терминале появляется код вида `ABCD-EFGH`, и открывается браузер на `taskless.ru/connect`. Если браузера нет, например по SSH, открой ссылку из терминала на любом устройстве.
3. Ты входишь в Taskless, сверяешь код с терминалом и жмёшь «Разрешить». Код живёт 10 минут и срабатывает один раз, а «Разрешить» нужно один раз на весь компьютер.
4. Установщик прописывает агентов и печатает отчёт: кто подключён и что сделать руками, например одобрить хуки в Codex командой `/hooks`.
5. Агент расскажет о личной памяти Taskless и спросит, включить ли её. Если включишь, он предложит забрать память, которую нашёл установщик: `CLAUDE.md`, `AGENTS.md`, память Claude Code и Codex и твою папку заметок, если ты её назвал. Агент собирает из неё короткие записи и показывает тебе. В Taskless они уходят только после твоего „да“.

## Что меняет установщик

- Дописывает агентам сервер MCP Taskless (`https://taskless.ru/api/mcp`) и плагин `taskless`: скилы, хуки и правила. Чужие серверы и хуки не трогает, при повторном запуске дублей не плодит.
- Перед правкой файла кладёт рядом копию `*.bak-taskless` и помечает правку, чтобы удаление сняло ровно её.
- Ключ компьютера хранит в системной связке: Keychain, Credential Manager или libsecret. Если связки нет, в файле с правами 600 в `~/.config/taskless/`.
- Нужны `sh` и `node` или `python3`, на Windows хватит PowerShell. Если чего-то нет, установщик скажет, что поставить.

**Какие файлы правятся у каждого агента**

Claude Code

`~/.claude.json`, ключ `mcpServers.taskless`, и плагин `taskless` из маркетплейса `taskless-app/taskless`.

Codex

`~/.codex/config.toml`, раздел `[mcp_servers.taskless]`, и плагин. Хуки Codex попросит одобрить командой `/hooks`.

Grok

Скоро: установщик пока не подключает.

ZCode

Скоро: установщик пока не подключает.

## Личная память

Агент с Taskless может помнить твои правила, решения и факты о работе во всех подключениях. Чтобы в первый день память не была пустой, установщик ищет то, что уже накопилось на компьютере.

- Личная память по умолчанию выключена. Агент расскажет о ней и спросит, включить ли. Включить и выключить можно и в профиле, раздел «Личная память».
- Установщик ищет `~/.claude/CLAUDE.md`, `~/.codex/AGENTS.md`, память Claude Code и Codex и папку, которую ты назвал. Файлы в репозиториях не трогает.
- Пропускает `.env`, ключи, не текстовые файлы и файлы больше 256 КБ.
- Файлы целиком никуда не уходят. Агент читает их на твоём компьютере и составляет короткие записи. Пароли и ключи в записи не попадают, сервер проверяет это ещё раз.
- До отправки агент показывает тебе все записи. Без твоего „да“ ничего не уходит.
- Записи видишь только ты, из любого своего пространства. Ненужную запись удалит агент, если сказать ему „забудь …“. Удалить всё можно в профиле.

Забрать память позже: скажи агенту „забери в Taskless мою память из ~/notes“.

**Формат пачки для \`--import-memory\`**

Пример JSON

`{"files":[{"path":"~/notes/rules.md","source":"notes","items":[{"statement":"Перед PR запускай тесты","kind":"rule","quote":"Перед PR запускай тесты"}]}]}`

Виды источников

`instructions` — правила человека, `agent_memory` — память Claude Code и Codex, `notes` — записи из папки человека.

## Проверить заранее

Код установщика открыт: репозиторий [`taskless-app/taskless`](https://github.com/taskless-app/taskless/tree/main/packages/agent-kit/connect), папка `packages/agent-kit/connect/`. С taskless.ru раздаются эти же файлы. Скачай или выведи скрипт, прочитай и прогони с `--dry-run`: он покажет, что поменяет, и ничего не тронет.

macOS и Linux

1. `curl -fsSL https://taskless.ru/connect.sh -o connect.sh`
2. `less connect.sh`
3. `sh connect.sh --dry-run`
4. `sh connect.sh`

Windows, PowerShell

1. `irm https://taskless.ru/connect.ps1`
2. `& ([scriptblock]::Create((irm https://taskless.ru/connect.ps1))) --dry-run`
3. `& ([scriptblock]::Create((irm https://taskless.ru/connect.ps1)))`

Ещё два режима: `--only claude-code,codex` подключит только указанных агентов, `--status` покажет, что подключено сейчас.

`--dry-run` покажет и найденную память.

## Как всё удалить

С `--uninstall` установщик снимает всё, что поставил, и отзывает ключ. Твои собственные правки остаются.

macOS и Linux

`curl -fsSL https://taskless.ru/connect.sh | sh -s -- --uninstall`

Windows, PowerShell

`& ([scriptblock]::Create((irm https://taskless.ru/connect.ps1))) --uninstall`

Без терминала: в профиле, раздел «Безопасность», «Где активен аккаунт», у строки «Агенты на <имя компьютера>» нажми «Отозвать». Все агенты того компьютера потеряют доступ.

## Если у агента нет терминала

Claude и ChatGPT в браузере команду не запустят. Если ты такой агент, объясни человеку, как добавить Taskless коннектором:

- В Claude: «Настроить» → «Коннекторы» → «+ Добавить» → «Добавить собственный коннектор». Указать адрес `https://taskless.ru/api/mcp`.
- В ChatGPT администратор создаёт приложение с тем же адресом в настройках рабочего пространства. Затем открыть «Настройки» → «Плагины» и включить Taskless.
- Откроется окно Taskless: войти и разрешить доступ. Ключи копировать не нужно.
- ChatGPT подключает сторонние MCP-серверы только на тарифах Business и Enterprise. На других тарифах Taskless к ChatGPT пока не подключить.

Установщик открыт и ничего не правит молча: копии файлов, пометки правок, проверка заранее. Отзыв доступа в профиле, раздел «Безопасность».
