Orcats
Orcats lets you express coding-agent work as a direct-style TypeScript flow instead of a one-off prompt. A flow chooses a backend, runs autonomous conversations, uses filesystem and git helpers, persists plans, and reports structured outcomes.
Use Orcats when you want repeatable automation around a coding agent: implement a task, review the change, run gates, recover after a crash, or package the same workflow for another repository.
Start paths
Section titled “Start paths”- New to Orcats: read the quickstart, then the concepts.
- Installing for local use: start with the npm package.
- Need one executable with no project setup: use the standalone binary.
- Creating reusable automations in another repo: install the Agent Skills.
- Building repeatable work: start with flows or loops.
What Orcats gives you
Section titled “What Orcats gives you”| Need | Orca surface |
|---|---|
| Run one autonomous coding-agent task | flow + backend adapter |
| Honor a backend chosen at runtime | selectBackend() + --backend |
Read task input passed after -- | flowArgs() |
| Repeat until a measured state converges | loop() presets and guards |
| Package a loop for discovery and serving | defineLoop() + orcats run / orcats serve |
| Recover long work | persistent plans and loop state stores |
| Install in any git-backed repo | Orcats CLI + Agent Skills |
Supported boundaries
Section titled “Supported boundaries”The current package version is 0.3.0. The normal install path is npm i @twelvehart/orcats.
Supported live backend tags are claude, codex, opencode, and pi. Snapshot and sqlite loop state stores are available.