feat: CLI and Configuration (F04)

Cargo.toml

@@ -39,6 +39,14 @@ tracing-subscriber = { version = "0.3", features = ["env-filter", "json"] }
 
 # CLI
 clap = { version = "4", features = ["derive", "env"] }
+clap_complete = "4"
+
+# Configuration
+config = { version = "0.14", default-features = false, features = ["toml"] }
+
+# Output formatting
+comfy-table = "7"
+colored = "2"
 
 # mDNS discovery
 mdns-sd = "0.11"
@@ -54,6 +62,7 @@ wiremock = "0.6"
 assert_cmd = "2"
 predicates = "3"
 proptest = "1"
+tempfile = "3"
 
 [profile.release]
 lto = true

README.md

@@ -29,13 +29,60 @@ Nexus is a distributed LLM model serving orchestrator that unifies heterogeneous
 # Install (from source)
 cargo install --path .
 
+# Generate a configuration file
+nexus config init
+
 # Run with auto-discovery
 nexus serve
 
-# Or with a config file
+# Or with a custom config file
 nexus serve --config nexus.toml
 ```
 
+## CLI Commands
+
+```bash
+# Start the server
+nexus serve [--config FILE] [--port PORT] [--host HOST]
+
+# List backends
+nexus backends list [--json] [--status healthy|unhealthy|unknown]
+
+# Add a backend manually (auto-detects type)
+nexus backends add http://localhost:11434 [--name NAME] [--type ollama|vllm|llamacpp]
+
+# Remove a backend
+nexus backends remove <ID>
+
+# List available models
+nexus models [--json] [--backend ID]
+
+# Show system health
+nexus health [--json]
+
+# Generate config file
+nexus config init [--output FILE] [--force] [--minimal]
+
+# Generate shell completions
+nexus completions bash > ~/.bash_completion.d/nexus
+nexus completions zsh > ~/.zsh/completions/_nexus
+nexus completions fish > ~/.config/fish/completions/nexus.fish
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `NEXUS_CONFIG` | Config file path | `nexus.toml` |
+| `NEXUS_PORT` | Listen port | `8000` |
+| `NEXUS_HOST` | Listen address | `0.0.0.0` |
+| `NEXUS_LOG_LEVEL` | Log level (trace/debug/info/warn/error) | `info` |
+| `NEXUS_LOG_FORMAT` | Log format (pretty/json) | `pretty` |
+| `NEXUS_DISCOVERY` | Enable mDNS discovery | `true` |
+| `NEXUS_HEALTH_CHECK` | Enable health checking | `true` |
+
+**Precedence**: CLI args > Environment variables > Config file > Defaults
+
 ## Usage
 
 Once running, Nexus exposes an OpenAI-compatible API: