Instalação e primeiro projeto

São quatro passos, e você só faz uma vez por computador e uma vez por projeto. Antes de começar, você precisa de:

• uma conta no Faundr (este site);
• o Claude Code ou o Codex instalado no seu computador. O plugin funciona nos dois;
• o Node.js 20 ou mais novo. O Claude Code e o Codex instalado pelo npm já pedem o Node, então quase sempre ele já está lá.

1. Crie o projeto no painel

1. Em Projetos, clique em Novo projeto.
2. Dê um nome (por exemplo, o nome do app) e clique em Criar projeto.

O projeto fica na organização atual, e todo o time dela passa a vê-lo. Se você ainda não tem time, a organização é só sua: veja Organização, time e conta.

2. Instale o plugin

Este passo é feito uma vez por computador. Os mesmos comandos, prontos para copiar, estão em Minha conta → Token do plugin.

No Claude Code

Abra o Claude Code e digite os dois comandos, um de cada vez:

/plugin marketplace add faundr-dev/faundr-plugin
/plugin install faundr@faundr

Depois, feche e abra o Claude Code para o plugin começar a valer.

No Codex

No Codex, a instalação é pelo terminal (fora do Codex). Rode os dois comandos:

codex plugin marketplace add faundr-dev/faundr-plugin
codex plugin add faundr@faundr

Depois, abra o Codex e digite /hooks. Ele lista os hooks do Faundr (os gatilhos que trazem a memória, registram o trabalho e protegem o projeto) e pede que você confie neles uma vez. Sem isso, o Faundr não roda nas sessões.

No Codex, as skills se chamam com $ em vez de /. Onde esta documentação diz /faundr:login, no Codex digite $faundr:login. Você também pode só pedir em palavras ("configure o Faundr neste projeto").

3. Conecte o agente à sua conta

1. No agente, rode:

/faundr:login

1. O navegador abre no Faundr com um código (por exemplo K7QX-M2PD). Confira se é o mesmo código que apareceu no terminal e clique em Autorizar.
2. Volte ao terminal: em alguns segundos ele responde "Login feito… Você tem N projeto(s)".

O token é criado no seu computador e nunca passa pelo chat: o Faundr só recebe uma impressão dele (o hash) e passa a aceitá-lo quando você autoriza. Ele fica salvo em ~/.faundr/config.json, que só você consegue ler.

O token é pessoal: ele diz ao Faundr quem está usando o agente e vale para os projetos de todas as suas organizações. Cada pessoa do time faz o próprio login. Em Minha conta → Token do plugin aparece um token por computador em que você fez login, com a data do último uso. Apague os que não usa mais: eles param de funcionar na hora.

4. Configure o projeto

Abra o agente na pasta do código do projeto e rode:

/faundr:setup

O setup confere e liga tudo de uma vez:

• Faz sozinho o que é seguro: liga a pasta ao projeto quando o nome dela (ou do package.json) bate com um projeto só, gera o mapa do código, a Stack e as primeiras checagens (segurança, qualidade, testes, design), liga a linha de status e lê as suas skills.
• Pergunta antes do que mexe em arquivos do projeto ou pede algo seu: criar o repositório git, pôr .faundr/ no .gitignore, trocar uma linha de status que você já usa, o bloco de regras no AGENTS.md (só se o time usa outro agente), o token pessoal do Supabase e os erros do app publicado. O que você recusar não é perguntado de novo.

No Codex: a regra de rede

O Codex roda os comandos do agente numa área protegida, sem internet. Os comandos do Faundr precisam da rede para gravar tarefas e funcionalidades no painel. Por isso, no Codex, o setup pergunta se pode criar a Regra do Codex: um arquivo em ~/.codex/rules/faundr.rules que libera só o comando do Faundr para rodar fora da área protegida. O resto continua protegido. A regra vale a partir da próxima sessão do Codex.

Até a regra existir, quando um comando do Faundr precisar da rede, o Codex pede a sua aprovação para rodá-lo fora da área protegida. Isso acontece também no primeiro $faundr:login e no primeiro $faundr:setup.

O que custa do seu plano

O mapa do código, a Stack detectada e as checagens rodam no seu computador, sem IA: não gastam nada do plano do Claude ou do Codex. O que gasta é o que o agente escreve. O setup lista cada um com o custo estimado em tokens, em % da sua janela de 5 horas e da semana (quando a barra do Faundr está ligada) e no equivalente em dólar na API, e você escolhe: só o essencial (Visão e classificar as skills), tudo, um por um ou nada agora.

A estimativa começa pelo tamanho do código e melhora sozinha: toda vez que uma skill roda, o Faundr mede o que ela gastou de verdade e passa a usar esse número neste projeto (e, proporcional ao tamanho, nos outros do time).

O setup também mostra quanto o fim das respostas tem custado (auditoria rápida de design, atualizar a Visão e a Stack) e oferece o modo econômico, que deixa esses três só para quando você pedir. Prova, bilhete de passagem e segurança continuam sempre.

Dá para rodar /faundr:setup de novo a qualquer hora: ele não muda nada que já está certo e mostra o que ainda falta. Para refazer o mapa e as checagens, /faundr:setup --refresh. No terminal comum, faundr setup faz o mesmo e pergunta sim ou não na hora.

Ligar a pasta à mão

Se o nome da pasta não bate com o projeto, o setup pede para escolher. Também dá para ligar direto:

/faundr:link

Sem nada depois, o comando lista os projetos que você pode ligar e pergunta qual é. Se você já sabe o nome, pode escrever direto: /faundr:link Minha Loja.

Isso cria um arquivo pequeno chamado .faundr.json na pasta, com o identificador do projeto. Ele pode ir para o git: assim, quem clonar o repositório já cai no projeto certo depois de fazer o próprio login.

O comando com o identificador do projeto, pronto para copiar, também está dentro do projeto, em Configurações → Geral.

Confira se deu certo

Rode /faundr:status no agente. Ele mostra o servidor em uso, o começo do token, o projeto ligado, a branch e se o mapa do código já existe, e diz o que falta configurar.

Depois, faça qualquer pedido ao agente e abra o projeto no painel. Em Atividade → Diário de sessões, a sessão aparece em tempo real (a conversa só para você; o time vê o resumo).

Primeiros passos recomendados

O /faundr:setup já gera o mapa do código e oferece os itens com IA abaixo, com o custo de cada um. Se você pulou algum, ou quer refazer, estes são os comandos:

Nada disso é obrigatório. As checagens de segurança, qualidade, design e testes já começam sozinhas na próxima sessão.

Opcional: barra de status

Só no Claude Code: o Codex não deixa um plugin mudar a tela dele. Rode /faundr:statusline para ver o Faundr no rodapé do agente:

Faundr · Minha Loja · Tela de login 2/5 · agora: Criar o formulário · grafo em dia · 1 preocupação

A barra lê só arquivos do seu computador: não gasta tokens nem usa a internet. Se você já tem uma barra de status, o Faundr não a substitui. Para trocar mesmo assim, use /faundr:statusline --force.

Opcional: outros agentes

O Claude Code e o Codex rodam o plugin. Se o time também usa o Cursor ou outro agente que não roda o plugin, /faundr:agents-md copia as regras e decisões do time para o AGENTS.md (ou o CLAUDE.md). Assim esses agentes também seguem a memória do projeto. O bloco se atualiza sozinho no começo de cada sessão em que o plugin roda. Para tirar, use /faundr:agents-md --off.

Vários projetos, várias pastas

• O login é por computador: você faz uma vez só.
• A ligação é por pasta. Cada repositório tem o próprio .faundr.json.
• Num repositório com várias partes (por exemplo, app/ e site/), dá para ligar cada pasta a um projeto diferente. O Faundr procura o .faundr.json subindo de pasta em pasta e usa o mais próximo.