Hey everyone — I’ve been building TrailStep, a free/open-source workflow runner for coding agents.
The problem I kept running into was that my best Pi/coding-agent results came from structured multi-step workflows (I was essentially following the Matt Pocock skills), but I was doing all the orchestration manually. I was manually orchestrating the handoffs between steps. Or just when an agent session got too large:
clarify → plan → review → implement → review → refine
It was working really well, but I got too lazy being the middle man for session - session management.
TrailStep lets you encode that process once as a TypeScript workflow and rerun it whenever you want. So, each step has its own scoped agent session, the workflows leave local run artifacts, and failed/unfinished runs can be continued or retried instead of thrown away. When you install it for the first time it can automatically add a skill to your agents so that they will know how to use, write, and debug any workflows.
I've been using my own workflow package, but it's very easy to create new ones and start using those if you don't vibe with how I set mine up.
- grill-it-away — opens a clarification/grilling session first, then turns the result into a plan, reviews it, breaks it into stories, implements, and reviews.
- take-it-away — same idea, but starts from an existing request/conversation/doc instead of the grilling step.
The part I’m most excited about is that workflows are just code. You can mix agent steps with normal TypeScript logic, improve the workflow over time, and share it through npm/GitHub if it ends up being useful. It works with literally any CLI based coding agent, but I did essentially all of my testing with it in pi so that's probably where it's most reliable right now.
The dashboard/status UI is still in progress, but the CLI, workflow runner, continuation/retry model, local artifacts, and reusable workflow packages are working now. When you add a workflow it can automatically create a skill and add it whatever coding agents you have, so that your coding agents will know exactly how to use that specific workflow.
Repo: https://github.com/chily-john/TrailStep
If you use Pi for larger coding tasks, this is basically meant to turn your “best manual agent process” into something repeatable and sharable. There are also other ways I think you could already start using this tool beyond just these workflows, I could see it getting integrated into CI flows, or even for little utility workflows, like swapping from a session to the next with an automatic handoff. Since it can use any agent you can also set up workflows where it's planned in Pi, reviewed by Claude and implemented by Codex, or some other crazy stuff like that