wizelit-cli 0.1.17

Wizelit terminal agent — installable CLI for local repo work

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: brew install uv
2. Install the CLI:

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

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

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:

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

One-shot (no install)

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