# GrokBoy

Minimal local **GrokBot-like** CLI agent. Phase **P0**: streaming chat only.

## Status

| Phase | Status |
|-------|--------|
| P0 streaming chat | done |
| P1 shell / files + ReAct | next |
| P2 completion / loop guard | planned |
| P3 browser (Playwright) | later |

No Docker desktop, no Codex/LazyBoy fork.

## Setup (macOS)

```bash
export GROKBOY_API_KEY=your_key   # or XAI_API_KEY
# optional:
# export GROKBOY_BASE_URL=https://api.x.ai/v1
# export GROKBOY_MODEL=grok-4

cd ~/GrokBoy
cargo run -p grokboy -- chat
```

## Commands

- `grokboy chat` — interactive streaming chat
- `grokboy help`

## 繁體中文

本機終端機聊天 bot。P0 只能對話；P1 才會加讀寫檔與 shell。

```bash
export GROKBOY_API_KEY=你的金鑰
cd ~/GrokBoy
cargo run -p grokboy -- chat
```

## Layout

```
crates/grokboy-core/   # config + streaming client
crates/grokboy/       # CLI binary
docs/ACCEPTANCE.md
```