Luckee CLI

0.1.20260427125135500 verified Mon Apr 27 auth: no python

CLI for Core Agent Loop websocket streaming, providing a command-line interface to interact with agent loops via WebSocket. Current version 0.1.20260427125135500, requires Python >=3.10. Rapidly evolving pre-release with breaking changes expected.

pip install luckee-cli

Common errors

error ModuleNotFoundError: No module named 'luckee-cli' ↓

cause Trying to import with hyphen instead of underscore.

fix

Use from luckee_cli import LuckeeCLI (underscore)

error ValueError: Expected a websocket URL starting with ws:// or wss:// ↓

cause Missing or invalid websocket_url parameter.

fix

Set the websocket_url argument or LUCKEE_WS_URL environment variable to a valid WS/WSS URL.

Warnings

breaking Pre-release version (0.1.x) - breaking changes may occur without notice. Pin exact version in production. ↓

fix Pin to exact version, e.g., luckee-cli==0.1.20260427125135500

gotcha The package import uses underscore (luckee_cli) not hyphen. Common mistake to use `import luckee-cli` which is invalid. ↓

fix Use `from luckee_cli import LuckeeCLI`

gotcha WebSocket connection requires valid URL; no default provided. Using empty string or None may cause cryptic errors. ↓

fix Always set LUCKEE_WS_URL environment variable or pass websocket_url parameter.

Imports

LuckeeCLI
```
from luckee_cli import LuckeeCLI
```
Main CLI class for interacting with agent loops.

Quickstart

Minimal example to import and run the Luckee CLI. Replace WSS URL as needed.

from luckee_cli import LuckeeCLI
import os

# Initialize CLI with optional WebSocket URL
cli = LuckeeCLI(websocket_url=os.environ.get('LUCKEE_WS_URL', 'wss://example.com/ws'))
# Run the CLI (example command)
cli.run()