fengming 0.3.10 → 0.3.11

package/docs/start/onboarding.md

@@ -1,98 +0,0 @@
----
-summary: "First-run setup flow for FengMing (macOS app)"
-read_when:
-  - Designing the macOS onboarding assistant
-  - Implementing auth or identity setup
-title: "Onboarding (macOS app)"
-sidebarTitle: "Onboarding: macOS App"
----
-
-This doc describes the **current** first-run setup flow. The goal is a
-smooth "day 0" experience: pick where the Gateway runs, connect auth, run the
-wizard, and let the agent bootstrap itself.
-For a general overview of onboarding paths, see [Onboarding Overview](/start/onboarding-overview).
-
-<Steps>
-<Step title="Approve macOS warning">
-<Frame>
-<img src="/assets/macos-onboarding/01-macos-warning.jpeg" alt="" />
-</Frame>
-</Step>
-<Step title="Approve find local networks">
-<Frame>
-<img src="/assets/macos-onboarding/02-local-networks.jpeg" alt="" />
-</Frame>
-</Step>
-<Step title="Welcome and security notice">
-<Frame caption="Read the security notice displayed and decide accordingly">
-<img src="/assets/macos-onboarding/03-security-notice.png" alt="" />
-</Frame>
-
-Security trust model:
-
-- By default, FengMing is a personal agent: one trusted operator boundary.
-- Shared/multi-user setups require lock-down (split trust boundaries, keep tool access minimal, and follow [Security](/gateway/security)).
-- Local onboarding now defaults new configs to `tools.profile: "coding"` so fresh local setups keep filesystem/runtime tools without forcing the unrestricted `full` profile.
-- If hooks/webhooks or other untrusted content feeds are enabled, use a strong modern model tier and keep strict tool policy/sandboxing.
-
-</Step>
-<Step title="Local vs Remote">
-<Frame>
-<img src="/assets/macos-onboarding/04-choose-gateway.png" alt="" />
-</Frame>
-
-Where does the **Gateway** run?
-
-- **This Mac (Local only):** onboarding can configure auth and write credentials
-  locally.
-- **Remote (over SSH/Tailnet):** onboarding does **not** configure local auth;
-  credentials must exist on the gateway host. The remote gateway token field
-  stores the token used by the macOS app to connect to that Gateway; existing
-  non-plaintext `gateway.remote.token` values are preserved until you replace
-  them.
-- **Configure later:** skip setup and leave the app unconfigured.
-
-<Tip>
-**Gateway auth tip:**
-
-- The wizard now generates a **token** even for loopback, so local WS clients must authenticate.
-- If you disable auth, any local process can connect; use that only on fully trusted machines.
-- Use a **token** for multi-machine access or non-loopback binds.
-
-</Tip>
-</Step>
-<Step title="Permissions">
-<Frame caption="Choose what permissions do you want to give FengMing">
-<img src="/assets/macos-onboarding/05-permissions.png" alt="" />
-</Frame>
-
-Onboarding requests TCC permissions needed for:
-
-- Automation (AppleScript)
-- Notifications
-- Accessibility
-- Screen Recording
-- Microphone
-- Speech Recognition
-- Camera
-- Location
-
-</Step>
-<Step title="CLI">
-  <Info>This step is optional</Info>
-  The app can install the global `fengming` CLI via npm, pnpm, or bun.
-  It prefers npm first, then pnpm, then bun if that is the only detected
-  package manager. For the Gateway runtime, Node remains the recommended path.
-</Step>
-<Step title="Onboarding Chat (dedicated session)">
-  After setup, the app opens a dedicated onboarding chat session so the agent can
-  introduce itself and guide next steps. This keeps first-run guidance separate
-  from your normal conversation. See [Bootstrapping](/start/bootstrapping) for
-  what happens on the gateway host during the first agent run.
-</Step>
-</Steps>
-
-## Related
-
-- [Onboarding overview](/start/onboarding-overview)
-- [Getting started](/start/getting-started)

package/docs/start/quickstart.md

@@ -1,25 +0,0 @@
----
-summary: "Quick start has moved to Getting Started."
-read_when:
-  - You are looking for the fastest setup steps
-  - You were sent here from an older link
-title: "Quick start"
----
-
-<Info>
-Quick start is now part of [Getting Started](/start/getting-started).
-</Info>
-
-<Columns>
-  <Card title="Getting Started" href="/start/getting-started">
-    Install FengMing and run your first chat in minutes.
-  </Card>
-  <Card title="Onboarding (CLI)" href="/start/wizard">
-    Full CLI onboarding reference and advanced options.
-  </Card>
-</Columns>
-
-## Related
-
-- [Getting started](/start/getting-started)
-- [Install overview](/install)

