// começar · 03

Quickstart

Do clone ao chat em poucos minutos. Toda configuração é por menu de seta (↑↓ Enter); sem TTY interativo, a CLI cai num menu numerado equivalente. Você nunca edita Y…

  1. Instale

    git é o único pré-requisito. No alpha, revise o script no GitHub se preferir antes de executar.

    curl -fsSL https://okamiagent.com/install.sh | bash
    git clone https://github.com/OkamiOps/Okami-Agent && cd Okami-Agent && ./scripts/install.sh
  2. Configure (okami setup)

    Um wizard guia você por: provider → login → memória → identidade → canal. Ele detecta os providers que você já tem (ex.: um LMStudio local) e prepara o okami.yaml.

    okami setup
  3. Converse (okami chat)

    Abre a TUI de tela cheia. A sessão persiste — ao reabrir, a conversa continua de onde parou.

    okami chat
  4. Rode uma tarefa verificável

    okami task roda o harness até os exitCriteria baterem. Aqui, a tarefa só conclui se o arquivo existir de fato.

    okami task "crie hello.txt com 'oi'" -e file_exists:hello.txt
  5. Conecte um canal

    Defina o token do bot no agente e suba o gateway — agora você conversa pelo Telegram, com voz e go/no-go por chat.

    okami gateway

O que acabou de acontecer

O setup escreveu sua config; o chat abriu uma sessão persistente no workspace do agente default; o task rodou o harness (não uma chamada crua) e só declarou sucesso depois de verificar o exitCriteria. Esse é o coração do Okami: conclusão é uma asserção verificada, não a palavra do modelo.

Dentro do okami chat

A TUI é concorrente (estilo Claude Code): você digita enquanto o agente trabalha, as mensagens entram numa fila, Ctrl-C cancela o turno (não sai) e Ctrl-D sai. Os slash commands vêm de um registro declarativo:

/new · /stopnova conversa (arquiva a atual) · cancela a tarefa
/model · /thinktroca o modelo · esforço de raciocínio (lowhigh)
/feedback · /personamolda VOICE/PERSONA · overlay só na sessão
/like · /dislike · /differentensina o gosto de design (taste)
/status · /usage · /toolsestado · tokens e custo · ferramentas
/yolo · /undo · /helpauto-aprova · reverte identidade · ajuda

Abrir esta página nos docs interativos