weio-cli 0.4.0

Weio — an agentic coding assistant that routes inference through your Weio account.

weio-cli

An agentic coding assistant that runs on your machine and routes inference through your Weio account.

Install

pip install weio-cli        # or: pipx install weio-cli

Requires Python 3.9+.

Authenticate

weio login            # opens your browser, sign in (incl. Google), key is created automatically

weio login starts a one-time local handshake, opens weio.ai in your browser to sign in, mints an API key for this device, and saves it to ~/.weio/config.json. No copy-paste.

Prefer to paste a key yourself? Generate one in Settings → API & CLI on weio.ai and:

weio login --no-browser     # paste your weio_sk_… key
# or, per session:
export WEIO_API_KEY="weio_sk_…"

Check what you're using:

weio usage            # tier, tokens used today, remaining, reset time

Use

Interactive TUI (default)

Run weio with no arguments to drop into an interactive coding session — like a local pair-programmer in your terminal:

cd my-project
weio

weio › add a /health route to app.py that returns {"ok": true}

weio: I'll add a health check route…
  ● edit app.py
  --- a/app.py
  +++ b/app.py
  @@ …
  Apply 1 change(s)? [y/N] y
  ✓ applied 1 change(s). (/undo to revert)

Slash commands: /add <file>, /drop <file>, /files, /auto (auto-apply), /model <id>, /undo, /clear, /cwd, /help, /exit. Arrow-up recalls history. Files you mention or /add are kept in context and re-read each turn.

One-shot & other commands

# Run a single coding task non-interactively (reads & edits files):
weio "add error handling to the fetch() in api.py"

# Add specific files to the context:
weio code "refactor to async" -f server.py -f db.py

# One-shot question (no file edits):
weio ask "what does a 502 from nginx usually mean?"

# Interactive chat:
weio chat

# Check connectivity and your key:
weio ping

Edits are shown as a diff and require confirmation before anything is written (use -y/--yes to apply automatically). New files are created as needed.

Updating

weio-cli checks PyPI once a day (fail-silent) and prints a one-line notice when a newer version is available. To upgrade:

weio update           # upgrades in place via pip
# or
pip install -U weio-cli

Disable the check with WEIO_NO_UPDATE_CHECK=1.

Configuration

Setting	Flag	Env	Config file
API key	--key	WEIO_API_KEY	~/.weio/config.json
API base	--base	WEIO_BASE	~/.weio/config.json
Model	--model	—	—

Self-hosted / LAN gateway? Point at it with --base http://HOST:8901/v1.

Output is billed against your Weio account usage.