ChainBot is a Rust-based CLI application for managing automation workflows, triggers, and plugins.Documentation Index
Fetch the complete documentation index at: https://docs.chainbot.dev/llms.txt
Use this file to discover all available pages before exploring further.
What ChainBot Does
ChainBot lets you define workflows as directed acyclic graphs of nodes, attach triggers that fire those workflows on events, and run a long-lived daemon that coordinates execution with durable state.Core Concepts
| Concept | Role |
|---|---|
| Workflow | An independent DAG of nodes that executes as a unit |
| Trigger | Converts external events into workflow run requests |
| Plugin | Extends ChainBot with external executables or builtin capabilities |
| Workspace | A root directory containing chainbot.toml and all packages |
| Runtime State | Persisted run summaries, trigger records, and coordination data |
Key Design Points
- Workflows run without requiring a trigger. You can invoke a workflow directly via
chainbot run. - Triggers only matter when the daemon is running via
chainbot serve. - All manifest contracts use
manifest_version = "2.0.0". - The workspace root defaults to
~/.chainbot. SetCHAINBOT_CONFIG_DIRto override. - The canonical root config file is
chainbot.toml(notconfig/root.toml). - Plugin packages live under
plugins/<plugin_id>/config.toml. The legacyplugins/manifests/layout is not part of the stable bootstrap contract.