📦 Agent Integration Platform

HexClamp

An agent integration platform that provides structured loops, event handling, and state management for autonomous agents.

🔗 View on GitHub 📥 Installation

// features

Features

🔄

Structured Loop

Observe → Condense → Plan → Execute → Verify → Persist

⚡

Event System

Webhooks for GitHub, Slack, GitLab integration

⏰

Scheduling

Cron-based and interval timers for automated tasks

💾

State Management

File-backed persistent state for reliable operations

🔌

Agent Adapters

OpenClaw and reference CLI agent support

// installation

Installation

Install HexClamp via pip:

$ pip install hexclamp

Or for development:

$ git clone https://github.com/sidonsoft/HexClamp
$ cd HexClamp
$ pip install -e ".[dev]"

// quick start

Quick Start

Here's how to get started with HexClamp:

from hexclamp.loop import HexClampLoop
from hexclamp.agent import CLIAgent
from pathlib import Path

# Create agent and loop
agent = CLIAgent(workspace="/path/to/workspace")
loop = HexClampLoop(Path("/path/to/workspace"), agent)

# Enqueue a task
loop.enqueue("Read the README file")

# Run cycle
loop.run_cycle()

// cli

CLI Usage

# Initialize workspace
$ hexclamp init

# Enqueue a task
$ hexclamp enqueue "Fix the login bug"

# Run cycle
$ hexclamp run

# Check status
$ hexclamp status

// architecture

Architecture

┌─────────────────────────────────────────────┐ │ HexClamp Loop │ ├─────────────────────────────────────────────┤ │ Observe → Condense → Plan → Execute → ... │ └─────────────────────────────────────────────┘

Components

Component	Description
`models.py`	Data classes (Event, Action, Result, OpenLoop)
`store.py`	File-backed state management
`loop.py`	Main loop orchestrator
`agent.py`	Agent interface and CLI reference
`scheduler.py`	Timer and schedule management
`webhook.py`	Webhook receiver (GitHub, Slack, GitLab)
`adapters/`	External agent adapters (OpenClaw)

// development

Development

# Run tests
$ pytest

# Lint
$ ruff check src/

# Type check
$ mypy src/

# Format
$ ruff format src/

// license

License

HexClamp is open source and available under the Apache 2.0 License.

🔗 View on GitHub