Voltar

AIKO Terminal

A AIKO na linha de comando: além de conversar, ela pode ler e escrever arquivos e rodar comandos na sua máquina — sempre com a sua confirmação. O chat do site nunca faz isso.

Antes de começar

  • Node.js 20 ou mais novo — confira com node -v. Se não tiver, baixe em nodejs.org.
  • Uma conta na AIKO. O Terminal usa o seu plano e os seus créditos, igual ao chat do site.

Instalar

macOS e Linux

curl -fsSL https://project-aiko.com/install.sh | sh

Windows (PowerShell)

irm https://project-aiko.com/install.ps1 | iex

O instalador baixa o pacote deste site, confere o checksum SHA-256 e instala com o npm. Se der erro de permissão no Linux/macOS, ele instala só para o seu usuário, em ~/.local.

Prefere instalar manualmente?

Baixe o pacote, confira o checksum e instale. Os arquivos ficam em /download/.

curl -fsSLO https://project-aiko.com/download/aiko-terminal-latest.tgz
curl -fsSLO https://project-aiko.com/download/SHA256SUMS
sha256sum -c --ignore-missing SHA256SUMS   # macOS: shasum -a 256 -c SHA256SUMS
npm install -g ./aiko-terminal-latest.tgz

Primeiro uso

Rode aiko login. O navegador abre pedindo para você autorizar este terminal na sua conta (vale por 5 minutos). Depois é só digitar aiko em qualquer pasta — ela vira o espaço de trabalho da conversa.

  • aiko loginabre o navegador para autorizar este terminal na sua conta
  • aikoabre o chat (o mesmo que aiko chat)
  • aiko skillslista as Skills disponíveis
  • aiko chat --skill <slug>abre o chat com uma Skill ativa
  • aiko whoamimostra qual conta está logada
  • aiko logoutremove a credencial local deste terminal

Segurança: leia antes de confirmar

Cada ação (rodar um comando, ler, criar ou editar um arquivo) pede a sua confirmação: y permite uma vez, a permite nesta sessão, n nega. A pasta onde você abriu o aiko é o espaço de trabalho; arquivos fora dela ficam bloqueados, a menos que você use --allow-outside-workspace <caminho>.

  • Linux com bubblewrap (bwrap): os comandos rodam isolados — só a pasta atual é gravável e não há rede por padrão.
  • macOS: sem isolamento de sistema. Vale só a sua confirmação.
  • Windows: sem isolamento, e os comandos rodam no cmd.exe, então comandos no estilo Linux (ls, grep) podem falhar. Chat e ferramentas de arquivo funcionam normalmente.
  • --omakase pula as confirmações. Use só se você confia no que vai pedir a ela.

Atualizar e remover

  • Atualizar: rode o comando de instalação de novo.
  • Remover: aiko logout e depois npm uninstall -g @aiko/terminal.
  • Revogar um computador: em Configurações, na sua conta, você vê os terminais autorizados e pode revogar qualquer um.

Problemas comuns

  • Não logado — rode aiko login.
  • Sua autorização expirou ou foi revogada — rode aiko login de novo.
  • O navegador não abriu — copie a URL que o terminal mostra e abra manualmente; conclua em até 5 minutos.
  • "aiko" não é reconhecido — feche e abra o terminal. Se continuar, adicione a pasta de binários globais do npm (npm prefix -g) ao PATH.