Arroway — plugin
Arroway orchestrates people and AI agents around the decisions in force.
Your team writes down what it decided; every teammate's AI reads it before it acts, and leaves behind what someone arriving later would need in order not to redo the work.
This repository is the plugin: the connection to Arroway, the working protocol, and the hooks that make an assistant read before it changes anything and record when it finishes.
Install
Claude Code and Cowork
claude plugin marketplace add oaleviola/arroway-plugin
claude plugin install arroway@arroway
Nothing to paste, and no separate connector to install: the package carries the connection to Arroway's own address. It starts signed out, so sign in once. In Claude Code, run /mcp, choose plugin:arroway:arroway and follow the sign-in in the browser. Approve the connection as yourself, and the memory your assistant writes from then on carries your name. Until you sign in, Arroway's tools do not appear and nothing is read or recorded. If Arroway is already connected to your Claude account as a connector and its tools already show up, you can skip this step.
Cursor
Add https://github.com/oaleviola/arroway-plugin as a plugin marketplace in Cursor, then install arroway from the plugin list.
Nothing to paste here: the Cursor package carries Arroway's own address and signs you in through the browser the first time it needs you. Approve the connection as yourself, and the memory your assistant writes from then on carries your name.
Claude in the browser or on your phone
You don't need this repository: add Arroway as a connector instead, from the same Connections page.
The skill alone, in any agent that reads skills
If your agent reads agent skills but there is no Arroway plugin for it, add the workflow skill with the skills CLI:
npx skills add oaleviola/arroway-plugin
The skill teaches your agent to read Arroway before acting and to close each task. It still needs Arroway connected as an MCP server at https://www.arroway.app/api/mcp. Where your client has the plugin, use the plugin: it brings the connection and the hooks too.
Asking an AI agent to install it
Point it to llms-install.md: the steps for each client, written for an agent, Cline and any other MCP client included.
Usage
Once you are signed in there is nothing to call by hand: the skill tells your assistant when to use Arroway. It happens at four moments, and this is what each one looks like.
Examples
- Before it acts. You ask: "Draft the pricing page for the new plan." The assistant first calls
arroway_readfor your project and answers from what the team already decided. If two decisions conflict, it tells you instead of picking one. - Before it commits to a claim.
arroway_normsreturns what is already decided, at a fraction of the cost of a full read, right before the assistant tells you something or proposes a course of action. - When it finishes.
arroway_logrecords what someone arriving later would need in order not to redo the work. If nothing durable came out of the task, the assistant says so in one sentence: No durable residue. - When it stops without finishing.
arroway_passleaves where the work stands, the single next step, what must not be redone and the risk still open. The next person's assistant finds it at the top of its first read and takes it witharroway_claim.
You can also ask for these directly:
- "Catch me up on what happened across my projects this week." —
arroway_catch_up - "Where did we talk about the pricing change?" —
arroway_search_log - "Remember that we don't discount annual plans." —
arroway_remember. What you state yourself is recorded as your decision; what an assistant proposes on its own waits for a person to approve it.
A short example: one assistant researches a pricing change and records a proposal. A person approves the decision. Another assistant drafts the pricing page using that decision, and the next person can see what was decided, who approved it and what remains open.
What it looks like
Screens from a demo account with sample data.
What waits for you, across projects. Decisions an assistant proposed sit in one place until a person decides.
Inside a project. An assistant's proposals wait for approval (approve, approve and pin, reject or correct), and the rules the team pinned are what every connected assistant reads first.
Your own standing rules. How you work travels with you into every project, and no one else sees it.
What is in here
plugin/skills/— the working protocol: read before acting, record when a task ends, hand work forward when you stopplugin/hooks/— the gates that ask for those two moments instead of only describing them, and for a check of the text before something is published for other peopleplugin/.mcp.json— the Claude Code connection, which uses Arroway's own address; identity comes from signing inplugin/.cursor-plugin/,plugin/cursor-mcp.json,plugin/hooks/cursor-hooks.json— the same package as Cursor reads it: its own manifest and hook format, Arroway's own address, no link to pasteplugin/assets/— icons and wordmarks
Permission requests
The plugin's permission hook (Claude Code and Codex) exists only so you can answer, from your own Arroway cockpit, a permission request your agent made. It never approves anything on its own. An approval is valid for that one request only: the hook fingerprints the exact request on your machine and accepts an "allow" only when it comes back bound to that fingerprint and to a single-use code, signed with the session's credential. Without your answer — or with the cockpit off, the server unreachable, or anything that does not match — the window asks as usual. You can also deny from the cockpit, and every decision is recorded.
This repository is a mirror
It is generated. The source lives elsewhere and is published here automatically whenever it changes.
Please do not open pull requests or edit files here — changes made in this repository are overwritten on the next publish, and a fix that lands here never reaches the product. Two edits, one of them silently lost, is the exact failure this note exists to prevent.
Found a problem, or want to suggest something? www.arroway.app/support. For a security problem, see SECURITY.md. How to help is in CONTRIBUTING.md, and everyone here follows the code of conduct.
Links
Arroway · How it works · Privacy · Terms · Changelog
Español
Arroway coordina a personas y agentes de IA en torno a las decisiones vigentes. Tu equipo anota lo que decidió; la IA de cada persona lo lee antes de actuar, y deja atrás lo que alguien que llegue después necesitaría para no rehacer el trabajo.
Este repositorio es el plugin: la conexión con Arroway, el protocolo de trabajo, y los hooks que hacen que un asistente lea antes de cambiar nada y registre cuando termina.
Instalación
Claude Code y Cowork
claude plugin marketplace add oaleviola/arroway-plugin
claude plugin install arroway@arroway
No hay nada que pegar, ni un conector aparte que instalar: el paquete lleva la conexión con la dirección de Arroway. Empieza sin sesión iniciada, así que entra una sola vez. En Claude Code, ejecuta /mcp, elige plugin:arroway:arroway y sigue el inicio de sesión en el navegador. Aprueba la conexión en tu propio nombre, y la memoria que tu asistente escriba desde entonces lleva tu nombre. Hasta que entres, las herramientas de Arroway no aparecen y no se lee ni se registra nada. Si Arroway ya está conectada a tu cuenta de Claude como conector y sus herramientas ya aparecen, puedes saltarte este paso.
Cursor
Añade https://github.com/oaleviola/arroway-plugin como marketplace de plugins en Cursor y luego instala arroway desde la lista de plugins.
Aquí tampoco hay nada que pegar: el paquete de Cursor lleva la dirección de Arroway y te hace entrar por el navegador la primera vez que te necesita. Aprueba la conexión en tu propio nombre, y la memoria que tu asistente escriba desde entonces lleva tu nombre.
Claude en el navegador o en el móvil
No necesitas este repositorio: añade Arroway como conector, desde la misma página de Conexiones.
Solo la skill, en cualquier agente que lea skills
Si tu agente lee skills pero no hay plugin de Arroway para él, añade la skill de trabajo con la CLI de skills:
npx skills add oaleviola/arroway-plugin
La skill le enseña a tu agente a leer Arroway antes de actuar y a cerrar cada tarea. Sigue necesitando Arroway conectada como servidor MCP en https://www.arroway.app/api/mcp. Donde tu cliente tiene el plugin, usa el plugin: trae también la conexión y los hooks.
Si se lo pides a un agente de IA
Muéstrale llms-install.md: los pasos de cada cliente, escritos para un agente, incluidos Cline y cualquier otro cliente MCP.
Uso
Una vez que has entrado, no hay nada que invocar a mano: la skill le dice a tu asistente cuándo usar Arroway. Ocurre en cuatro momentos, y así se ve cada uno.
Ejemplos
- Antes de actuar. Tú pides: «Redacta la página de precios del plan nuevo». El asistente primero llama a
arroway_readpara tu proyecto y responde a partir de lo que el equipo ya decidió. Si dos decisiones se contradicen, te lo dice en vez de elegir una. - Antes de afirmar algo.
arroway_normsdevuelve lo que ya está decidido, por una fracción del costo de una lectura completa, justo antes de que el asistente te diga algo o proponga un camino. - Al terminar.
arroway_logregistra lo que alguien que llegue después necesitaría para no rehacer el trabajo. Si de la tarea no salió nada duradero, el asistente lo dice en una frase: No durable residue. - Al parar sin terminar.
arroway_passdeja dónde está el trabajo, el único paso siguiente, lo que no se debe rehacer y el riesgo que sigue abierto. El asistente de la siguiente persona lo encuentra al principio de su primera lectura y lo toma conarroway_claim.
También puedes pedir estas cosas directamente:
- «Ponme al día con lo que pasó esta semana en mis proyectos». —
arroway_catch_up - «¿Dónde hablamos del cambio de precios?» —
arroway_search_log - «Recuerda que no hacemos descuento en los planes anuales». —
arroway_remember. Lo que dices tú queda registrado como decisión tuya; lo que un asistente propone por su cuenta espera a que una persona lo apruebe.
Un ejemplo corto: un asistente investiga un cambio de precios y registra una propuesta. Una persona aprueba la decisión. Otro asistente redacta la página de precios usando esa decisión, y la siguiente persona puede ver qué se decidió, quién lo aprobó y qué sigue abierto.
Cómo se ve
Pantallas de una cuenta de demostración con datos de ejemplo (la interfaz de las capturas está en inglés).
Lo que te espera, entre proyectos. Las decisiones que un asistente propuso esperan en un solo lugar hasta que una persona decide.
Dentro de un proyecto. Las propuestas de un asistente esperan aprobación (aprobar, aprobar y fijar, rechazar o corregir), y las reglas que el equipo fijó son lo primero que lee cada asistente conectado.
Tus reglas permanentes. Tu forma de trabajar te acompaña a cada proyecto, y nadie más la ve.
Qué hay aquí
plugin/skills/— el protocolo de trabajo: leer antes de actuar, registrar cuando una tarea termina, pasar el trabajo adelante cuando te detienesplugin/hooks/— las compuertas que piden esos dos momentos, en vez de solo describirlos, y una revisión del texto antes de publicar algo para otras personasplugin/.mcp.json— la conexión de Claude Code, que usa la dirección de Arroway; la identidad viene de entrarplugin/.cursor-plugin/,plugin/cursor-mcp.json,plugin/hooks/cursor-hooks.json— el mismo paquete tal como lo lee Cursor: su propio manifiesto y su propio formato de hooks, la dirección de Arroway, ningún enlace que pegarplugin/assets/— iconos y logotipos
Pedidos de permiso
El hook de permiso del plugin (Claude Code y Codex) existe solo para que respondas, desde tu propio cockpit de Arroway, un pedido de permiso que hizo tu agente. Nunca aprueba nada por sí solo. Una aprobación vale solo para ese pedido: el hook calcula en tu máquina la huella del pedido exacto y acepta un "allow" solo si vuelve atado a esa huella y a un código de un solo uso, firmado con la credencial de la sesión. Sin tu respuesta — o con el cockpit apagado, el servidor inalcanzable o cualquier cosa que no coincida — la ventana pregunta como siempre. También puedes denegar desde el cockpit, y cada decisión queda registrada.
Este repositorio es un espejo
Es generado. La fuente vive en otro sitio y se publica aquí automáticamente cada vez que cambia.
Por favor, no abras pull requests ni edites archivos aquí — los cambios hechos en este repositorio se sobrescriben en la siguiente publicación, y un arreglo que aterrice aquí nunca llega al producto. Dos ediciones, una de ellas perdida en silencio, es exactamente el fallo que esta nota existe para evitar.
¿Encontraste un problema, o quieres sugerir algo? www.arroway.app/es/support. Para un problema de seguridad, mira SECURITY.md. Cómo ayudar está en CONTRIBUTING.md, y todas las personas aquí siguen el código de conducta.
Enlaces
Arroway · Cómo funciona · Privacidad · Términos · Cambios por versión
Português
A Arroway coordena pessoas e agentes de IA em torno das decisões que estão valendo. Seu time anota o que decidiu; a IA de cada pessoa lê isso antes de agir, e deixa para trás o que alguém que chegar depois precisaria para não refazer o trabalho.
Este repositório é o plugin: a conexão com a Arroway, o protocolo de trabalho, e os hooks que fazem um assistente ler antes de mudar qualquer coisa e registrar quando termina.
Instalação
Claude Code e Cowork
claude plugin marketplace add oaleviola/arroway-plugin
claude plugin install arroway@arroway
Nada para colar, e nenhum conector separado para instalar: o pacote já traz a conexão com o endereço da própria Arroway. Ela começa sem login, então entre uma vez só. No Claude Code, rode /mcp, escolha plugin:arroway:arroway e siga o login no navegador. Aprove a conexão em seu próprio nome, e a memória que seu assistente escrever dali em diante leva o seu nome. Enquanto você não entrar, as ferramentas da Arroway não aparecem e nada é lido nem registrado. Se a Arroway já está conectada à sua conta do Claude como conector e as ferramentas dela já aparecem, você pode pular este passo.
Cursor
Adicione https://github.com/oaleviola/arroway-plugin como marketplace de plugins no Cursor e depois instale o arroway pela lista de plugins.
Aqui também não há nada para colar: o pacote do Cursor carrega o endereço da própria Arroway e faz você entrar pelo navegador na primeira vez que precisa. Aprove a conexão em seu próprio nome, e a memória que seu assistente escrever dali em diante leva o seu nome.
Claude no navegador ou no celular
Você não precisa deste repositório: adicione a Arroway como conector, pela mesma página de Conexões.
Só a skill, em qualquer agente que leia skills
Se o seu agente lê skills mas não há plugin da Arroway para ele, adicione a skill de trabalho pela CLI do skills:
npx skills add oaleviola/arroway-plugin
A skill ensina o seu agente a ler a Arroway antes de agir e a fechar cada tarefa. Ela continua precisando da Arroway conectada como servidor MCP em https://www.arroway.app/api/mcp. Onde o seu cliente tem o plugin, use o plugin: ele traz também a conexão e os hooks.
Se quem instala é um agente de IA
Aponte para o llms-install.md: os passos de cada cliente, escritos para um agente, inclusive o Cline e qualquer outro cliente MCP.
Uso
Depois que você entrou, não há nada para chamar na mão: a skill diz ao seu assistente quando usar a Arroway. Acontece em quatro momentos, e é assim que cada um aparece.
Exemplos
- Antes de agir. Você pede: "Escreva a página de preços do plano novo." O assistente primeiro chama
arroway_readpara o seu projeto e responde a partir do que o time já decidiu. Se duas decisões se contradizem, ele avisa em vez de escolher uma. - Antes de afirmar algo.
arroway_normsdevolve o que já está decidido, por uma fração do custo de uma leitura completa, logo antes de o assistente te dizer algo ou propor um caminho. - Ao terminar.
arroway_logregistra o que alguém que chegar depois precisaria para não refazer o trabalho. Se da tarefa não saiu nada duradouro, o assistente diz isso em uma frase: No durable residue. - Ao parar sem terminar.
arroway_passdeixa onde o trabalho está, o único próximo passo, o que não deve ser refeito e o risco que continua aberto. O assistente da próxima pessoa encontra isso no topo da primeira leitura e assume comarroway_claim.
Você também pode pedir essas coisas direto:
- "Me atualize sobre o que aconteceu esta semana nos meus projetos." —
arroway_catch_up - "Onde a gente falou da mudança de preço?" —
arroway_search_log - "Lembre que a gente não dá desconto no plano anual." —
arroway_remember. O que você mesmo afirma fica registrado como decisão sua; o que um assistente propõe por conta própria espera uma pessoa aprovar.
Um exemplo curto: um assistente pesquisa uma mudança de preço e registra uma proposta. Uma pessoa aprova a decisão. Outro assistente escreve a página de preços usando essa decisão, e a próxima pessoa vê o que foi decidido, quem aprovou e o que continua em aberto.
Como fica
Telas de uma conta de demonstração com dados de exemplo (a interface dos prints está em inglês).
O que espera por você, entre projetos. As decisões que um assistente propôs ficam num lugar só até uma pessoa decidir.
Dentro de um projeto. As propostas de um assistente esperam aprovação (aprovar, aprovar e fixar, rejeitar ou corrigir), e as regras que o time fixou são o que todo assistente conectado lê primeiro.
Suas regras permanentes. Seu jeito de trabalhar vai com você para cada projeto, e mais ninguém o vê.
O que tem aqui
plugin/skills/— o protocolo de trabalho: ler antes de agir, registrar quando uma tarefa termina, passar o trabalho adiante quando você paraplugin/hooks/— os portões que cobram esses dois momentos, em vez de só descrevê-los, e uma conferência do texto antes de publicar algo para outras pessoasplugin/.mcp.json— a conexão do Claude Code, que usa o endereço da própria Arroway; a identidade vem de entrarplugin/.cursor-plugin/,plugin/cursor-mcp.json,plugin/hooks/cursor-hooks.json— o mesmo pacote como o Cursor o lê: manifesto e formato de hooks próprios, o endereço da própria Arroway, nenhum link para colarplugin/assets/— ícones e logotipos
Pedidos de permissão
O gancho de permissão do plugin (Claude Code e Codex) existe só para você responder, do seu próprio cockpit da Arroway, um pedido de permissão que o seu agente fez. Ele nunca aprova nada sozinho. Uma aprovação vale só para aquele pedido: o gancho calcula na sua máquina a impressão do pedido exato e só aceita um "allow" que volte preso a essa impressão e a um código de uso único, assinado com a credencial da sessão. Sem a sua resposta — ou com o cockpit desligado, o servidor fora do ar ou qualquer coisa que não confira — a janela pergunta como sempre. Você também pode negar pelo cockpit, e toda decisão fica registrada.
Este repositório é um espelho
Ele é gerado. A fonte mora em outro lugar e é publicada aqui automaticamente sempre que muda.
Por favor, não abra pull requests nem edite arquivos aqui — mudanças feitas neste repositório são sobrescritas na publicação seguinte, e um conserto que aterrissa aqui nunca chega ao produto. Duas edições, uma delas perdida em silêncio, é exatamente a falha que esta nota existe para evitar.
Encontrou um problema, ou quer sugerir alguma coisa? www.arroway.app/pt-BR/support. Para um problema de segurança, veja o SECURITY.md. Como ajudar está no CONTRIBUTING.md, e todo mundo aqui segue o código de conduta.
Links
Arroway · Como funciona · Privacidade · Termos · Mudanças por versão