# jido | agentjido | Knowledge Base | Instagit

🤖 Autonomous agent framework for Elixir. Built for distributed, autonomous behavior and dynamic workflows.

GitHub Stars: 1.5k

Repository: https://github.com/agentjido/jido

---

## Articles

### [How to Integrate Jido Agents with OTP Supervision Trees](/agentjido/jido/how-to-integrate-jido-agents-with-otp-supervision-trees)

Learn to integrate Jido agents with OTP supervision trees using Jido's built-in supervisor for robust agent lifecycle management with standard OTP primitives.

- Tags: how-to-guide
- Published: 2026-03-09

### [How to Configure AgentServer with Custom Options like max_queue_size in Jido](/agentjido/jido/how-to-configure-agentserver-with-custom-options-like-max-queue-size)

Learn how to configure AgentServer with custom options like max_queue_size in Jido. Pass a keyword list or map to Jido.AgentServer.start_link/1 for your server's internal state.

- Tags: how-to-guide
- Published: 2026-03-09

### [How to Use the Jido Registry for Agent Naming and Lookup](/agentjido/jido/how-to-use-jido-registry-for-agent-naming-lookup)

Learn how to use the Jido Registry for agent naming and lookup in Elixir. Discover helper functions to resolve agent names across your supervision tree.

- Tags: how-to-guide
- Published: 2026-03-09

### [How to Implement State Operations (SetState, ReplaceState, DeletePath) in Jido](/agentjido/jido/how-to-implement-state-operations-setstate-replacestate-deletepath-in-jido)

Learn to implement Jido state operations SetState ReplaceState and DeletePath. Discover how Jido separates state mutation logic from side-effect directives for cleaner code.

- Tags: how-to-guide
- Published: 2026-03-09

### [How to Implement Declarative and Dynamic Cron Scheduling in Jido](/agentjido/jido/how-to-implement-declarative-dynamic-cron-scheduling-in-jido)

Learn declarative and dynamic cron scheduling in Jido. Implement recurring work with pure directives and let Jido handle process management effectively.

- Tags: how-to-guide
- Published: 2026-03-09

### [NimbleOptions vs Zoi Schemas in Jido: Key Differences and Migration Guide](/agentjido/jido/difference-between-nimbleoptions-zoi-schemas-in-jido)

Discover NimbleOptions vs Zoi schemas in Jido. Learn their key differences, Zoi's type safety, and how to migrate from NimbleOptions to Zoi for improved validation.

- Tags: migration-guide
- Published: 2026-03-09

### [How to Debug Jido Agents Using Debug Mode and the Event Buffer](/agentjido/jido/how-to-debug-jido-agents-using-debug-mode-event-buffer)

Debug Jido agents efficiently with per-instance debug mode and the event buffer. Inspect signal processing and state changes without altering agent logic. Learn how now!

- Tags: how-to-guide
- Published: 2026-03-09

### [How to Handle Errors with Custom Error Policies in Jido AgentServer](/agentjido/jido/how-to-handle-errors-with-custom-error-policies-in-jido-agentserver)

Learn to handle errors with custom error policies in Jido AgentServer. Explore built-in and custom functions for robust error management. Delegate directives effectively.

- Tags: how-to-guide
- Published: 2026-03-09

### [Jido Telemetry and Tracing Features: Complete Observability for Elixir Agents](/agentjido/jido/what-telemetry-and-tracing-features-does-jido-provide)

Unlock complete observability for Elixir agents with Jido's robust telemetry and tracing features. Gain Prometheus metrics, configurable logs, and OpenTelemetry integration.

- Tags: deep-dive
- Published: 2026-03-09

### [How to Implement Multi-Agent Orchestration in Jido: A Complete Guide](/agentjido/jido/how-to-implement-multi-agent-orchestration-in-jido)

Master multi-agent orchestration in Jido by returning SpawnAgent directives. This guide details creating child agents, bidirectional communication, and managing them effectively.

- Tags: how-to-guide
- Published: 2026-03-09

### [How to Use Worker Pools for High-Throughput Agent Workloads in Jido](/agentjido/jido/how-to-use-worker-pools-for-high-throughput-agent-workloads-in-jido)

Boost Jido agent performance with worker pools. Optimize high-throughput workloads by reusing pre-initialized agents and avoid costly startup times.

- Tags: how-to-guide
- Published: 2026-03-09

### [How the Directive Queue Works in Jido AgentServer with Drain Loop](/agentjido/jido/how-directive-queue-works-in-agentserver-with-drain-loop)

