nodmix 2026.5.25

package/docs/start/showcase.md

@@ -0,0 +1,383 @@
+---
+summary: "Community-built projects and integrations powered by Nodmix"
+title: "Showcase"
+description: "Real-world Nodmix projects from the community"
+read_when:
+  - Looking for real Nodmix usage examples
+  - Updating community project highlights
+---
+
+Nodmix projects are not toy demos. People are shipping PR review loops, mobile apps, home automation, voice systems, devtools, and memory-heavy workflows from the channels they already use — chat-native builds on Telegram, WhatsApp, Discord, and terminals; real automation for booking, shopping, and support without waiting for an API; and physical-world integrations with printers, vacuums, cameras, and home systems.
+
+<Info>
+**Want to be featured?** Share your project in [#self-promotion on Discord](https://discord.gg/clawd) or [tag @nodmix on X](https://x.com/nodmix).
+</Info>
+
+## Videos
+
+Start here if you want the shortest path from "what is this?" to "okay, I get it."
+
+<CardGroup cols={3}>
+
+<Card title="Full setup walkthrough" href="https://www.youtube.com/watch?v=SaWSPZoPX34">
+  VelvetShark, 28 minutes. Install, onboard, and get to a first working assistant end to end.
+</Card>
+
+<Card title="Community showcase reel" href="https://www.youtube.com/watch?v=mMSKQvlmFuQ">
+  A faster pass across real projects, surfaces, and workflows built around Nodmix.
+</Card>
+
+<Card title="Projects in the wild" href="https://www.youtube.com/watch?v=5kkIJNUGFho">
+  Examples from the community, from chat-native coding loops to hardware and personal automation.
+</Card>
+
+</CardGroup>
+
+## Fresh from Discord
+
+Recent standouts across coding, devtools, mobile, and chat-native product building.
+
+<CardGroup cols={2}>
+
+<Card title="PR Review to Telegram Feedback" icon="code-pull-request" href="https://x.com/i/status/2010878524543131691">
+  **@bangnokia** • `review` `github` `telegram`
+
+OpenCode finishes the change, opens a PR, Nodmix reviews the diff and replies in Telegram with suggestions plus a clear merge verdict.
+
+  <img src="/assets/showcase/pr-review-telegram.jpg" alt="Nodmix PR review feedback delivered in Telegram" />
+</Card>
+
+<Card title="Wine Cellar Skill in Minutes" icon="wine-glass" href="https://x.com/i/status/2010916352454791216">
+  **@prades_maxime** • `skills` `local` `csv`
+
+Asked "Robby" (@nodmix) for a local wine cellar skill. It requests a sample CSV export and a store path, then builds and tests the skill (962 bottles in the example).
+
+  <img src="/assets/showcase/wine-cellar-skill.jpg" alt="Nodmix building a local wine cellar skill from CSV" />
+</Card>
+
+<Card title="Tesco Shop Autopilot" icon="cart-shopping" href="https://x.com/i/status/2009724862470689131">
+  **@marchattonhere** • `automation` `browser` `shopping`
+
+Weekly meal plan, regulars, book delivery slot, confirm order. No APIs, just browser control.
+
+  <img src="/assets/showcase/tesco-shop.jpg" alt="Tesco shop automation via chat" />
+</Card>
+
+<Card title="SNAG screenshot-to-Markdown" icon="scissors" href="https://github.com/am-will/snag">
+  **@am-will** • `devtools` `screenshots` `markdown`
+
+Hotkey a screen region, Gemini vision, instant Markdown in your clipboard.
+
+  <img src="/assets/showcase/snag.png" alt="SNAG screenshot-to-markdown tool" />
+</Card>
+
+<Card title="Agents UI" icon="window-maximize" href="https://releaseflow.net/kitze/agents-ui">
+  **@kitze** • `ui` `skills` `sync`
+
+Desktop app to manage skills and commands across Agents, Claude, Codex, and Nodmix.
+
+  <img src="/assets/showcase/agents-ui.jpg" alt="Agents UI app" />
+</Card>
+
+<Card title="Telegram voice notes (papla.media)" icon="microphone" href="https://papla.media/docs">
+  **Community** • `voice` `tts` `telegram`
+
+Wraps papla.media TTS and sends results as Telegram voice notes (no annoying autoplay).
+
+  <img src="/assets/showcase/papla-tts.jpg" alt="Telegram voice note output from TTS" />
+</Card>
+
+<Card title="CodexMonitor" icon="eye" href="https://clawhub.ai/odrobnik/codexmonitor">
+  **@odrobnik** • `devtools` `codex` `brew`
+
+Homebrew-installed helper to list, inspect, and watch local OpenAI Codex sessions (CLI + VS Code).
+
+  <img src="/assets/showcase/codexmonitor.png" alt="CodexMonitor on ClawHub" />
+</Card>
+
+<Card title="Bambu 3D Printer Control" icon="print" href="https://clawhub.ai/tobiasbischoff/bambu-cli">
+  **@tobiasbischoff** • `hardware` `3d-printing` `skill`
+
+Control and troubleshoot BambuLab printers: status, jobs, camera, AMS, calibration, and more.
+
+  <img src="/assets/showcase/bambu-cli.png" alt="Bambu CLI skill on ClawHub" />
+</Card>
+
+<Card title="Vienna transport (Wiener Linien)" icon="train" href="https://clawhub.ai/hjanuschka/wienerlinien">
+  **@hjanuschka** • `travel` `transport` `skill`
+
+Real-time departures, disruptions, elevator status, and routing for Vienna's public transport.
+
+  <img src="/assets/showcase/wienerlinien.png" alt="Wiener Linien skill on ClawHub" />
+</Card>
+
+<Card title="ParentPay school meals" icon="utensils">
+  **@George5562** • `automation` `browser` `parenting`
+
+Automated UK school meal booking via ParentPay. Uses mouse coordinates for reliable table cell clicking.
+</Card>
+
+<Card title="R2 upload (Send Me My Files)" icon="cloud-arrow-up" href="https://clawhub.ai/skills/r2-upload">
+  **@julianengel** • `files` `r2` `presigned-urls`
+
+Upload to Cloudflare R2/S3 and generate secure presigned download links. Useful for remote Nodmix instances.
+</Card>
+
+<Card title="iOS app via Telegram" icon="mobile">
+  **@coard** • `ios` `xcode` `testflight`
+
+Built a complete iOS app with maps and voice recording, deployed to TestFlight entirely via Telegram chat.
+
+  <img src="/assets/showcase/ios-testflight.jpg" alt="iOS app on TestFlight" />
+</Card>
+
+<Card title="Oura Ring health assistant" icon="heart-pulse">
+  **@AS** • `health` `oura` `calendar`
+
+Personal AI health assistant integrating Oura ring data with calendar, appointments, and gym schedule.
+
+  <img src="/assets/showcase/oura-health.png" alt="Oura ring health assistant" />
+</Card>
+
+<Card title="Kev's Dream Team (14+ agents)" icon="robot" href="https://github.com/adam91holt/orchestrated-ai-articles">
+  **@adam91holt** • `multi-agent` `orchestration`
+
+14+ agents under one gateway with an Opus 4.5 orchestrator delegating to Codex workers. See the [technical write-up](https://github.com/adam91holt/orchestrated-ai-articles) and [Clawdspace](https://github.com/adam91holt/clawdspace) for agent sandboxing.
+</Card>
+
+<Card title="Linear CLI" icon="terminal" href="https://github.com/Finesssee/linear-cli">
+  **@NessZerra** • `devtools` `linear` `cli`
+
+CLI for Linear that integrates with agentic workflows (Claude Code, Nodmix). Manage issues, projects, and workflows from the terminal.
+</Card>
+
+<Card title="Beeper CLI" icon="message" href="https://github.com/blqke/beepcli">
+  **@jules** • `messaging` `beeper` `cli`
+
+Read, send, and archive messages via Beeper Desktop. Uses Beeper local MCP API so agents can manage all your chats (iMessage, WhatsApp, and more) in one place.
+</Card>
+
+</CardGroup>
+
+## Automation and workflows
+
+Scheduling, browser control, support loops, and the "just do the task for me" side of the product.
+
+<CardGroup cols={2}>
+
+<Card title="Winix air purifier control" icon="wind" href="https://x.com/antonplex/status/2010518442471006253">
+  **@antonplex** • `automation` `hardware` `air-quality`
+
+Claude Code discovered and confirmed the purifier controls, then Nodmix takes over to manage room air quality.
+
+  <img src="/assets/showcase/winix-air-purifier.jpg" alt="Winix air purifier control via Nodmix" />
+</Card>
+
+<Card title="Pretty sky camera shots" icon="camera" href="https://x.com/signalgaining/status/2010523120604746151">
+  **@signalgaining** • `automation` `camera` `skill`
+
+Triggered by a roof camera: ask Nodmix to snap a sky photo whenever it looks pretty. It designed a skill and took the shot.
+
+  <img src="/assets/showcase/roof-camera-sky.jpg" alt="Roof camera sky snapshot captured by Nodmix" />
+</Card>
+
+<Card title="Visual morning briefing scene" icon="robot" href="https://x.com/buddyhadry/status/2010005331925954739">
+  **@buddyhadry** • `automation` `briefing` `telegram`
+
+A scheduled prompt generates one scene image each morning (weather, tasks, date, favorite post or quote) via an Nodmix persona.
+</Card>
+
+<Card title="Padel court booking" icon="calendar-check" href="https://github.com/joshp123/padel-cli">
+  **@joshp123** • `automation` `booking` `cli`
+
+Playtomic availability checker plus booking CLI. Never miss an open court again.
+
+  <img src="/assets/showcase/padel-screenshot.jpg" alt="padel-cli screenshot" />
+</Card>
+
+<Card title="Accounting intake" icon="file-invoice-dollar">
+  **Community** • `automation` `email` `pdf`
+
+Collects PDFs from email, preps documents for a tax consultant. Monthly accounting on autopilot.
+</Card>
+
+<Card title="Couch potato dev mode" icon="couch" href="https://davekiss.com">
+  **@davekiss** • `telegram` `migration` `astro`
+
+Rebuilt an entire personal site via Telegram while watching Netflix — Notion to Astro, 18 posts migrated, DNS to Cloudflare. Never opened a laptop.
+</Card>
+
+<Card title="Job search agent" icon="briefcase">
+  **@attol8** • `automation` `api` `skill`
+
+Searches job listings, matches against CV keywords, and returns relevant opportunities with links. Built in 30 minutes using the JSearch API.
+</Card>
+
+<Card title="Jira skill builder" icon="diagram-project" href="https://x.com/jdrhyne/status/2008336434827002232">
+  **@jdrhyne** • `jira` `skill` `devtools`
+
+Nodmix connected to Jira, then generated a new skill on the fly (before it existed on ClawHub).
+</Card>
+
+<Card title="Todoist skill via Telegram" icon="list-check" href="https://x.com/iamsubhrajyoti/status/2009949389884920153">
+  **@iamsubhrajyoti** • `todoist` `skill` `telegram`
+
+Automated Todoist tasks and had Nodmix generate the skill directly in Telegram chat.
+</Card>
+
+<Card title="TradingView analysis" icon="chart-line">
+  **@bheem1798** • `finance` `browser` `automation`
+
+Logs into TradingView via browser automation, screenshots charts, and performs technical analysis on demand. No API needed — just browser control.
+</Card>
+
+<Card title="Slack auto-support" icon="slack">
+  **@henrymascot** • `slack` `automation` `support`
+
+Watches a company Slack channel, responds helpfully, and forwards notifications to Telegram. Autonomously fixed a production bug in a deployed app without being asked.
+</Card>
+
+</CardGroup>
+
+## Knowledge and memory
+
+Systems that index, search, remember, and reason over personal or team knowledge.
+
+<CardGroup cols={2}>
+
+<Card title="xuezh Chinese learning" icon="language" href="https://github.com/joshp123/xuezh">
+  **@joshp123** • `learning` `voice` `skill`
+
+Chinese learning engine with pronunciation feedback and study flows via Nodmix.
+
+  <img src="/assets/showcase/xuezh-pronunciation.jpeg" alt="xuezh pronunciation feedback" />
+</Card>
+
+<Card title="WhatsApp memory vault" icon="vault">
+  **Community** • `memory` `transcription` `indexing`
+
+Ingests full WhatsApp exports, transcribes 1k+ voice notes, cross-checks with git logs, outputs linked markdown reports.
+</Card>
+
+<Card title="Karakeep semantic search" icon="magnifying-glass" href="https://github.com/jamesbrooksco/karakeep-semantic-search">
+  **@jamesbrooksco** • `search` `vector` `bookmarks`
+
+Adds vector search to Karakeep bookmarks using Qdrant plus OpenAI or Ollama embeddings.
+</Card>
+
+<Card title="Inside-Out-2 memory" icon="brain">
+  **Community** • `memory` `beliefs` `self-model`
+
+Separate memory manager that turns session files into memories, then beliefs, then an evolving self model.
+</Card>
+
+</CardGroup>
+
+## Voice and phone
+
+Speech-first entry points, phone bridges, and transcription-heavy workflows.
+
+<CardGroup cols={2}>
+
+<Card title="Clawdia phone bridge" icon="phone" href="https://github.com/alejandroOPI/clawdia-bridge">
+  **@alejandroOPI** • `voice` `vapi` `bridge`
+
+Vapi voice assistant to Nodmix HTTP bridge. Near real-time phone calls with your agent.
+</Card>
+
+<Card title="OpenRouter transcription" icon="microphone" href="https://clawhub.ai/obviyus/openrouter-transcribe">
+  **@obviyus** • `transcription` `multilingual` `skill`
+
+Multi-lingual audio transcription via OpenRouter (Gemini, and more). Available on ClawHub.
+</Card>
+
+</CardGroup>
+
+## Infrastructure and deployment
+
+Packaging, deployment, and integrations that make Nodmix easier to run and extend.
+
+<CardGroup cols={2}>
+
+<Card title="Home Assistant add-on" icon="home" href="https://github.com/ngutman/nodmix-ha-addon">
+  **@ngutman** • `homeassistant` `docker` `raspberry-pi`
+
+Nodmix gateway running on Home Assistant OS with SSH tunnel support and persistent state.
+</Card>
+
+<Card title="Home Assistant skill" icon="toggle-on" href="https://clawhub.ai/skills/homeassistant">
+  **ClawHub** • `homeassistant` `skill` `automation`
+
+Control and automate Home Assistant devices via natural language.
+</Card>
+
+<Card title="Nix packaging" icon="snowflake" href="https://github.com/nodmix/nix-nodmix">
+  **@nodmix** • `nix` `packaging` `deployment`
+
+Batteries-included nixified Nodmix configuration for reproducible deployments.
+</Card>
+
+<Card title="CalDAV calendar" icon="calendar" href="https://clawhub.ai/skills/caldav-calendar">
+  **ClawHub** • `calendar` `caldav` `skill`
+
+Calendar skill using khal and vdirsyncer. Self-hosted calendar integration.
+</Card>
+
+</CardGroup>
+
+## Home and hardware
+
+The physical-world side of Nodmix: homes, sensors, cameras, vacuums, and other devices.
+
+<CardGroup cols={2}>
+
+<Card title="GoHome automation" icon="house-signal" href="https://github.com/joshp123/gohome">
+  **@joshp123** • `home` `nix` `grafana`
+
+Nix-native home automation with Nodmix as the interface, plus Grafana dashboards.
+
+  <img src="/assets/showcase/gohome-grafana.png" alt="GoHome Grafana dashboard" />
+</Card>
+
+<Card title="Roborock vacuum" icon="robot" href="https://github.com/joshp123/gohome/tree/main/plugins/roborock">
+  **@joshp123** • `vacuum` `iot` `plugin`
+
+Control your Roborock robot vacuum through natural conversation.
+
+  <img src="/assets/showcase/roborock-screenshot.jpg" alt="Roborock status" />
+</Card>
+
+</CardGroup>
+
+## Community projects
+
+Things that grew beyond a single workflow into broader products or ecosystems.
+
+<CardGroup cols={2}>
+
+<Card title="StarSwap marketplace" icon="star" href="https://star-swap.com/">
+  **Community** • `marketplace` `astronomy` `webapp`
+
+Full astronomy gear marketplace. Built with and around the Nodmix ecosystem.
+</Card>
+
+</CardGroup>
+
+## Submit your project
+
+<Steps>
+  <Step title="Share it">
+    Post in [#self-promotion on Discord](https://discord.gg/clawd) or [tweet @nodmix](https://x.com/nodmix).
+  </Step>
+  <Step title="Include details">
+    Tell us what it does, link to the repo or demo, and share a screenshot if you have one.
+  </Step>
+  <Step title="Get featured">
+    We'll add standout projects to this page.
+  </Step>
+</Steps>
+
+## Related
+
+- [Getting started](/start/getting-started)
+- [Nodmix](/start/nodmix)

package/docs/start/wizard-cli-automation.md

@@ -0,0 +1,232 @@
+---
+summary: "Scripted onboarding and agent setup for the Nodmix CLI"
+read_when:
+  - You are automating onboarding in scripts or CI
+  - You need non-interactive examples for specific providers
+title: "CLI automation"
+sidebarTitle: "CLI automation"
+---
+
+Use `--non-interactive` to automate `nodmix onboard`.
+
+<Note>
+`--json` does not imply non-interactive mode. Use `--non-interactive` (and `--workspace`) for scripts.
+</Note>
+
+## Baseline non-interactive example
+
+```bash
+nodmix onboard --non-interactive \
+  --mode local \
+  --auth-choice apiKey \
+  --anthropic-api-key "$ANTHROPIC_API_KEY" \
+  --secret-input-mode plaintext \
+  --gateway-port 18789 \
+  --gateway-bind loopback \
+  --install-daemon \
+  --daemon-runtime node \
+  --skip-bootstrap \
+  --skip-skills
+```
+
+Add `--json` for a machine-readable summary.
+
+Use `--skip-bootstrap` when your automation pre-seeds workspace files and does not want onboarding to create the default bootstrap files.
+
+Use `--secret-input-mode ref` to store env-backed refs in auth profiles instead of plaintext values.
+Interactive selection between env refs and configured provider refs (`file` or `exec`) is available in the onboarding flow.
+
+In non-interactive `ref` mode, provider env vars must be set in the process environment.
+Passing inline key flags without the matching env var now fails fast.
+
+Example:
+
+```bash
+nodmix onboard --non-interactive \
+  --mode local \
+  --auth-choice openai-api-key \
+  --secret-input-mode ref \
+  --accept-risk
+```
+
+## Provider-specific examples
+
+<AccordionGroup>
+  <Accordion title="Anthropic API key example">
+    ```bash
+    nodmix onboard --non-interactive \
+      --mode local \
+      --auth-choice apiKey \
+      --anthropic-api-key "$ANTHROPIC_API_KEY" \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+  </Accordion>
+  <Accordion title="Gemini example">
+    ```bash
+    nodmix onboard --non-interactive \
+      --mode local \
+      --auth-choice gemini-api-key \
+      --gemini-api-key "$GEMINI_API_KEY" \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+  </Accordion>
+  <Accordion title="Z.AI example">
+    ```bash
+    nodmix onboard --non-interactive \
+      --mode local \
+      --auth-choice zai-api-key \
+      --zai-api-key "$ZAI_API_KEY" \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+  </Accordion>
+  <Accordion title="Vercel AI Gateway example">
+    ```bash
+    nodmix onboard --non-interactive \
+      --mode local \
+      --auth-choice ai-gateway-api-key \
+      --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+  </Accordion>
+  <Accordion title="Cloudflare AI Gateway example">
+    ```bash
+    nodmix onboard --non-interactive \
+      --mode local \
+      --auth-choice cloudflare-ai-gateway-api-key \
+      --cloudflare-ai-gateway-account-id "your-account-id" \
+      --cloudflare-ai-gateway-gateway-id "your-gateway-id" \
+      --cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY" \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+  </Accordion>
+  <Accordion title="Moonshot example">
+    ```bash
+    nodmix onboard --non-interactive \
+      --mode local \
+      --auth-choice moonshot-api-key \
+      --moonshot-api-key "$MOONSHOT_API_KEY" \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+  </Accordion>
+  <Accordion title="Mistral example">
+    ```bash
+    nodmix onboard --non-interactive \
+      --mode local \
+      --auth-choice mistral-api-key \
+      --mistral-api-key "$MISTRAL_API_KEY" \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+  </Accordion>
+  <Accordion title="Synthetic example">
+    ```bash
+    nodmix onboard --non-interactive \
+      --mode local \
+      --auth-choice synthetic-api-key \
+      --synthetic-api-key "$SYNTHETIC_API_KEY" \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+  </Accordion>
+  <Accordion title="OpenCode example">
+    ```bash
+    nodmix onboard --non-interactive \
+      --mode local \
+      --auth-choice opencode-zen \
+      --opencode-zen-api-key "$OPENCODE_API_KEY" \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+    Swap to `--auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY"` for the Go catalog.
+  </Accordion>
+  <Accordion title="Ollama example">
+    ```bash
+    nodmix onboard --non-interactive \
+      --mode local \
+      --auth-choice ollama \
+      --custom-model-id "qwen3.5:27b" \
+      --accept-risk \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+  </Accordion>
+  <Accordion title="Custom provider example">
+    ```bash
+    nodmix onboard --non-interactive \
+      --mode local \
+      --auth-choice custom-api-key \
+      --custom-base-url "https://llm.example.com/v1" \
+      --custom-model-id "foo-large" \
+      --custom-api-key "$CUSTOM_API_KEY" \
+      --custom-provider-id "my-custom" \
+      --custom-compatibility anthropic \
+      --custom-image-input \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+
+    `--custom-api-key` is optional. If omitted, onboarding checks `CUSTOM_API_KEY`.
+    Nodmix marks common vision model IDs as image-capable automatically. Add `--custom-image-input` for unknown custom vision IDs, or `--custom-text-input` to force text-only metadata.
+
+    Ref-mode variant:
+
+    ```bash
+    export CUSTOM_API_KEY="your-key"
+    nodmix onboard --non-interactive \
+      --mode local \
+      --auth-choice custom-api-key \
+      --custom-base-url "https://llm.example.com/v1" \
+      --custom-model-id "foo-large" \
+      --secret-input-mode ref \
+      --custom-provider-id "my-custom" \
+      --custom-compatibility anthropic \
+      --custom-image-input \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+
+    In this mode, onboarding stores `apiKey` as `{ source: "env", provider: "default", id: "CUSTOM_API_KEY" }`.
+
+  </Accordion>
+</AccordionGroup>
+
+Anthropic setup-token remains available as a supported onboarding token path, but Nodmix now prefers Claude CLI reuse when available.
+For production, prefer an Anthropic API key.
+
+## Add another agent
+
+Use `nodmix agents add <name>` to create a separate agent with its own workspace,
+sessions, and auth profiles. Running without `--workspace` launches the wizard.
+
+```bash
+nodmix agents add work \
+  --workspace ~/.nodmix/workspace-work \
+  --model openai/gpt-5.5 \
+  --bind whatsapp:biz \
+  --non-interactive \
+  --json
+```
+
+What it sets:
+
+- `agents.list[].name`
+- `agents.list[].workspace`
+- `agents.list[].agentDir`
+
+Notes:
+
+- Default workspaces follow `~/.nodmix/workspace-<agentId>`.
+- Add `bindings` to route inbound messages (the wizard can do this).
+- Non-interactive flags: `--model`, `--agent-dir`, `--bind`, `--non-interactive`.
+
+## Related docs
+
+- Onboarding hub: [Onboarding (CLI)](/start/wizard)
+- Full reference: [CLI Setup Reference](/start/wizard-cli-reference)
+- Command reference: [`nodmix onboard`](/cli/onboard)