Weik.io

Agents

Workers that execute integration flows in a distributed architecture

Agents are the worker processes that actually do the heavy lifting in a distributed Weik.io setup. They connect back to your central host, ask for work, run your integration flows, and report back.

Architecture

Central Host

The main Weik.io instance acts as the orchestrator. It manages the agent registrations, decides who gets what work, and keeps track of the results.

Remote Agents

These are the actual worker processes running wherever you deploy them. They:

  • Register themselves with the central host
  • Execute the integration flows assigned to them
  • Stream back the execution results
  • Keep a persistent connection open to the host so they’re ready when needed

Managing Agents

List Agents

You can see all registered agents directly from the CLI:

# List all agents
weikio agents ls

Agent States

An agent will be in one of four states at any given time:

Online The agent is connected, sending regular heartbeats, and ready to accept new work.

Offline The agent dropped its connection. It might have crashed, or maybe someone just tripped over a network cable. It won’t get any new work until it reconnects.

Pending The agent successfully talked to the host but requires manual approval before it can start processing tasks.

Deprecated Someone explicitly retired this agent. It won’t receive work anymore, but the system keeps its records around so your old execution logs still make sense.