package/docs/start/setup.md

@@ -1,178 +0,0 @@
----
-summary: "Advanced setup and development workflows for FengMing"
-read_when:
-  - Setting up a new machine
-  - You want "latest + greatest" without breaking your personal setup
-title: "Setup"
----
-
-<Note>
-If you are setting up for the first time, start with [Getting Started](/start/getting-started).
-For onboarding details, see [Onboarding (CLI)](/start/wizard).
-</Note>
-
-## TL;DR
-
-Pick a setup workflow based on how often you want updates and whether you want to run the Gateway yourself:
-
-- **Tailoring lives outside the repo:** keep your config and workspace in `~/.fengming/fengming.json` and `~/.fengming/workspace/` so repo updates don't touch them.
-- **Stable workflow (recommended for most):** install the macOS app and let it run the bundled Gateway.
-- **Bleeding edge workflow (dev):** run the Gateway yourself via `pnpm gateway:watch`, then let the macOS app attach in Local mode.
-
-## Prereqs (from source)
-
-- Node 24 recommended (Node 22 LTS, currently `22.19+`, still supported)
-- `pnpm` required for source checkouts. FengMing loads bundled plugins from the
-  `extensions/*` pnpm workspace packages in dev mode, so root `npm install` does
-  not prepare the full source tree.
-- Docker (optional; only for containerized setup/e2e - see [Docker](/install/docker))
-
-## Tailoring strategy (so updates do not hurt)
-
-If you want "100% tailored to me" _and_ easy updates, keep your customization in:
-
-- **Config:** `~/.fengming/fengming.json` (JSON/JSON5-ish)
-- **Workspace:** `~/.fengming/workspace` (skills, prompts, memories; make it a private git repo)
-
-Bootstrap once:
-
-```bash
-fengming setup
-```
-
-From inside this repo, use the local CLI entry:
-
-```bash
-fengming setup
-```
-
-If you don't have a global install yet, run it via `pnpm fengming setup`.
-
-## Run the Gateway from this repo
-
-After `pnpm build`, you can run the packaged CLI directly:
-
-```bash
-node fengming.mjs gateway --port 18789 --verbose
-```
-
-## Stable workflow (macOS app first)
-
-1. Install + launch **FengMing.app** (menu bar).
-2. Complete the onboarding/permissions checklist (TCC prompts).
-3. Ensure Gateway is **Local** and running (the app manages it).
-4. Link surfaces (example: WhatsApp):
-
-```bash
-fengming channels login
-```
-
-5. Sanity check:
-
-```bash
-fengming health
-```
-
-If onboarding is not available in your build:
-
-- Run `fengming setup`, then `fengming channels login`, then start the Gateway manually (`fengming gateway`).
-
-## Bleeding edge workflow (Gateway in a terminal)
-
-Goal: work on the TypeScript Gateway, get hot reload, keep the macOS app UI attached.
-
-### 0) (Optional) Run the macOS app from source too
-
-If you also want the macOS app on the bleeding edge:
-
-```bash
-./scripts/restart-mac.sh
-```
-
-### 1) Start the dev Gateway
-
-```bash
-pnpm install
-# First run only (or after resetting local FengMing config/workspace)
-pnpm fengming setup
-pnpm gateway:watch
-```
-
-`gateway:watch` starts or restarts the Gateway watch process in a named tmux
-session and auto-attaches from interactive terminals. Non-interactive shells stay
-detached and print `tmux attach -t fengming-gateway-watch-main`; use
-`FENGMING_GATEWAY_WATCH_ATTACH=0 pnpm gateway:watch` to keep an interactive run
-detached, or `pnpm gateway:watch:raw` for foreground watch mode. The watcher
-reloads on relevant source, config, and bundled-plugin metadata changes. If the
-watched Gateway exits during startup, `gateway:watch` runs
-`fengming doctor --fix --non-interactive` once and retries; set
-`FENGMING_GATEWAY_WATCH_AUTO_DOCTOR=0` to disable that dev-only repair pass.
-`pnpm fengming setup` is the one-time local config/workspace initialization step for a fresh checkout.
-`pnpm gateway:watch` does not rebuild `dist/control-ui`, so rerun `pnpm ui:build` after `ui/` changes or use `pnpm ui:dev` while developing the Control UI.
-
-### 2) Point the macOS app at your running Gateway
-
-In **FengMing.app**:
-
-- Connection Mode: **Local**
-  The app will attach to the running gateway on the configured port.
-
-### 3) Verify
-
-- In-app Gateway status should read **"Using existing gateway …"**
-- Or via CLI:
-
-```bash
-fengming health
-```
-
-### Common footguns
-
-- **Wrong port:** Gateway WS defaults to `ws://127.0.0.1:18789`; keep app + CLI on the same port.
-- **Where state lives:**
-  - Channel/provider state: `~/.fengming/credentials/`
-  - Model auth profiles: `~/.fengming/agents/<agentId>/agent/auth-profiles.json`
-  - Sessions: `~/.fengming/agents/<agentId>/sessions/`
-  - Logs: `/tmp/fengming/`
-
-## Credential storage map
-
-Use this when debugging auth or deciding what to back up:
-
-- **WhatsApp**: `~/.fengming/credentials/whatsapp/<accountId>/creds.json`
-- **Telegram bot token**: config/env or `channels.telegram.tokenFile` (regular file only; symlinks rejected)
-- **Discord bot token**: config/env or SecretRef (env/file/exec providers)
-- **Slack tokens**: config/env (`channels.slack.*`)
-- **Pairing allowlists**:
-  - `~/.fengming/credentials/<channel>-allowFrom.json` (default account)
-  - `~/.fengming/credentials/<channel>-<accountId>-allowFrom.json` (non-default accounts)
-- **Model auth profiles**: `~/.fengming/agents/<agentId>/agent/auth-profiles.json`
-- **File-backed secrets payload (optional)**: `~/.fengming/secrets.json`
-- **Legacy OAuth import**: `~/.fengming/credentials/oauth.json`
-  More detail: [Security](/gateway/security#credential-storage-map).
-
-## Updating (without wrecking your setup)
-
-- Keep `~/.fengming/workspace` and `~/.fengming/` as "your stuff"; don't put personal prompts/config into the `fengming` repo.
-- Updating source: `git pull` + `pnpm install` + keep using `pnpm gateway:watch`.
-
-## Linux (systemd user service)
-
-Linux installs use a systemd **user** service. By default, systemd stops user
-services on logout/idle, which kills the Gateway. Onboarding attempts to enable
-lingering for you (may prompt for sudo). If it's still off, run:
-
-```bash
-sudo loginctl enable-linger $USER
-```
-
-For always-on or multi-user servers, consider a **system** service instead of a
-user service (no lingering needed). See [Gateway runbook](/gateway) for the systemd notes.
-
-## Related docs
-
-- [Gateway runbook](/gateway) (flags, supervision, ports)
-- [Gateway configuration](/gateway/configuration) (config schema + examples)
-- [Discord](/channels/discord) and [Telegram](/channels/telegram) (reply tags + replyToMode settings)
-- [FengMing assistant setup](/start/fengming)
-- [macOS app](/platforms/macos) (gateway lifecycle)

package/docs/start/showcase.md

@@ -1,363 +0,0 @@
----
-summary: "Community-built projects and integrations powered by FengMing"
-title: "Showcase"
-description: "Real-world FengMing projects from the community"
-read_when:
-  - Looking for real FengMing usage examples
-  - Updating community project highlights
----
-
-FengMing 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 @fengming on X](https://x.com/fengming).
-</Info>
-
-## 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, FengMing reviews the diff and replies in Telegram with suggestions plus a clear merge verdict.
-
-  <img src="/assets/showcase/pr-review-telegram.jpg" alt="FengMing 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" (@fengming) 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="FengMing 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 FengMing.
-
-  <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 FengMing 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, FengMing). 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 FengMing takes over to manage room air quality.
-
-  <img src="/assets/showcase/winix-air-purifier.jpg" alt="Winix air purifier control via FengMing" />
-</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 FengMing 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 FengMing" />
-</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 FengMing 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`
-
-FengMing 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 FengMing 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 FengMing.
-
-  <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 FengMing 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 FengMing easier to run and extend.
-
-<CardGroup cols={2}>
-
-<Card title="Home Assistant add-on" icon="home" href="https://github.com/ngutman/fengming-ha-addon">
-  **@ngutman** • `homeassistant` `docker` `raspberry-pi`
-
-FengMing 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/fengming/nix-fengming">
-  **@fengming** • `nix` `packaging` `deployment`
-
-Batteries-included nixified FengMing 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 FengMing: 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 FengMing 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 FengMing ecosystem.
-</Card>
-
-</CardGroup>
-
-## Submit your project
-
-<Steps>
-  <Step title="Share it">
-    Post in [#self-promotion on Discord](https://discord.gg/clawd) or [tweet @fengming](https://x.com/fengming).
-  </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)
-- [FengMing](/start/fengming)