wedow

wedow / harness

Public

Minimal agent loop in bash. Pure state follower core with plugin-based tools, hooks, providers, and commands. Dependencies: bash 4+, jq, curl.

73
2
100% credibility
Found Mar 27, 2026 at 73 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Shell
AI Summary

Harness is a lightweight bash script that runs AI agent loops by discovering and chaining pluggable components for tools, AI providers, prompts, and behaviors.

How It Works

1
🔍 Discover Harness

You find a simple tool on GitHub that lets you create helpful AI assistants using easy-to-add building blocks.

2
📥 Bring it home

Download the main script to your computer and make it ready to run with a quick setup.

3
🔗 Link your AI brain

Connect a smart AI service like Claude or ChatGPT so your assistant can think and respond intelligently.

4
Pick your style
⚡
Quick task

Tell it to do something simple right away, like summarizing notes in your project.

💬
Chat mode

Jump into a back-and-forth chat where you can build on ideas over time.

5
🚀 Give it work

Type a request like 'find all to-do items and make a list,' and watch it handle tools and steps automatically.

6
🛠️ Add your touches

Drop in custom helpers for special tasks, like checking files or running scripts, right in your project folder.

🎉 Smart help achieved

Your assistant now tackles coding chores, file management, and more, saving you time with saved conversations ready to resume.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 73 to 73 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is harness?

Harness is a minimal agent harness on GitHub, built in bash, that runs AI agent loops with pluggable providers like OpenAI or Anthropic, tools, hooks, and commands. Drop an API key, run `hs "your prompt"` for one-shot tasks or `hs` for an interactive REPL, and resume sessions anytime with `hs session list`. It solves the bloat of heavy agent frameworks by making everything plugins—tools for file ops or bash execution, providers for any LLM API, and hooks for custom flows—all discovered from your project dirs.

Why is it gaining traction?

Unlike verbose Python agent libs, this agent harness GitHub tool stays under 100 lines of core bash, using jq and curl for a zero-install feel beyond symlinking the binary. Developers dig the runtime plugin hot-swapping, provider-agnostic message storage in plain markdown, and GitHub integration hooks for triggers, webhooks, or status checks—perfect for minimal API setups or GitHub Actions. The hook: extend with any-language executables, no restarts needed.

Who should use this?

Ops engineers automating repo tasks like TODO summaries or deploys via harness GitHub connectors. Indie devs prototyping field agent minimal wear scripts or Minecraft bots in bash. Teams needing lightweight harness engineering for GitHub apps, even on Windows 11 subsets.

Verdict

Grab it for bash-first AI tinkering—docs shine, CLI feels native—but with 73 stars and 1.0% credibility score, it's early alpha; test thoroughly before production. Solid for harness GitHub integration experiments.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.