Metadata-Version: 2.1
Name: picode
Version: 0.2.7
Summary: PiCode — CLI coding agent for PiGPT API
Author: pigpt
License: Proprietary
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27
Requires-Dist: typer>=0.12
Requires-Dist: rich>=13.7
Provides-Extra: desktop
Requires-Dist: PySide6-Essentials>=6.6; extra == "desktop"

# PiCode — CLI مشتری PiGPT

دستیار کدنویسی خط‌فرمان (**PiCode**؛ باینری/پکیج: `picode`) که به API محصول **PiGPT** وصل می‌شود.

## نصب (یک دستور — بدون کلون ریپو)

### macOS / Linux / WSL

```bash
curl -fsSL https://pigpt.ir/install-picode.sh | bash
```

اگر در همین شل پیدا نشد:

```bash
export PATH="$HOME/.local/bin:$PATH"
```

نیاز: **Python ≥ 3.10** (روی لینوکس/مک باید از قبل باشد). اسکریپت venv در `~/.picode-venv` می‌سازد، wheel را از `https://pigpt.ir/downloads/picode/` نصب می‌کند و `~/.local/bin` را به PATH اضافه می‌کند. API پیش‌فرض: `https://pigpt.ir`.

### Windows (PowerShell) — یک دستور؛ پایتون هم خودکار

```powershell
irm https://pigpt.ir/install-picode.ps1 | iex
```

اگر Python نباشد، اسکریپت خودش **Python 3.12** را نصب می‌کند (اول winget، وگرنه نصب‌کنندهٔ رسمی python.org به‌صورت per-user/quiet). یا:

```powershell
powershell -ExecutionPolicy Bypass -Command "irm https://pigpt.ir/install-picode.ps1 | iex"
```

### بعد از نصب

```bash
picode --version
picode --help
picode login          # مرورگر روی pigpt.ir
picode                # نشست تعاملی (REPL)
picode chat "سلام"    # یک‌مرحله‌ای → POST /api/v1/cli/chat
```

توکن و تنظیمات در `~/.picode/config.json` ذخیره می‌شوند.

## ورود

```bash
picode login
```

پیش‌فرض API: `https://pigpt.ir` (قابل تغییر با `PICODE_API_URL`، `--api-url`، یا `api_url` در config).

جایگزین:

```bash
picode login --manual
picode login --token "eyJ…"
picode login --no-browser
picode logout
```

```bash
export PICODE_API_URL=https://pigpt.ir   # production (default)
# export PICODE_API_URL=http://127.0.0.1:8000  # local API only
```

## REPL و دستورات اسلش

بدون زیر‌دستور، `picode` وارد **REPL** می‌شود. داخل REPL با `/` یا `/help` فهرست دستورات را ببینید.

| دستور | کار |
|--------|-----|
| پیام عادی | چت با agent |
| `/help` | راهنما |
| `/status` | احراز هویت، پلن، کوتا |
| `/model [id]` | مدل جاری |
| `/login` / `/logout` | ورود / خروج |
| `/exit` | خروج از REPL |

## افزونه VS Code

Marketplace نیست. VSIX:

```bash
code --install-extension https://pigpt.ir/downloads/picode/picode-0.1.1.vsix
```

یا از صفحهٔ [دانلود PiCode](https://pigpt.ir/app/cli).

## توسعه از سورس (اختیاری)

اگر ریپوی monorepo را دارید:

```bash
python3 -m venv .venv && .venv/bin/pip install -e packages/picode
```
