███████╗███╗ ███╗██╗████████╗██╗ ██╗███████╗██████╗ ███████╗ ██╔════╝████╗ ████║██║╚══██╔══╝██║ ██║██╔════╝██╔══██╗██╔════╝ ███████╗██╔████╔██║██║ ██║ ███████║█████╗ ██████╔╝███████╗ ╚════██║██║╚██╔╝██║██║ ██║ ██╔══██║██╔══╝ ██╔══██╗╚════██║ ███████║██║ ╚═╝ ██║██║ ██║ ██║ ██║███████╗██║ ██║███████║ ╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝╚══════╝
Build smart workflows for your codebase. Enable agents to work smarter, faster, and cheaper.
Smithers is an agentic workflow framework for defining workflows in simple TypeScript configuration files and executing them quickly, durably, and reliably.
The release candidate's required package platform is Linux with Node 22.19.0. macOS and Windows package checks are advisory and do not establish a support guarantee.
Offline Chromium tests cover the included web UI. Packaged desktop and hosted deployments require separate acceptance evidence.
The 1.0 release candidate is not on npm yet. Use the source-checkout installation until publication. After publication, install it with:
npm install --global @smthrs/cli@nextRun these commands from your project directory. Before launching, edit the
scaffolded flow and configure the credential its model: field requires.
The quickstart covers each step.
smthrs init change
smthrs up changeTip
Ask your agent to help you figure out how Smithers can help you and your project, based on everything it knows about you.
Read the Smithers documentation for tutorials, guides, and the full reference. For the top-level build API, keep the Smithers API cheat sheet handy: one file of TypeScript examples covering the whole Smithers.* surface.
See CONTRIBUTING.md for local setup, testing, and pull request guidance.
Smithers is MIT licensed. See LICENSE for details.
Join the Smithers community on Telegram.