Работа с CLI Attio через ИИ-агента
Читайте и меняйте сделки, смотрите воронку, ищите людей и компании в Attio и вызывайте его API.
Найдите сделку, посмотрите воронку или что поменялось за ночь одной короткой командой, той же, которую запускает ваш
агент. API Attio говорит на языке id записей, slug атрибутов и id статусов, а attio вместо них принимает названия
этапов и обычные слова.
Сделки на этапе, победы недели или почту человека вы находите одной строкой. Агент делает то же самое по вашей просьбе.
Каждая команда начинается с профиля, то есть имени, которое вы дали входу в одно пространство. sync копирует ваши
сделки и людей и компании, которые в них названы, в локальное хранилище WireCat, и команды сделок читают их оттуда.
Нужен профиль, в который вы вошли: его настраивает установка.
На этой странице:
- Сначала профиль
- Синхронизация
- Сделки
- Воронка
- Что поменялось
- Люди, компании и участники
- Ваши собственные атрибуты
- Поиск по всему
- API Attio
- Вывод для скриптов
- Агенты
Сначала профиль
Профиль это имя, которое вы выбираете для одного пространства. Это первое слово каждой команды, которой нужен аккаунт:
attio work config showWCATTIO_PROFILE=work делает то же самое для одного сеанса оболочки. Профиль никогда не подставляется сам, даже
единственный: команда без него останавливается с кодом выхода 2 и показывает профили на этом компьютере. Два
пространства это два профиля, у каждого свой токен.
Синхронизация
Сделки, воронка и ее этапы читаются из локального хранилища WireCat, того, по которому ищет каждый инструмент
WireCat. sync его обновляет:
attio work sync # every deal and the people and companies it names, again
attio work sync --rescan # start over, dropping a sync that stopped half way
attio work store status # how far each kind is, and how many are storedAttio не умеет отдавать только записи, которые поменялись с какого-то момента, поэтому каждая синхронизация заново
читает каждую сделку, а потом людей и компании из них. Синхронизация останавливается до своего срока или до --max-pages, а следующая
продолжает с этого места. Записи, удаленные в Attio, уходят из копии.
Каждая запись хранит только текущие значения. Attio хранит историю каждого атрибута, а замененное значение не копируется.
Сделки
attio work deals list status:open # open, won or lost
attio work deals list stage:"In Progress"
attio work deals list "created>=30d" # made in the last 30 days
attio work deals show deal:12 # by the ref a list prints
attio work deals list status:open --format csv > deals.csvСделка отдает свой stage, status, amount с его currency, свою компанию, своих людей, ответственного и ссылку
на сделку в Attio. --offline читает то же самое без запроса в Attio. Список показывает сначала самые новые:
--limit и --page это меняют. Поля, по которым список умеет фильтровать, есть в его справке:
attio help deals list.
В Attio одна воронка сделок. Ее этапы это статусы атрибута сделки Stage, в порядке Attio:
- Выиграна сделка на этапе, который Attio празднует, когда сделка до него доходит.
- Проиграна сделка на этапе, название которого начинается с "Lost", как в новом пространстве Attio.
- Любой другой этап открытый.
Если вы переименовали этап проигрыша во что-то другое, его сделки считаются открытыми. Оставьте "Lost" в начале его названия.
Воронка
attio work pipelines show # each stage: how many, their sum per currency, how many went on
attio work pipelines show --since-time 30d # only the deals made in the last 30 days, with the win rate
attio work stages list # each stage with its outcome and how many are open in itВоронка называется Deals. Суммы считаются отдельно для каждой валюты и никогда не конвертируются.
Что поменялось
changes list показывает, какие изменения в копии увидели синхронизации: созданные, перемещенные, выигранные,
проигранные и переданные другому ответственному сделки, сначала самые новые. Команда читает последний день, если
at: не говорит другое.
attio work changes list "at>=1d"
attio work changes list change:won "at>=7d" --json
attio work changes list "at>=1d" --format report # the window as a short morning digestИзменение видит только синхронизация, поэтому сначала запустите sync.
Люди, компании и участники
Люди, компании и участники пространства каждый раз читаются из Attio, поэтому им нужен интернет, а --offline их
отклоняет. Слова после list ищут в Attio: людей по имени или почте, компании по названию.
attio work people list anna # people whose name or e-mail holds "anna"
attio work people show "Anna Example" # one person by exact name or id, with e-mails and phones
attio work organizations list example # companies whose name holds "example"
attio work organizations list --format csv > companies.csv
attio work users list # your workspace members, the owners of dealsЖивой список принимает только слова, а не условия field:value. Без слов он показывает всех, сначала самых новых.
Человек или компания отдает собственные атрибуты вашего пространства в provider_metadata.
Ваши собственные атрибуты
attio work fields list deals
attio work fields list people --jsonfields list показывает атрибуты, которые ваше пространство добавило к сделкам, людям или компаниям
(organizations), с их типом, так, как их сохранила последняя sync. Варианты атрибута-списка пока не
показываются. Собственные атрибуты Attio не показываются.
Поиск по всему
attio work search all "Example LLC"
attio work search all renewal --only crmsearch all ищет сделки в копии по словам из их названия, компании и людей, а также сообщения, заметки, события
календаря и встречи, которые другие инструменты WireCat сохранили на этом компьютере. Лучшее совпадение идет первым.
API Attio
attio work api выполняет любую операцию API Attio, по одной команде на операцию, со своими флагами и справкой. Так
можно достать до того, у чего пока нет своей команды: заметок, задач, списков, пользовательских объектов, встреч и
другого.
attio work api list # every operation, without calling Attio
attio work api show objects-records-query # one operation's parameters
attio work api objects-list # the objects in your workspaceУ каждой операции свой ключ разрешения, например api.notes-create. Запись проходит только насколько это разрешают
права токена: с тремя правами на чтение из раздела установка Attio ее отклоняет. Чтобы держать
любую запись вне досягаемости на этом компьютере, выполните attio work config set permissions.api readonly. См.
разрешения.
Вывод для скриптов
Каждая команда, кроме mcp serve на stdin и stdout, принимает --json и печатает одно значение JSON в stdout.
Ошибки приходят в JSON в stderr, с кодом, по которому можно ветвиться. --format csv превращает страницу списка в
таблицу. Коды выхода перечислены в справочнике команд.
Агенты
attio skill install кладет навык инструмента туда, где его ищут Claude Code, Codex, Gemini CLI и OpenClaw.
attio skill install --for hermes еще и добавляет эту папку в настройки Hermes Agent, а простой skill install
Hermes не трогает.
Агент с терминалом после этого сам запускает attio. Просите обычными словами:
"Используй attio. Какие сделки сдвинулись вчера и какие еще открыты на этапе Negotiation?" "Используй attio. Выгрузи наши открытые сделки в CSV-файл." "Используй attio. Кто наш контакт в Example LLC и какие сделки у нас с ними?"
Для Claude Desktop, Cursor, ChatGPT и других приложений, которые не могут запускать команды, attio work mcp serve
отдает те же команды по MCP. Сначала закройте записи группы api: через MCP запись на уровне ask выполняется. См.
MCP.