👻 Wraith-CLI

Sovereign Orchestration & NAS Management for the Ghost Stack

Wraith-CLI is the nervous system of the Ghost Stack. It bridges the gap between high-level container orchestration and bare-metal reality — instant project scaffolding, container operations, and a full NAS management suite in one binary.

🗄️ NAS Management Suite

Every read-only command takes --json — pipe Wraith straight into dashboards, monitoring stacks, or fleet tooling. Unattended monitoring is one cron line:

*/30 * * * * wraith doctor --notify

See the NAS Management docs for full coverage.

🚀 Installation & Updates

Wraith-CLI is managed via uv for hermetic stability.

# Initial Installation
uv tool install wraith-cli

# Sovereign Update
wraith update

🔐 Environment Configuration

Defined in your .env or system environment. HTTPS is required for automated Gitea provisioning.

🧪 Developer Quality Gate

We use uv for hermetic environment management and maintain a strict >80% coverage requirement.

# Initialise the Environment
uv sync --all-extras
uv run pre-commit install

# The Quality Gate
uv run pytest --cov=src

📜 Sovereign Principles

1. Distributed Sovereignty: Available on PyPI for the world, but optimised for local-first, private-registry mirrors.
2. Atomic Execution: Use uv run to ensure consistency across the stack.
3. Hardware First: Prioritise bare-metal health and container stability over abstraction.