Metadata-Version: 2.4
Name: agent-gyrk
Version: 0.4.0
Summary: agent-gyrk — CLI agentic rodando o modelo GYRK (visão + plano)
Author: Havek
Project-URL: Homepage, https://gyrk.havek.ai
Keywords: gyrk,agent,cli,llm,coding-agent
Classifier: Programming Language :: Python :: 3
Classifier: Environment :: Console
Classifier: Topic :: Software Development
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# 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)

```bash
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

```bash
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.
