Skip to content

CLI Usage

Install

Terminal window
cd ~/core-x-kbllr_0
pip install -e "core-x/[cli]"
corex --help

Common Commands

Terminal window
corex # Interactive menu (InquirerPy)
corex chat # Direct LLM chat
corex rag search # RAG search
corex services # Service health dashboard

Import Chain Smoke Tests

Verify the CLI module tree loads correctly:

Terminal window
PYTHONPATH=core-x python -c "from core_x.cli.ui.theme import style; print('theme OK')"
PYTHONPATH=core-x python -c "from core_x.cli.ui.framed_app import FramedApp; print('framed_app OK')"
PYTHONPATH=core-x python -c "from core_x.cli.ui.layouts import build_frame; print('layouts OK')"
PYTHONPATH=core-x python -c "from core_x.cli.ui.grid_menu import CardMenu; print('grid_menu OK')"
PYTHONPATH=core-x python -c "from core_x.cli.ui.app_frames import get_app_frame; print('app_frames OK')"
PYTHONPATH=core-x python -c "from core_x.cli.ui.chat_framed_app import ChatFramedApp; print('chat_framed_app OK')"
PYTHONPATH=core-x python -c "from core_x.cli.ui.settings import load_ui_settings; print('settings OK')"

corex-cli-v2 (Video Analysis Pipeline)

A separate Rich TUI for multimodal video analysis:

Terminal window
cd ~/core-x-kbllr_0/corex-cli-v2
python3.12 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
corex video analyze --help
corex video analyze --input /path/to/video.mp4 --out ./output
corex models list

Requires gateway (:8090), mlx-audio (:8093 for Whisper STT), and mlx-vision (:8094 for Qwen) to be running.

corex-disk-study (Disk Usage + Cleanup)

A separate repo (~/corex-disk-study/) for safe macOS disk analysis and cleanup planning. Safety-first: SAFE-only targets, Trash-only deletes, gated confirmation, dry-run by default.

Terminal window
cd ~/corex-disk-study
python3.12 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
corex disk study --path ~ --export ./var/reports/disk-study/
corex disk plan --export ./var/reports/disk-study/
corex disk apply --plan ./var/reports/disk-study/<plan>.json --dry-run
corex disk snapshots # list previous study snapshots

No Core-X services required — runs fully offline against the local filesystem.