---
title: Agent Pulse
emoji: 💓
colorFrom: blue
colorTo: red
sdk: docker
pinned: false
short_description: Agent Nervous System — Heartbeat, ReAct Timetable Scheduler
---

# 💓 PULSE — Agent Nervous System

The heartbeat, ReAct loop, identity layer, and timetable scheduler connecting the entire ki-fusion-labs agent ecosystem.

## Architecture

```
PULSE (this)
  │
  ├── 🗣  RELAY   — send/receive messages, delegate tasks
  ├── 🧠  MEMORY  — store findings, recall context
  ├── 📋  KANBAN  — create/claim/move tasks
  ├── ⚡  NEXUS   — LLM routing (RTX 5090 + HF fallback)
  ├── 🗄  VAULT   — read/write/execute code
  ├── 🔧  FORGE   — skill & tool registry
  └── 📚  KNOWLEDGE — document search (RAG)
```

## Agent ReAct Loop

Each agent tick:
1. Check RELAY inbox for messages
2. Check KANBAN for assigned open tasks
3. If anything found → ReAct loop via NEXUS
4. Steps: Thought → Action(tool) → Observation → repeat
5. Store results in MEMORY / KANBAN / VAULT

## Timetable Scheduler

- **Weekly calendar** view — drag, add, edit schedule entries
- **Daily / Weekly / Once** recurrence with APScheduler
- Per-agent cron schedules (UTC)
- Each entry carries a custom prompt for the agent

## Environment Variables (HF Secrets)

| Variable | Default | Description |
|---|---|---|
| `RELAY_URL` | chris4k-agent-relay.hf.space | RELAY space URL |
| `MEMORY_URL` | chris4k-agent-memory.hf.space | MEMORY space URL |
| `KANBAN_URL` | chris4k-agent-kanban-board.hf.space | KANBAN URL |
| `NEXUS_URL` | chris4k-agent-nexus.hf.space | NEXUS LLM router URL |
| `VAULT_URL` | chris4k-agent-vault.hf.space | VAULT URL |
| `FORGE_URL` | chris4k-agent-forge.hf.space | FORGE URL |
| `NEXUS_MODEL` | nexus-auto | Model name for LLM calls |
| `REACT_MAX_STEPS` | 6 | Max steps per ReAct loop |
| `VAULT_EXEC_TIMEOUT` | 30 | Execution timeout |

## Default Agents

| Agent | Heartbeat | Role |
|---|---|---|
| `researcher` | off | Info gathering, memory storage |
| `coder` | off | Code writing & execution |
| `planner` | off | Task decomposition, sprint planning |
| `monitor` | 5min | System health, alerts, watchdog |
| `christof` | off | Personal coordinator, daily briefs |

## Default Schedule

| Time | Agent | Task |
|---|---|---|
| Daily 08:00 | monitor | Morning system check |
| Daily 09:00 | researcher | AI research digest |
| Mon 09:30 | planner | Sprint planning |
| Wed 10:00 | coder | Code quality check |
| Daily 18:00 | monitor | Evening task review |
| Fri 16:00 | planner | Weekly retrospective |

## MCP Config

```json
{
  "mcpServers": {
    "pulse": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://chris4k-agent-pulse.hf.space/mcp/sse"]
    }
  }
}
```

## Agent Tools Available in ReAct

```
relay_send      — Send message to agent or broadcast
relay_inbox     — Read unread messages
memory_search   — Search memory by query
memory_store    — Store new memory
kanban_list     — List tasks by status/agent
kanban_move     — Move task to new status
kanban_create   — Create new task
vault_exec      — Execute bash/python/node/npm/git
vault_read      — Read file
vault_write     — Write file
forge_search    — Find skills in FORGE
delegate        — Delegate task to another agent
finish          — Complete ReAct loop
```

*Chris4K · ki-fusion-labs.de*