> ## Documentation Index
> Fetch the complete documentation index at: https://smithers.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# 0.24.2

> One-command onboarding via init, a Codex tool-access fix, the new fix-all-issues workflow, an mcp add fallback, and refreshed agent docs.

Smithers 0.24.2 makes onboarding a single command, fixes a Codex regression that stripped tool access from agentic tasks, adds the `fix-all-issues` workflow, and prints a manual fallback when `mcp add` fails. The rest is documentation: the home page and human guide were rewritten, ClaudeCodeAgent authentication is documented, and stale model IDs in the examples were refreshed. There are no breaking changes and no public API symbols were removed.

***

## One-command onboarding

`bunx smithers-orchestrator init` now does the whole setup in one step.

* `init` auto-installs the curated `smithers` skill into the coding agents it detects on your machine, so there is no more manual `mkdir` or `curl`.
* It seeds an editable `hello` workflow (`.smithers/workflows/hello.tsx` with its prompt in `.smithers/prompts/hello.mdx`) as the smallest end-to-end example to run and tweak.
* The home page and the For Humans guide were rewritten around this one-command flow.

## Workflows

* New `fix-all-issues` workflow: it decomposes every open issue, drives a Codex test-first implementation, runs dual review, and opens a PR. An `excludeNumbers` filter lets you skip specific issues.

## Agents

* Fixed a Codex regression where native structured output was always on, which removed tool access from agentic tasks. Native structured output is now opt-in, so agentic Codex tasks keep their tools.
* Documented `ClaudeCodeAgent` authentication: subscription billing by default (the agent clears `ANTHROPIC_API_KEY` so the `claude` CLI bills your Pro/Max subscription), per-directory subscription login via `configDir` (`CLAUDE_CONFIG_DIR`), and API billing via `apiKey`.
* Refreshed stale model IDs in the AI SDK examples and integration docs (`claude-sonnet-4-5-20250929` to `claude-sonnet-4-6`, `gpt-5.2-codex` to `gpt-5.5`).

## CLI

* `bunx smithers-orchestrator mcp add` now prints a copy-paste manual fallback command when the underlying agent's `mcp add` fails, so registration is recoverable without leaving the terminal.

## Quality

* Added an agent-fluency eval suite: a weak-model, one-shot regression suite that exercises every Smithers feature.

## Upgrade

```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
bunx smithers-orchestrator@0.24.2
```

No configuration changes are required.