@zseven-w/dsh-crew

LIMITATIONS

Known limitations

### Regular subscribers → shell subagent approach (recommended) - **Current state**: Claude Code subagent shell uses haiku as intermediary; each dispatch adds hundreds to thousands of tokens - **Trade-off**: Use small amount of Anthropic token in exchange for native task UI, real-time progress display, no extra configuration - **Recommendation**: If you already subscribe to Claude Pro or use Claude Code, use this approach—convenient and transparent ### Pay-as-you-go / CI environments → direct router approach - **Current state**: Claude Code subagent frontmatter doesn't support direct third-party model connection; this repo's router experiment in scratchpad requires API-key credentials for Claude Code, but subscription OAuth is blocked upstream by Anthropic with 403 - **Recommendation**: - If using API-key credentials (not OAuth) and want to save Anthropic tokens, can run local router for direct DeepSeek connection - CI environments typically also use API keys; this approach is more economical (all DeepSeek tokens) - Requires self-testing of router integration (not officially supported) ### Running DSH Web → hub mode auto-enabled - **Current state**: If `dsh plugin add dsh-crew` installed into DSH Web profile, jobs run as first-class sessions in host, appear in Web UI session list - **Recommendation**: During local development iteration, recommend enabling hub mode; worker progress can be fully observed in Web UI; for cross-machine collaboration or environments without Web UI, use the dispatching-host shell approach ### Known items - Codex role can theoretically try `model_provider` pointing directly to DeepSeek (unverified); this bridge doesn't depend on it - Image generation output is flat bitmap; layer editing requires OpenPencil - **Runtime dependencies**: Only `@modelcontextprotocol/sdk` and `zod`; `@deepseek-ai/*` are host runtime, provided by the DSH host (a plain npm install never pulls them) - **Codex must configure**: `default_tools_approval_mode = "approve"`, otherwise tool calls are auto-cancelled