Metadata-Version: 2.4
Name: rf-leafar
Version: 0.1.5
Summary: Android development CLI by Rafael Alves
Author-email: Rafael Alves <ifaelmg18@icloud.com>
License: MIT
Project-URL: Homepage, https://github.com/faelmg18/leafar
Project-URL: Repository, https://github.com/faelmg18/leafar
Keywords: android,adb,cli,development,automation
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Topic :: Software Development
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: anthropic>=0.40.0
Requires-Dist: claude-agent-sdk>=0.1.61
Requires-Dist: click>=8.1.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: requests>=2.31.0
Requires-Dist: rich>=13.0.0
Requires-Dist: prompt_toolkit>=3.0.0
Requires-Dist: mcp>=1.0.0

# rf — Android Development CLI

> Automação inteligente para desenvolvimento Android.

```
      /\        /\
     /  \      /  \
 ╔═══════════════════════╗
 ║  ◉               ◉  ║
 ╠═══════════════════════╣
 ║  ▸ rf  ·  leafar      ║
 ║  android  ai  agent   ║
 ╚═══════════════════════╝
   powered by Rafael Alves
```

## Instalação

```bash
# Via script (recomendado — instala tudo automaticamente)
curl -fsSL https://raw.githubusercontent.com/faelmg18/leafar/main/install.sh | sh

# Via pipx (ambiente isolado)
pipx install rf-leafar

# Via pip (macOS: use pip3)
pip3 install rf-leafar
```

**Requisitos:** Python 3.10+, Node.js, Android SDK (`adb` no PATH)

> **pipx** instala o `rf` em ambiente isolado — não interfere no Python do sistema e remove limpo com `pipx uninstall rf-leafar`.

## Testando sem instalar permanentemente

```bash
# Instala, usa e remove
pip3 install rf-leafar
rf init
# ... quando terminar:
pip3 uninstall rf-leafar -y
```

> O `rf` requer Python 3.10+, Node.js e `adb` no PATH — certifique-se que o ambiente Android está configurado (Android Studio instalado).

## Primeiros passos

```bash
cd /seu-projeto-android
rf init    # configura o projeto automaticamente
rf chat    # abre o terminal de desenvolvimento
```

## Comandos

```bash
rf init          # Detecta package, configura ferramentas, gera CLAUDE.md
rf chat          # Abre o terminal de desenvolvimento
rf ask "..."     # Executa uma tarefa diretamente
rf run           # Build + instala + lança o app no emulador
rf screenshot    # Captura a tela do emulador
rf navigate      # Navega para uma tela do app
rf debug         # Depura um problema no app
```

## O que o rf faz

Conecta seu projeto Android a um conjunto de ferramentas de automação:

| Categoria | Ferramentas |
|---|---|
| **Emulador** | screenshot, tap, swipe, input de texto, teclas |
| **ADB** | comandos diretos, hierarquia de UI, activity atual |
| **App** | launch, stop, install APK |
| **Código** | leitura, escrita e busca em arquivos |
| **Gradle** | build, install, testes |

## Integrações

Configure dentro do terminal conforme precisar:

- 🐙 **GitHub** — `/github-login`
- ☁️ **Azure DevOps** — `/azure-login`
- 🎨 **Figma** — via plugin

## Licença

MIT © Rafael Alves
