holix-subagents

## When to use The user wants **background specialized work** without blocking the main Holix chat: - research, coding, review, writing, analysis - optional: hand off implementation to **external coding CLIs** (Claude Code, OpenCode, Grok Build) via an assigned `coder` sub-agent Use sub-agents **only when the user asks** to delegate (`/subagent-spawn`, "запусти субагента", etc.), **except** site/resource analysis with many real links from `fetch_url` — then call `research_site_pages` (it spawns `page_analyst` workers). Do not auto-spawn other types for regular chat questions. ## Prerequisites 1. **Enabled** (default on): `enable_subagents: true` in profile `config.yaml` or `HOLIX_ENABLE_SUBAGENTS=true`. 2. **Profile** active: `holix --profile <name> …` or `HOLIX_PROFILE`. 3. **Limits** (profile `config.yaml`): - `subagent_max_concurrent` (default 4) - `subagent_process_timeout` (seconds per job) - `subagent_default_process_mode`: `process` (Linux/macOS, isolated) or `async` (in-process) If spawn fails with "disabled" → tell user to enable sub-agents and retry. ## Built-in types | Type | Use for | |------|---------| | `researcher` | Deep research, files + web | | `web_researcher` | Web search + synthesis | | `page_analyst` | One page of a site (`fetch_url` only; spawned by `research_site_pages`) | | `coder` | Code write/edit/debug, terminal, tests | | `analyst` | SQL, data, calculations | | `reviewer` | Code review | | `writer` | Docs and content | Custom typ...