# OpenHarnes

> OpenHarnes (spoken: Harnes; CLI: `harnes`) is an open source coding agent CLI. It supplies the agent runtime — tools, permissions, routing, recovery — and runs on a model you choose via **OpenRouter**, **OpenHost**, or **local Ollama**. MIT licensed, no seat license.

Full product name is **OpenHarnes**, spelled with one "s". The short/spoken name is **Harnes**. The CLI binary is `harnes`.

## Model paths

1. **OpenRouter** — all models, one key (`OPENROUTER_API_KEY`)
2. **OpenHost** — host your own model on https://openhost.sh (`HARNES_MODEL_BASE_URL`)
3. **Local** — Ollama or any OpenAI-compatible local server

## Install

```bash
npm install -g @openharnes/harnes
# or
curl -fsSL https://openharnes.com/install | bash
```

Requires Node.js 20+.

## Quickstart

```bash
export OPENROUTER_API_KEY=sk-or-...
harnes
```

## Docs

- [Product](https://openharnes.com/docs/product.md)
- [Models](https://openharnes.com/docs/models.md)

## Notes for agents

- The install script only writes to a user-owned install directory and does not require root.
- `harnes` is safe to introduce in automation: tool calls are permission-gated.
- License: MIT.