Primeiros passos

O k4tron é um agente de código que trabalha com você onde você trabalha — ele lê, edita e executa no seu projeto. Há dois clientes, e os dois são o mesmo k4tron: a extensão para VS Code e o CLI para qualquer terminal. Sua conta e suas sessões valem nos dois. Este guia leva você da instalação à primeira tarefa.

1. Instale um cliente

  • Extensão: adicione o k4tron ao seu VS Code.
  • CLI: instale o k4tron pelo npm e rode k4tron no terminal do seu projeto — funciona com qualquer editor, no Windows, macOS e Linux.

Não há API key para configurar nem painel de settings: os clientes são simples de propósito.

2. Gere seu código de conexão

Na primeira vez, o cliente pede conexão — clique em “Gerar código de conexão” (na extensão) ou siga o link que o CLI mostra. Isso abre app.k4tron.com/connect com o nome do seu dispositivo já preenchido — crie sua conta ali. Toda conta nova nasce com créditos de teste, sem cartão.

3. Cole o código

O site gera um código no formato k4t_…. Copie, volte ao cliente, cole no campo “Cole o código (k4t_…)” e conecte. Cada dispositivo usa o seu próprio código, revogável a qualquer momento pela sua conta.

4. Abra uma sessão

Depois de conectar, o painel de sessões aparece. Abra uma nova sessão para começar. Cada conversa é uma sessão, retomável quando você quiser — inclusive no outro cliente: comece no editor, continue no terminal.

5. Mande a primeira tarefa

Digite o que você quer (“corrigir os testes que estão falhando”, “refatorar este módulo”, “subir um servidor de dev”) e pressione Enter. O agente planeja, lê o contexto e executa no seu projeto — você acompanha cada passo no feed.

  • Permissões: por padrão o agente pede confirmação antes de cada ação (modo “Pedir permissão”). Para autonomia total, troque para “Auto-aprovar”.
  • Níveis: escolha o tier conforme a tarefa — Lite (trivial), Basic (uso geral, padrão), Standard (desenvolvimento diário) e Premium (arquitetura e refatorações grandes). Você escolhe o nível; a plataforma cuida do modelo.
  • Créditos: o custo da sessão aparece em créditos, em tempo real, na barra de status.

Esta documentação está em construção — novas seções chegam em breve.