Metadata-Version: 2.4
Name: agent-gyrk
Version: 0.3.1
Summary: agent-gyrk — CLI agentic rodando o modelo GYRK
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

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 --allow-local "..."  # libera run_bash (off por padrão)
gyrk --help
```

## 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 gateway autenticado (Fase 3) |
| `GYRK_ALLOW_LOCAL` | `0` |
| `GYRK_MAX_TOKENS` | `2048` |
| `GYRK_TEMP` | `0.2` |

## Tools (MVP)

`list_files`, `read_file`, `grep`, `write_file`, `run_python` — escopadas na pasta
atual. `run_bash` é gated (`--allow-local`). GYRK puro: zero Claude.
