AI Harness Framework

Composable AI agent harness framework for OpenCode.

Installation

npm install -g @piwero/ai-harness-cli

Agent Providers

AI Harness supports multiple AI agent providers.

OpenCode Provider

# Initialize with OpenCode
ah init --provider opencode

# Add to existing project
ah add opencode

# Add specific components
ah add opencode:agents,skills

# Using provider command
ah provider setup opencode

Usage

Initialize a new project:

ah init

Add components:

ah add typescript

Validate configuration:

ah validate

Development

This project uses mise for task management:

mise run build    # Build TypeScript
mise run test     # Run tests
mise run lint     # Run linter
mise run typecheck # TypeScript check

Quick Start

npm install
npm run build

Architecture

The harness framework enables autonomous AI agents through systematic feedback loops:

• Guides (Feedforward): Markdown docs, conventions, patterns
• Sensors (Feedback): Computational and inferential validators

See .ai/specs/harness-framework-design.md for full design.

Project Structure

.ai/
  harness/              # Harness component library
    base/               # Universal components
    typescript/         # TypeScript-specific
    python/             # Python-specific
agents/                 # Agent definitions
src/                    # Core framework implementation