Metadata-Version: 2.4
Name: wizelit-cli
Version: 0.1.17
Summary: Wizelit terminal agent — installable CLI for local repo work
Author-email: Wizeline <engineering@wizeline.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agents,cli,deepagents,terminal,wizelit
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Terminals
Requires-Python: >=3.12
Requires-Dist: wizelit-core==0.1.17
Description-Content-Type: text/markdown

# Wizelit CLI

Terminal agent for local repository work. Depends on **`wizelit-core`** only (no FastAPI, SQLAlchemy, or Postgres). Settings and MCP sync from your Wizelit hub; skills and subagents ship inside `wizelit-core`.

Install via **`uv tool install`** (Python 3.12+ pulled automatically).

## Setup

1. Install [uv](https://docs.astral.sh/uv/): `brew install uv`
2. Install the CLI:

```bash
uv tool install wizelit-cli@latest
wizelit-agent --help
```

3. Create **`~/.wizelit/.env`** (minimum):

```bash
WIZELIT_API_URL=https://your-wizelit-hub.example.com
WIZELIT_IDE_TOKEN=wiz_xxxxxxxx
# LLM credentials (match your web UI provider):
GOOGLE_API_KEY=...
# and/or AWS_REGION + keys for Bedrock, ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.
```

4. Sync settings from the hub, then run:

```bash
wizelit-agent --sync-profile
wizelit-agent -i --repo /path/to/your-project
```

## One-shot (no install)

```bash
uvx --from wizelit-cli wizelit-agent -i --repo /path/to/project
```

## Config

| Path | Purpose |
|------|---------|
| `~/.wizelit/.env` | Hub URL, IDE token, LLM credentials |
| `~/.wizelit/profile.json` | Synced LLM + MCP settings (from `--sync-profile`) |
| `{repo}/.agent/cli_checkpoints.sqlite` | Conversation checkpoints per repo |

Override config directory: `WIZELIT_CONFIG_DIR`.

## REPL commands

| Input | Action |
|-------|--------|
| `/exit`, `/quit` | Leave the REPL |
| `/reload` | Rebuild agent + reconnect MCP |
| `/sync` | Refresh profile from API, then reload |
| `Ctrl+C` | Interrupt current turn |

## Troubleshooting

| Symptom | What to do |
|---------|------------|
| `wizelit-agent: command not found` | New terminal after install, or `uv tool update-shell` |
| `401` on `--sync-profile` | Refresh `WIZELIT_IDE_TOKEN` in `~/.wizelit/.env` |
| Hub unreachable | Check `WIZELIT_API_URL`; ensure backend is running |
| One-shot opens REPL | Drop `-i` when passing a prompt on the command line |

Upgrade: `uv tool upgrade wizelit-cli`
