agent-gyrk 0.4.0

agent-gyrk — CLI agentic rodando o modelo GYRK (visão + plano)

agent-gyrk

🚧 Preview · acesso antecipado. Em construção ativa — e como o "cérebro" mora no servidor, as melhorias chegam sozinhas, sem reinstalar. 🚀

Agente de código no terminal rodando o GYRK (modelo próprio, na nuvem). O harness é dono do loop; o GYRK é só uma política de próxima-ação. Ação por turno = um JSON travado por gramática (response_format json_schema), com tool num enum fechado das tools ativas. Só stdlib.

Instalar (comando global, igual claude-code)

pipx install agent-gyrk     # cria o comando `gyrk` no PATH
gyrk                        # free, sem chave (limitado)
gyrk init                   # cola sua chave pra mais (tier Pro)

Usar

gyrk                          # REPL interativo
gyrk "liste os .py"           # tarefa única
gyrk --image erro.png "que erro é esse?"   # 👁 visão: lê print/screenshot
gyrk "recrie @mockup.png em html"          # clona uma UI a partir de imagem
gyrk --allow-local "..."      # libera run_bash (off por padrão)
gyrk --help

Novidades

• 👁 Visão — gyrk --image foto.png "..." ou @foto.png inline: lê tracebacks de print, descreve telas, e recria UIs a partir de uma imagem.
• 📋 Plano — em tarefas complexas (vários arquivos), o agente monta um checklist e trabalha passo a passo.
• 🧠 Memória — guarda o que importa entre sessões (/lembrar, /memoria); o recall é automático.

Config (env, sem segredo embutido)

var	default
GYRK_BASE_URL	endpoint da API GYRK (default api.gyrk.havek.ai)
GYRK_API_KEY	(vazio) — Bearer pro tier Pro (opcional; free é sem chave)
GYRK_ALLOW_LOCAL	0
GYRK_VISION_URL	endpoint de visão (default = o gateway)

Tools

list_files, read_file, grep, find_files, write_file, edit_file, make_dir, run_python, http_get, see_image, plan/check, remember/recall, note — escopadas na pasta atual. run_bash/run_background são gated (--allow-local). GYRK puro: zero Claude.