CRMAttio

Usa la CLI de Attio con tu agente de IA

Lee y cambia negociaciones, mira el embudo, busca personas y empresas en Attio y llama a su API.

Encuentra una negociación, mira tu embudo o qué cambió durante la noche con un comando corto, el mismo que ejecuta tu agente. La API de Attio habla con ids de registros, slugs de atributos e ids de estados, y attio acepta en su lugar nombres de etapas y palabras normales.

Encuentras las negociaciones de una etapa, las ganadas de la semana o el correo de una persona en una línea. Un agente hace lo mismo a partir de tu petición.

Cada comando empieza con un perfil, el nombre que diste al inicio de sesión de un espacio de trabajo. sync copia tus negociaciones, y las personas y empresas que aparecen en ellas, en el almacén local de WireCat, donde las leen los comandos de negociaciones. Necesitas un perfil con sesión iniciada: instala prepara uno.

En esta página:

  1. Primero el perfil
  2. Sincroniza
  3. Negociaciones
  4. El embudo
  5. Qué cambió
  6. Personas, empresas y miembros
  7. Tus atributos propios
  8. Busca en todo
  9. La API de Attio
  10. Salida para scripts
  11. Agentes

Primero el perfil

Un perfil es un nombre que eliges para un espacio de trabajo. Es la primera palabra de cada comando que usa una cuenta:

attio work config show

WCATTIO_PROFILE=work hace lo mismo para una sesión de la terminal. Nunca se da un perfil por supuesto, ni siquiera el único: un comando sin perfil se detiene con el código de salida 2 y muestra los perfiles de este ordenador. Dos espacios de trabajo son dos perfiles, cada uno con su propio token.

Sincroniza

Las negociaciones, el embudo y sus etapas se leen del almacén local de WireCat, el mismo en el que buscan todas las herramientas de WireCat. sync lo pone al día:

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 stored

Attio no puede listar solo los registros que cambiaron desde un momento dado, así que cada sincronización vuelve a leer cada negociación y luego las personas y empresas que nombran. Una sincronización se detiene antes de su plazo o de --max-pages, y la siguiente sigue desde ahí. Los registros borrados en Attio salen de la copia.

Cada registro guarda solo sus valores actuales. Attio guarda el historial de cada atributo, y un valor que se sustituyó no se copia.

Negociaciones

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

Una negociación responde con su stage, su status, su amount con su currency, su empresa, sus personas, su responsable y un enlace a la negociación en Attio. --offline lee lo mismo, sin ninguna petición a Attio. Una lista muestra primero las más nuevas: --limit y --page lo cambian. Los campos por los que una lista puede filtrar están en su ayuda: attio help deals list.

Attio tiene un solo embudo de negociaciones. Sus etapas son los estados del atributo Stage de la negociación, en el orden de Attio:

  • Ganada es la etapa que Attio celebra cuando una negociación llega a ella.
  • Perdida es una etapa cuyo título empieza por "Lost", como en un espacio de trabajo nuevo de Attio.
  • Cualquier otra etapa está abierta.

Si cambiaste el nombre de tu etapa de perdidas por otro, sus negociaciones cuentan como abiertas. Deja "Lost" al principio de su título.

El embudo

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

El embudo se llama Deals. Las sumas se llevan por moneda y nunca se convierten.

Qué cambió

changes list muestra lo que las sincronizaciones vieron cambiar en la copia: negociaciones creadas, movidas, ganadas, perdidas y pasadas a otro responsable, las más nuevas primero. Lee el último día salvo que at: diga otra cosa.

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

Un cambio solo lo ve una sincronización, así que ejecuta sync primero.

Personas, empresas y miembros

Las personas, las empresas y los miembros del espacio de trabajo se leen de Attio cada vez, así que necesitan internet y --offline los rechaza. Las palabras después de list buscan en Attio: personas por nombre o correo, empresas por nombre.

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

Una lista en directo acepta solo palabras, no términos field:value. Sin palabras lista a todos, los más nuevos primero. Una persona o una empresa da los atributos propios de tu espacio de trabajo en provider_metadata.

Tus atributos propios

attio work fields list deals
attio work fields list people --json

fields list muestra los atributos que tu espacio de trabajo añadió a negociaciones, personas o empresas (organizations), con su tipo, tal como los guardó la última sync. Las opciones de un atributo de selección todavía no se listan. Los atributos propios de Attio quedan fuera.

Busca en todo

attio work search all "Example LLC"
attio work search all renewal --only crm

search all busca las negociaciones de la copia por las palabras de su título, su empresa y sus personas, y los mensajes, notas, eventos del calendario y reuniones que otras herramientas de WireCat guardaron en este ordenador. El mejor resultado sale primero.

La API de Attio

attio work api ejecuta cualquier operación de la API de Attio, un comando por operación, con sus propias opciones y su ayuda. Llega a lo que todavía no tiene un comando propio: notas, tareas, listas, objetos personalizados, reuniones y más.

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

Cada operación tiene su propia clave de permiso, como api.notes-create. Las escrituras solo pasan hasta donde lo permiten los ámbitos del token: con los tres ámbitos de lectura de instala, Attio las rechaza. Para dejar toda escritura fuera de alcance en este ordenador, pon attio work config set permissions.api readonly. Mira los permisos.

Salida para scripts

Todos los comandos salvo mcp serve por stdin y stdout aceptan --json e imprimen un solo valor JSON en stdout. Los errores salen en JSON por stderr, con un código para decidir qué hacer. --format csv convierte una página de una lista en una tabla. La referencia de comandos lista los códigos de salida.

Agentes

attio skill install pone la skill de la herramienta donde la buscan Claude Code, Codex, Gemini CLI y OpenClaw. attio skill install --for hermes añade además esa carpeta a los ajustes de Hermes Agent, así que un skill install sin más deja fuera a Hermes.

Después, un agente con terminal ejecuta attio por sí mismo. Pregunta con palabras normales:

"Usa attio. ¿Qué negociaciones se movieron ayer, y cuáles siguen abiertas en Negotiation?" "Usa attio. Exporta nuestras negociaciones abiertas a un archivo CSV." "Usa attio. ¿Quién es nuestro contacto en Example LLC, y qué negociaciones tenemos con ellos?"

Para Claude Desktop, Cursor, ChatGPT y otras aplicaciones que no pueden ejecutar comandos, attio work mcp serve ofrece los mismos comandos por MCP. Bloquea antes las escrituras del grupo api: por MCP una escritura en ask sigue adelante. Mira MCP.