# Harness.gg

> CLI tools that give AI agents the ability to interact with real apps.
> No MCP. No servers. No setup. Install and run.

## Discovery
- Full package registry: https://harness.gg/packages.json
- Feedback endpoint: https://harness.gg/api/submit
- Agent docs: https://harness.gg/<package>.json (replace <package> with the published key)

## Feedback API
Use POST https://harness.gg/api/submit with:
- type: "bug" | "feature" | "question"
- package: "electron" | "kdenlive" | "browser" | "blender" | "gimp"
- title: short summary
- body: full details
- context: optional environment details

## Published packages
### @harnessgg/electron
- Key: electron
- Version: 0.1.0
- Install: npm install -D @harnessgg/electron
- Binary: harness-electron
- Purpose: Interact with any Electron app via Chrome DevTools Protocol
- Requirements: Node.js >= 20
- Docs: https://harness.gg/electron
- GitHub: https://github.com/harnessgg/electron
- Registry: https://www.npmjs.com/package/@harnessgg/electron
- Commands: connect, dom, type, click, wait, screenshot, assert, evaluate, disconnect, sessions, capabilities
- Submit package key: "electron"
- Agent doc: https://harness.gg/electron.json

### harnessgg-kdenlive
- Key: kdenlive
- Version: 0.5.0
- Install: pip install harnessgg-kdenlive
- Binary: harnessgg-kdenlive
- Purpose: Automate Kdenlive video editing timelines, effects, and renders
- Requirements: Python >= 3.10
- Target app: Kdenlive with bridge running via harnessgg-kdenlive bridge start
- Docs: https://harness.gg/kdenlive
- GitHub: https://github.com/harnessgg/harness-kdenlive
- Registry: https://pypi.org/project/harnessgg-kdenlive/
- Commands: bridge start|status|verify, actions, capabilities, create-project, import-asset, add-text, add-clip, render-project, render-status, export-otio
- Submit package key: "kdenlive"
- Agent doc: https://harness.gg/kdenlive.json

### harnessgg-blender
- Key: blender
- Version: 0.3.0
- Install: pip install harnessgg-blender
- Binary: harnessgg-blender
- Purpose: Script Blender scenes, objects, materials, and renders from the CLI
- Requirements: Python >= 3.10
- Target app: Blender with bridge running via harnessgg-blender bridge start
- Docs: https://harness.gg/blender
- GitHub: https://github.com/harnessgg/harness-blender
- Registry: https://pypi.org/project/harnessgg-blender/
- Commands: bridge start|status|verify, file new|inspect, object add, material create|assign, camera add|set-active, render still|animation|status
- Submit package key: "blender"
- Agent doc: https://harness.gg/blender.json

### harnessgg-gimp
- Key: gimp
- Version: 0.2.0
- Install: pip install harnessgg-gimp
- Binary: harnessgg-gimp
- Purpose: Automate GIMP image editing with filters, adjustments, layers, and export
- Requirements: Python >= 3.10
- Target app: GIMP with bridge running via harnessgg-gimp bridge start
- Docs: https://harness.gg/gimp
- GitHub: https://github.com/harnessgg/harness-gimp
- Registry: https://pypi.org/project/harnessgg-gimp/
- Commands: bridge start|status|verify, inspect, resize, crop, montage-grid, brightness-contrast, levels, layer-add, export, run-macro
- Submit package key: "gimp"
- Agent doc: https://harness.gg/gimp.json

## Coming soon
### @harnessgg/browser
- Key: browser
- Install (planned): npm install -D @harnessgg/browser
- Purpose: Automate web browsers (Chromium, Firefox, WebKit) for AI agents
- Docs: https://harness.gg/browser
- Submit package key: "browser"