Smithers × Eliza
GitHub ↗
Run your ElizaOS character · as a durable Smithers agent

Give your Eliza character jobs that actually finish.

Wrap your ElizaOS character in the agent-eliza harness and any Smithers workflow step can be your persona. Steps run side by side so they're faster, flaky ones retry instead of dropping the job, risky ones pause for your approval, and every run is checkpointed and replayable. Your character does the thinking; Smithers makes the run survive.

A big task in one agent turn

Slow, fragile, forgets where it was

  • It tries to do the whole job inside a single reply
  • One model does every part, so it's slow and pricey
  • One step trips and the whole thing falls over
  • If the process restarts, the work is just gone
The same task on Smithers

Durable, parallel, and it reports back

  • The job becomes a durable run on a control plane
  • Steps run in parallel; cheap model where it's easy
  • A flaky step retries instead of dropping the job
  • Restart the agent and the run keeps going

What it gives your agent

Your ElizaOS character already talks, remembers, and acts. The agent-eliza harness runs it as a durable Smithers agent, so its work survives restarts, retries, and gates without losing the thread.

♾️

Durable runs

Kick off a workflow that survives crashes and restarts. The control plane keeps the state, so the agent can be disposable while the work is not.

Parallel & cheaper

Steps run side by side, and each step can use the right-sized model — a fast cheap one for the easy parts, a smart one only where it counts.

Asks before it acts

When a run hits an approval gate or needs a human answer, your agent asks you right in the chat. Reply "approve" and it continues.

Reports back on its own

Start a run and walk away. When the status changes or it finishes, the agent speaks up in the same conversation — no need to ask.

Retries & time-travel

Flaky steps retry automatically. And because every run is checkpointed, you can replay, fork, or rewind a run when something goes sideways.

🔁

Pass-through plugins

Your character keeps all of its elizaOS plugins. The harness runs them as-is, so the persona behaves exactly as it does in Eliza, now inside a durable run.

Wrap it, then run it

one package · any workflow step

Install the harness, wrap your character, and use it anywhere a Smithers workflow expects an agent.

your eliza project
# 1. Install the harness (pulls in @elizaos/core)
bun add @smithers-orchestrator/agent-eliza @elizaos/core

# 2. Wrap your ElizaOS character as a Smithers agent
import { ElizaAgent } from "@smithers-orchestrator/agent-eliza"

const agent = new ElizaAgent({
  character: myCharacter,   // your elizaOS Character
  plugins: [ bootstrapPlugin ],
  model: "claude-sonnet-5",
})

# 3. Use `agent` as any step in a durable workflow
1

Bring your persona

Your character and its elizaOS plugins become a first-class Smithers agent. @elizaos/core loads on first use.

2

It runs durably

Drop it into a step. Steps run in parallel, flaky ones retry, and the run keeps going across restarts.

3

You stay in control

Ask a step for structured output, pause it at an approval gate, and replay any run after the fact.

What the reverse bridge will add

plugin-smithers · in design

Letting an Eliza agent drive Smithers is designed as a normal ElizaOS plugin — a Service, some Actions, a Provider, an Evaluator. Here's the plan for when it lands. Tap any piece.

One bridge, both directions

eliza ⇄ smithers

Two directions. One is shipping today — run your Eliza character as a durable Smithers agent. The other, letting an Eliza agent drive Smithers from chat, is designed and on the way.

Smithers → Eliza · shipped

agent-eliza

  • Wrap your character as a durable Smithers agent
  • Run the persona as any step, with all its plugins
  • Shipping now in @smithers-orchestrator/agent-eliza
Eliza → Smithers · in design

plugin-smithers

  • Your Eliza agent launches and steers durable runs
  • Approvals and human questions surface in chat
  • Designed and speced — see the Design tab
the point
Let your Eliza agent take on the big jobs, and actually finish them.
durableruns survive restarts
parallelsteps run at the same time
in the loopapprovals land in chat
both wayseliza ⇄ smithers

This Overview is the integration preview. The Research tab is the fact-checked ElizaOS plugin reference; the Design tab is the concrete plugin-smithers build plan it's based on.

Research — the authoritative, fact-checked ElizaOS plugin reference (sourced from @elizaos/core@1.7.2 type definitions + official docs, with an adversarial verification pass).
Design — the concrete plugin-smithers proposal: architecture, full code skeletons, packaging, test plan, and a phased rollout. Grounded in the existing packages/pi-plugin precedent.