AI Engineering Harness

A harness for AI coding agents that provides context engineering patterns, commands, and configurations. Install once and instantly configure Claude Code, OpenCode, and Gemini CLI with battle-tested prompts, agents, and workflows.

Supported Tools

• Claude Code (code.claude.com) — Supported
• OpenCode (opencode.ai) — Supported
• Gemini CLI (ai.google.dev/gemini-cli) — Supported
• Pi (github.com/nicholasgasior/pi-coding-agent) — Supported

Quick Start

Prerequisites

• Deno (or npx deno as a zero-install fallback)

# macOS / Linux
curl -fsSL https://deno.land/install.sh | sh

# macOS (Homebrew)
brew install deno

Install

Register the CLI (one-time):

deno install -Agf -n ai-harness \
  https://raw.githubusercontent.com/adrielp/ai-engineering-harness/main/install.ts

Then install configs:

ai-harness --tool=claude          # Claude Code
ai-harness --tool=opencode        # OpenCode
ai-harness --tool=gemini          # Gemini CLI
ai-harness --tool=pi              # Pi
ai-harness --tool=all             # All four

More options:

ai-harness --tool=claude --dry-run        # Preview changes
ai-harness --tool=claude --interactive    # Pick components
ai-harness --tool=claude --skill=agents   # Specific component
ai-harness --help                         # Full usage

Files are copied as real files — nothing breaks if you discard the installer. Re-running is safe: unchanged files are skipped, modified files show a diff and prompt for confirmation.

Private & Enterprise Repos

For private or enterprise GitHub repos, clone and run locally:

gh repo clone /ai-engineering-harness /tmp/aih -- --depth=1 -q \
  && GITHUB_TOKEN=$(gh auth token) deno run -A /tmp/aih/install.ts --tool=claude \
  && rm -rf /tmp/aih

gh handles all git authentication automatically. GITHUB_TOKEN lets the installer fetch manifest and file contents from the cloned repo’s remote origin if needed.

Alternative: Direct Run

Skip the CLI registration and run directly:

deno run -A \
  https://raw.githubusercontent.com/adrielp/ai-engineering-harness//install.ts \
  --tool=claude

Replace `` with a git tag or commit SHA from the releases page.

Alternative: Repo Mode (GNU Stow)

For users who want the repo on their system with symlinks (easier git pull updates):

# Prerequisites: GNU Stow (brew install stow / apt install stow)
git clone https://github.com/adrielp/ai-engineering-harness.git
cd ai-engineering-harness

./setup.sh claude             # Install Claude Code → ~/.claude/
./setup.sh opencode           # Install OpenCode → ~/.config/opencode/
./setup.sh gemini             # Install Gemini CLI → ~/.gemini/
./setup.sh pi                 # Install Pi → ~/.pi/agent/
./setup.sh all                # Install all four

# Useful flags