← back to examples
core beginner

Counter Agent

A real Jido agent that counts up and down using Actions, Signals, and signal routing. Demonstrates the core agent pattern: immutable state, validated actions, and LiveView integration.

getting-started state actions signals

Related guides and notebooks

Guide
Your first agent
Define typed state and run your first command.
Livebook
Your first agent
Run the companion notebook in Livebook
Concept
Actions
Understand action contracts, validation, and composition.
Next
Build your first workflow
Chain actions into a multi-step workflow.
Livebook
Build your first workflow
Run the companion notebook in Livebook
Explanation

What this example teaches

Interactive Demo

Run the agent and inspect state

Source Code

Read the production implementation

counter_agent.ex increment_action.ex decrement_action.ex reset_action.ex counter_agent_live.ex
lib/agent_jido/demos/counter/actions/increment_action.ex 18 lines 
defmodule AgentJido.Demos.Counter.IncrementAction do
  @moduledoc """
  Increments the counter by a specified amount.
  """
  use Jido.Action,
    name: "increment",
    description: "Increments the counter",
    schema: [
      by: [type: :integer, default: 1, doc: "Amount to increment by"]
    ]

  @impl true
  def run(%{by: amount}, context) do
    current = Map.get(context.state, :count, 0)
    {:ok, %{count: current + amount}}
  end
end