feat: Interactive CLI Wizard for Zero-Config Onboarding

[mrbeandev]

Summary

Closes #350

I implemented an interactive TUI setup wizard that launches automatically when no configuration file is detected. Running ./picoclaw without a config now guides users through the entire setup in about a minute instead of erroring out.

What it does

Step 1: Environment Detection

• Auto-detects Ollama, network connectivity, and NPU hardware (/dev/apex_0, /dev/npu, /dev/rknn)
• Uses results to suggest smart defaults (e.g., defaults to OpenRouter if no Ollama but online)

Step 2: AI Provider Setup

• Arrow-key selection menu for 7 providers: Ollama/vLLM, OpenRouter, OpenAI, Anthropic, Gemini, Zhipu, Groq
• Masked API key input (characters shown as *)
• Dynamic model list fetching from each provider's API with interactive selection
• Searchable type-to-filter selector for large model lists (>20 items, e.g., OpenRouter has 340+)
• Graceful fallback to manual text input if API fetch fails

Step 3: Channel Selection

• Arrow-key selection: Terminal (CLI), Telegram, Discord, Slack
• Prompts for required tokens per channel
• Optional user allowlist configuration

Step 4: Review & Save

• Summary screen showing all choices
• Saves valid config.json to ~/.picoclaw/
• Creates workspace template files
• Option to immediately start the agent

Technical details

• Raw terminal I/O via golang.org/x/sys/unix (TCGETS/TCSETS) for arrow-key menus
• Vim keybindings (j/k) alongside arrow keys
• Fallback mode: number-based selection when raw terminal mode isn't available
• 10 unit tests covering config paths, CSV parsing, visible length calculation, environment detection, and all JSON model parsers
• Provider API endpoints tested against live services before implementation

Files changed

• cmd/picoclaw/main.go — 3-line trigger: if no args + no config → run wizard
• cmd/picoclaw/wizard.go — Full wizard implementation (1271 lines)
• cmd/picoclaw/wizard_test.go — 10 tests, all passing

Testing

go build -o build/picoclaw ./cmd/picoclaw/   # ✅ builds clean
go test ./cmd/picoclaw/ -v                     # ✅ 10/10 tests pass
mv ~/.picoclaw/config.json ~/.picoclaw/config.json.bak
./build/picoclaw                               # launches wizard