Início rápido

Da instalação à primeira tarefa. Leve a CeloIA para o seu terminal e trabalhe com os arquivos do seu projeto.

Antes de começar

O celo é a CeloIA na linha de comando: conversa, investiga o projeto, cria ou altera arquivos e executa comandos com sua autorização.

Node.js 18.17 ou superior e npm instalados. Prefira uma versão LTS ainda suportada.
Uma conta CeloIA com plano e acesso à API habilitados.
Um terminal aberto na pasta em que você quer trabalhar.

Instale o Celo CLI

No terminal do Windows, macOS ou Linux, instale a versão mais recente do pacote e confira a versão.

Terminal

npm install -g @celoiaio/cli@latest
celo --version

Se o npm não for reconhecido, instale o Node.js pelo site oficial e reabra o terminal.

Baixar Node.js

Conecte sua conta

Terminal

celo login

O celo mostra um código e abre o navegador. Confira o código e o computador solicitante antes de autorizar. Nenhuma senha precisa ser digitada no terminal.

Abra seu projeto

Entre na pasta do projeto e inicie o celo. Substitua meu-projeto pelo caminho real da sua pasta; se já estiver nela, execute apenas celo.

Terminal

cd meu-projeto
celo

Na conversa, peça o trabalho em linguagem natural. O celo lê, lista e busca nos arquivos, grava alterações e pode executar comandos de terminal, como testes, build, instalação de pacotes e Git (commit e push). Você não precisa colar cada arquivo nem copiar o código da resposta.

Na conversa com o celo

Explique a estrutura deste projeto e onde fica a aplicação principal. Não altere nada.

Entregue sua primeira tarefa

Agora peça uma entrega concreta. O celo consulta os arquivos, grava o resultado no projeto e pode executar as verificações disponíveis com sua autorização.

Na conversa com o celo

Crie docs/visao-geral.md com a arquitetura deste projeto e as instruções para rodar localmente. Leia os arquivos antes de escrever. Execute os testes e o build disponíveis e informe os resultados.

Se o projeto usa Git, revise as alterações antes de publicar. Você também pode pedir ao celo para conferir o diff, fazer commit e push; esses comandos passam pela sua confirmação.

Continue de onde parou

Use /sair para encerrar. Para retomar a conversa mais recente deste computador, execute:

Terminal

celo -c

Explore os comandos — Flags, perguntas rápidas e atalhos da conversa.

Trabalhe com arquivos — Entenda as ferramentas e as confirmações de escrita e execução.