Airweave

---
name: airweave
description: "Route Airweave tasks to the most specific sub-skill:
  local-development, backend-api, source-connectors, frontend-dashboard,
  connect-widget, mcp-search, or monke-e2e."
metadata:
  disco-role: operating
disable-model-invocation: true
license: MIT
---

# Airweave

Use this skill when a task is about the Airweave repository itself. It is a router, not a monolith: pick the narrowest sub-skill that matches the request, then cross-link to the others only when the task spans multiple surfaces.

Start with `scripts/check_env.py` when you need a quick repo sanity check.

## Sub-skill map

| Task family | Use | Notes |
| --- | --- | --- |
| Local Docker stack, env seeding, ports, start/restart/recreate/destroy | `sub-skills/local-development/SKILL.md` | Safe stack orchestration and health checks |
| Search, collections, source connections, webhooks, usage, browse-tree routes | `sub-skills/backend-api/SKILL.md` | API shapes, request/response contracts, stream debugging |
| Source classes, registry metadata, auth/config, browse-tree implementation, ACLs | `sub-skills/source-connectors/SKILL.md` | Connector internals only |
| Dashboard UI, auth context, collections pages, search UI, billing/admin | `sub-skills/frontend-dashboard/SKILL.md` | React/Vite client behavior |
| Connect iframe, postMessage, OAuth popup, session modes | `sub-skills/connect-widget/SKILL.md` | Widget and parent messaging only |
| MCP server, tool registration, stdio/HTTP transport, auth modes | `sub-skills/mcp-search/SKILL.md` | Streamable HTTP and CLI diagnostics |
| Monke connector discovery, configs, runner, credential resolution | `sub-skills/monke-e2e/SKILL.md` | Safe discovery helper; no credentialed test runs by default |

## Operating rules

- Prefer the narrowest sub-skill that matches the task.
- When a task spans multiple surfaces, start with the dominant one and cross-link the others.
- Keep runtime guidance inside the generated skill tree.
- Do not depend on the original checkout path when a bundled helper exists.

## Useful references

- `references/overview.md` for the repo map and package layout
- `references/troubleshooting.md` for cross-cutting failures
- `references/repo-provenance.md` for the source snapshot used to build this skill tree
- `references/repo-routing-metadata.json` for repo-skills-router placement