free-agentslisted

Use when the user wants to run Claude Code work on FREE inference instead of the paid gateway — either a LOCAL MLX model or a free cloud API. PRIMARILY dispatching a delegatable sub-task from their normal paid session (Opus/Sonnet); also running a full free session. Triggers: "dispatch this to a local model", "offload this to save cost", "run this on qwen locally", "start a local session / local mode", "run a remote session", "use a free API for this", "run the model tournament", or working offline. Explains how to drive the free-agents overlay: dispatch focused prompts (main use), launch a full session on either lane (remote is faster; local is for offline and long unattended runs), and run the diagnostic harnesses. ALSO use the moment you are about to delegate anything after being asked to use free/local agents, or when you catch yourself reaching for the Agent/Task tool to "delegate cheaply" — that tool CANNOT route to a free model and silently runs a full-price subagent; this skill has the only routes tha
haiggoh/free-agents · ★ 2 · AI & Automation · score 75

Install: claude install-skill haiggoh/free-agents

# free-agents — driving local MLX inference This overlay runs Claude Code work on **free** inference over two equal lanes: a **local** MLX server on Apple Silicon, and **free-tier remote APIs**. Models, ports, and paths come from `config/config.local.sh` and `config/remote-agents.sh`. First-time setup and full details are in the plugin README; this skill is the quick operational guide. ## ⛔ READ THIS FIRST — the built-in `Agent` tool CANNOT reach a free model This is the single most common way this skill gets "used" without saving a cent, so it is stated before anything else. **Claude Code's `Agent` (Task) tool cannot dispatch to a free agent. Ever.** Its `model` parameter accepts only first-party paid tiers — `sonnet`, `opus`, `haiku`, `fable`. There is no value that routes to a local MLX model or to a free cloud API, and the org allowlist blocks adding one. So: | What you do | What actually runs | Cost | |---|---|---| | `Agent(...)` with **no** `model` | the **default subagent model** (usually the same tier as you) | **full price** | | `Agent(..., model="haiku")` | Haiku, on the paid gateway | **cheaper, still paid** | | `Agent(..., model="qwen…"/"local"/"free")` | rejected — not a valid enum value | n/a | | **`curl` / the dispatch scripts below** | a free local or free-API model | **$0** | **Omitting `model` is the trap.** It reads like "let the harness pick something cheap"; it actually means "run a full-price subagent." A dispatch that went through the `Agent` tool