Practical overview
When it fits
Use Chidori when an agent’s side effects need to be recorded so runs can be replayed, paused or resumed across process boundaries.
Who it is for
- Developers building long-running AI agents.
- Teams that need replayable agent tests and debugging workflows.
- Builders creating agents that pause for human or agent input.
- TypeScript developers seeking durable execution without a graph-based DSL.
Documented uses
- Build agents that can resume after process failures.
- Replay recorded agent runs without making new LLM calls.
- Checkpoint multi-step, tool-using workflows.
- Pause runs for later input and continue from the saved state.
- Test agent behavior against committed recorded checkpoints.
Requirements & limits
The repository is public and licensed under Apache-2.0. The project documents a self-contained runtime binary, prebuilt installation for macOS and Linux, and source installation with Rust.
- The runtime records LLM calls, tool calls and HTTP requests as host calls, making those effects available for replay and recovery.
- Replay is described as byte-identical and does not make new LLM calls.
- Agents are written as plain asynchronous TypeScript rather than a graph or DSL.
- An embedded pure-Rust JavaScript engine means the documented runtime does not require Node, Deno, V8 or native bindings.
- Python and TypeScript SDKs are provided, while the runtime itself is implemented in Rust.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install the Chidori runtime
Set up the self-contained Chidori binary for running agents.
Before you start
- A supported macOS or Linux system for a prebuilt binary.
- For a source build, a stable Rust toolchain version 1.95 or newer.
Steps
Run the project’s install script to download the appropriate prebuilt binary.
Ensure the reported ~/.chidori/bin path is available in PATH when prompted.
Run chidori --version to check the installed command.
Alternatively, build from crates.io with cargo install chidori when using the Rust toolchain.
Expected outcome
The Chidori runtime is installed as a command-line binary.
Guide limitations
- Installing the runtime does not by itself describe creating or running a specific agent.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 3 October 2026
- Original website title
- ThousandBirdsInc/chidori · Official homepage title · retained in its source language