Understand Jido AgentServer's directive queue and drain loop. Learn how it processes directives asynchronously and in order without blocking your GenServer mailbox.

- Tags: internals
- Published: 2026-03-09

### [How to Configure Signal Routes for Jido Agents: Complete Routing Guide](/agentjido/jido/how-to-configure-signal-routes-for-jido-agent)

Configure signal routes for Jido agents using signal_routes option or signal_routes/1 callback. Learn Jido agent routing for effective communication.

- Tags: how-to-guide
- Published: 2026-03-09

### [How Checkpoint and Restore Work for Agent Persistence in Jido: A Complete Guide](/agentjido/jido/how-checkpoint-restore-works-for-agent-persistence-in-jido)

Discover how Jido's checkpoint and restore ensure agent persistence. Learn how Jido captures agent state and rehydrates threads for durable restarts.

- Tags: deep-dive
- Published: 2026-03-09

### [How to Implement Lifecycle Hooks (on_before_cmd and on_after_cmd) in Jido Agents](/agentjido/jido/how-to-implement-lifecycle-hooks-on-before-cmd-on-after-cmd)

Learn to implement Jido Agent lifecycle hooks on_before_cmd and on_after_cmd execute pure transformations before action normalization and after directive generation.

- Tags: how-to-guide
- Published: 2026-03-09

### [Actions vs Directives vs State Operations in Jido: A Complete Guide](/agentjido/jido/difference-between-actions-directives-state-operations-in-jido)

Understand Jido actions directives and state operations. Learn how Jido agents separate logic from execution for predictable and testable behavior.

- Tags: deep-dive
- Published: 2026-03-09

### [How to Handle Parent-Child Agent Hierarchies in Jido: A Complete Guide](/agentjido/jido/how-to-handle-parent-child-agent-hierarchies-in-jido)

Master parent child agent hierarchies in Jido using data directives like SpawnAgent and StopChild. Discover efficient agent management without OTP supervision trees.

- Tags: how-to-guide
- Published: 2026-03-09

### [How the FSM Strategy Powers State-Driven Workflows in Jido](/agentjido/jido/how-fsm-strategy-works-for-state-driven-workflows-in-jido)

Learn how Jido's FSM strategy creates pure declarative finite state machines to drive agent workflows with explicit states and transitions validated against user rules.

- Tags: deep-dive
- Published: 2026-03-09

### [Jido Execution Strategies: Direct vs FSM and When to Use Each](/agentjido/jido/what-execution-strategies-available-in-jido-and-when-to-use)

Explore Jido execution strategies: Direct for immediate tasks and FSM for state-machine workflows. Learn when to use each and discover custom strategy options.

- Tags: deep-dive
- Published: 2026-03-09

### [How to Create and Configure Plugins in Jido: The Complete Developer Guide](/agentjido/jido/how-to-create-and-configure-plugins-in-jido)

Learn to create and configure Jido plugins. Define modules with metadata and callbacks, then declare them in agents for composable runtime behavior and state key derivation.

- Tags: how-to-guide
- Published: 2026-03-09

### [How Signal Routing Works in Jido AgentServer: A Complete Technical Guide](/agentjido/jido/how-signals-routing-works-in-jido-agentserver)

Understand Jido AgentServer signal routing. Explore the unified trie-based router that matches signals and dispatches them to action modules for efficient agent communication.

- Tags: deep-dive
- Published: 2026-03-09

### [How to Implement Custom Directives in Jido for External Side Effects](/agentjido/jido/how-to-implement-custom-directives-in-jido-for-external-side-effects)

Learn Jido custom directives to manage external side effects easily. Define structs and implement the DirectiveExec protocol for robust agent behavior.

- Tags: how-to-guide
- Published: 2026-03-09

### [Understanding the `cmd/2` Contract in Jido: Pure Logic for Testable Agents](/agentjido/jido/what-is-the-cmd2-contract-in-jido-and-why-important-for-testability)

Discover the Jido cmd/2 contract, a pure function ensuring agent testability. Learn how it creates deterministic unit tests with state transformation and effect directives, eliminating external dependencies.

- Tags: deep-dive
- Published: 2026-03-09

### [Jido Pure Functional Agent Design vs GenServer: A Complete Technical Guide](/agentjido/jido/how-jidos-pure-functional-agent-design-differs-from-traditional-genserver-agents)

Explore Jido's pure functional agent design and its differences from GenServer. Understand how immutability and directives enhance agent development for cleaner decision logic and side-effect separation.

- Tags: deep-dive
- Published: 2026-03-09