@zhijiewang/openharness 0.1.1 → 0.2.0

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,27 @@
+---
+name: Bug report
+about: Report a bug in OpenHarness
+labels: bug
+---
+
+**Describe the bug**
+A clear description of what the bug is.
+
+**To reproduce**
+Steps to reproduce the behavior:
+1. Run `oh ...`
+2. See error
+
+**Expected behavior**
+What you expected to happen.
+
+**Environment**
+- OS:
+- Node version:
+- OpenHarness version:
+- LLM provider:
+
+**Logs / error output**
+```
+paste any relevant output here
+```

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,17 @@
+---
+name: Feature request
+about: Suggest an idea for OpenHarness
+labels: enhancement
+---
+
+**Problem / motivation**
+What problem does this solve, or what use case does it enable?
+
+**Proposed solution**
+Describe the feature you'd like.
+
+**Alternatives considered**
+Any other approaches you've thought about?
+
+**Additional context**
+Screenshots, examples, or links if relevant.

package/.github/pull_request_template.md

@@ -0,0 +1,24 @@
+## Summary
+
+<!-- What does this PR do? -->
+
+## Related issue
+
+Closes #
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Breaking change
+- [ ] Documentation
+
+## Testing
+
+<!-- How did you test this? -->
+
+## Checklist
+
+- [ ] Code builds without errors (`npm run build`)
+- [ ] Types pass (`npm run typecheck`)
+- [ ] Tests pass (`npm test`)

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,43 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes
+- Focusing on what is best not just for us as individuals, but for the overall community
+
+Examples of unacceptable behavior:
+
+- The use of sexualized language or imagery, and sexual attention or advances of any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information without explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at the repository's issue tracker or by contacting the maintainer directly via GitHub.
+
+All complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1.

package/README.md

@@ -1,156 +1,160 @@
-# OpenHarness
-
-```
-        ___
-       /   \
-      (     )        ___  ___  ___ _  _ _  _   _ ___ _  _ ___ ___ ___
-       `~w~`        / _ \| _ \| __| \| | || | /_\ | _ \ \| | __/ __/ __|
-       (( ))       | (_) |  _/| _|| .` | __ |/ _ \|   / .` | _|\__ \__ \
-        ))((        \___/|_|  |___|_|\_|_||_/_/ \_\_|_\_|\_|___|___/___/
-       ((  ))
-        `--`
-```
-
-Open-source terminal coding agent. Build your own Claude Code with any LLM.
-
-![Status: Alpha](https://img.shields.io/badge/status-alpha-orange)
-![Node.js 18+](https://img.shields.io/badge/node-18%2B-green)
-![TypeScript](https://img.shields.io/badge/typescript-strict-blue)
-![License: MIT](https://img.shields.io/badge/license-MIT-green)
-
----
-
-## Quick Start
-
-```bash
-npm install -g @zhijiewang/openharness
-oh
-```
-
-That's it. Just type `oh` to start chatting with your local Ollama model.
-
-```bash
-oh                                    # auto-detect Ollama, start chatting
-oh --model ollama/qwen2.5:7b         # specific model
-oh --model gpt-4o                     # use OpenAI (needs OPENAI_API_KEY)
-oh --trust                            # auto-approve all tool calls
-```
-
-<!-- ![Demo](assets/demo.gif) -->
-
-## Install
-
-Requires **Node.js 18+**.
-
-```bash
-# From npm
-npm install -g @zhijiewang/openharness
-
-# From source
-git clone https://github.com/zhijiewong/openharness.git
-cd openharness
-npm install
-npm install -g .
-oh
-```
-
-## Why OpenHarness?
-
-Claude Code is powerful but locked to Anthropic. OpenHarness gives you the same architecture -- React+Ink terminal UI, async generator agent loop, Zod tool schemas, permission gates -- but works with **any LLM**. Local models via Ollama (free, offline, private), or cloud APIs (OpenAI, Anthropic, OpenRouter, DeepSeek, Groq, and any OpenAI-compatible endpoint).
-
-## Tools
-
-| Tool | Risk | Description |
-|------|------|-------------|
-| Read | low | Read files with line ranges |
-| Edit | medium | Search-and-replace edits |
-| Write | medium | Create or overwrite files |
-| Bash | high | Shell commands with timeout |
-| Glob | low | Find files by pattern |
-| Grep | low | Regex content search |
-| WebFetch | medium | Fetch URL content |
-
-Low-risk tools auto-approve. Medium and high risk require confirmation in `ask` mode.
-
-## Commands
-
-```bash
-oh                          # start chatting (default command)
-oh --model MODEL            # use a specific model
-oh --trust                  # auto-approve all tools
-oh --deny                   # block all non-read tools
-oh --resume ID              # resume a saved session
-oh models                   # list models and pricing
-oh tools                    # list tools and risk levels
-oh init                     # set up .oh/ for current project
-oh sessions                 # list saved sessions
-oh rules                    # show project rules
-oh --version                # show version
-```
-
-## Providers
-
-```bash
-# Local (free, no API key)
-oh --model ollama/llama3
-oh --model ollama/qwen2.5:7b-instruct
-
-# Cloud (set API key as env var)
-OPENAI_API_KEY=sk-... oh --model gpt-4o
-ANTHROPIC_API_KEY=sk-ant-... oh --model claude-sonnet-4-6
-OPENROUTER_API_KEY=sk-or-... oh --model openrouter/deepseek-chat
-```
-
-## Project Rules
-
-Create `.oh/RULES.md` in any repo (or run `oh init`):
-
-```markdown
-- Always run tests after changes
-- Use strict TypeScript
-- Never commit to main directly
-```
-
-Rules load automatically into every session.
-
-## Tech Stack
-
-| | OpenHarness | Claude Code |
-|---|---|---|
-| Language | TypeScript (strict) | TypeScript (strict) |
-| Runtime | Node.js 18+ | Bun |
-| Terminal UI | React + Ink | React + custom Ink fork |
-| Tool schemas | Zod | Zod |
-| Agent loop | async generators | async generators |
-| Providers | Any (5 built-in) | Anthropic only |
-| License | MIT | Proprietary |
-
-## Development
-
-```bash
-git clone https://github.com/zhijiewong/openharness.git
-cd openharness
-npm install
-npx tsx src/main.tsx              # run in dev mode
-npx tsc --noEmit                  # type check
-```
-
-### Adding a provider
-
-Create `src/providers/yourprovider.ts` implementing the `Provider` interface, add a case in `src/providers/index.ts`.
-
-### Adding a tool
-
-Create `src/tools/YourTool/index.ts` implementing the `Tool` interface with a Zod input schema, register it in `src/tools.ts`.
-
-## Contributing
-
-See [CONTRIBUTING.md](CONTRIBUTING.md).
-
-## License
-
-MIT
-
----
-
-This project is not affiliated with Anthropic.
+# OpenHarness
+
+```
+        ___
+       /   \
+      (     )        ___  ___  ___ _  _ _  _   _ ___ _  _ ___ ___ ___
+       `~w~`        / _ \| _ \| __| \| | || | /_\ | _ \ \| | __/ __/ __|
+       (( ))       | (_) |  _/| _|| .` | __ |/ _ \|   / .` | _|\__ \__ \
+        ))((        \___/|_|  |___|_|\_|_||_/_/ \_\_|_\_|\_|___|___/___/
+       ((  ))
+        `--`
+```
+
+Open-source terminal coding agent. Build your own Claude Code with any LLM.
+
+![Status: Alpha](https://img.shields.io/badge/status-alpha-orange)
+![Node.js 18+](https://img.shields.io/badge/node-18%2B-green)
+![TypeScript](https://img.shields.io/badge/typescript-strict-blue)
+![License: MIT](https://img.shields.io/badge/license-MIT-green)
+
+---
+
+<video src="https://github.com/user-attachments/assets/ed19a2cc-14d3-4db3-aa5b-3dc07c444498" controls width="100%"></video>
+
+---
+
+## Quick Start
+
+```bash
+npm install -g @zhijiewang/openharness
+oh
+```
+
+That's it. Just type `oh` to start chatting with your local Ollama model.
+
+```bash
+oh                                    # auto-detect Ollama, start chatting
+oh --model ollama/qwen2.5:7b         # specific model
+oh --model gpt-4o                     # use OpenAI (needs OPENAI_API_KEY)
+oh --trust                            # auto-approve all tool calls
+```
+
+<!-- ![Demo](assets/demo.gif) -->
+
+## Install
+
+Requires **Node.js 18+**.
+
+```bash
+# From npm
+npm install -g @zhijiewang/openharness
+
+# From source
+git clone https://github.com/zhijiewong/openharness.git
+cd openharness
+npm install
+npm install -g .
+oh
+```
+
+## Why OpenHarness?
+
+Claude Code is powerful but locked to Anthropic. OpenHarness gives you the same architecture -- React+Ink terminal UI, async generator agent loop, Zod tool schemas, permission gates -- but works with **any LLM**. Local models via Ollama (free, offline, private), or cloud APIs (OpenAI, Anthropic, OpenRouter, DeepSeek, Groq, and any OpenAI-compatible endpoint).
+
+## Tools
+
+| Tool | Risk | Description |
+|------|------|-------------|
+| Read | low | Read files with line ranges |
+| Edit | medium | Search-and-replace edits |
+| Write | medium | Create or overwrite files |
+| Bash | high | Shell commands with timeout |
+| Glob | low | Find files by pattern |
+| Grep | low | Regex content search |
+| WebFetch | medium | Fetch URL content |
+
+Low-risk tools auto-approve. Medium and high risk require confirmation in `ask` mode.
+
+## Commands
+
+```bash
+oh                          # start chatting (default command)
+oh --model MODEL            # use a specific model
+oh --trust                  # auto-approve all tools
+oh --deny                   # block all non-read tools
+oh --resume ID              # resume a saved session
+oh models                   # list models and pricing
+oh tools                    # list tools and risk levels
+oh init                     # set up .oh/ for current project
+oh sessions                 # list saved sessions
+oh rules                    # show project rules
+oh --version                # show version
+```
+
+## Providers
+
+```bash
+# Local (free, no API key)
+oh --model ollama/llama3
+oh --model ollama/qwen2.5:7b-instruct
+
+# Cloud (set API key as env var)
+OPENAI_API_KEY=sk-... oh --model gpt-4o
+ANTHROPIC_API_KEY=sk-ant-... oh --model claude-sonnet-4-6
+OPENROUTER_API_KEY=sk-or-... oh --model openrouter/deepseek-chat
+```
+
+## Project Rules
+
+Create `.oh/RULES.md` in any repo (or run `oh init`):
+
+```markdown
+- Always run tests after changes
+- Use strict TypeScript
+- Never commit to main directly
+```
+
+Rules load automatically into every session.
+
+## Tech Stack
+
+| | OpenHarness | Claude Code |
+|---|---|---|
+| Language | TypeScript (strict) | TypeScript (strict) |
+| Runtime | Node.js 18+ | Bun |
+| Terminal UI | React + Ink | React + custom Ink fork |
+| Tool schemas | Zod | Zod |
+| Agent loop | async generators | async generators |
+| Providers | Any (5 built-in) | Anthropic only |
+| License | MIT | Proprietary |
+
+## Development
+
+```bash
+git clone https://github.com/zhijiewong/openharness.git
+cd openharness
+npm install
+npx tsx src/main.tsx              # run in dev mode
+npx tsc --noEmit                  # type check
+```
+
+### Adding a provider
+
+Create `src/providers/yourprovider.ts` implementing the `Provider` interface, add a case in `src/providers/index.ts`.
+
+### Adding a tool
+
+Create `src/tools/YourTool/index.ts` implementing the `Tool` interface with a Zod input schema, register it in `src/tools.ts`.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+MIT
+
+---
+
+This project is not affiliated with Anthropic.

package/SECURITY.md

@@ -0,0 +1,21 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported |
+|---------|-----------|
+| 0.1.x   | ✅        |
+
+## Reporting a Vulnerability
+
+Please **do not** report security vulnerabilities via public GitHub issues.
+
+Instead, open a [GitHub Security Advisory](https://github.com/zhijiewong/openharness/security/advisories/new) or contact the maintainer directly via the profile on GitHub.
+
+Please include:
+- Description of the vulnerability
+- Steps to reproduce
+- Potential impact
+- Suggested fix (if any)
+
+You can expect a response within 48 hours. If confirmed, a patch will be prioritized and released as soon as possible.

package/dist/commands/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Slash command system — /help, /clear, /diff, /undo, /cost, etc.
+ *
+ * Commands are processed in the REPL before being sent to the LLM.
+ * If input starts with /, it's treated as a command.
+ */
+import type { Message } from "../types/message.js";
+export type CommandResult = {
+    /** Text output to display */
+    output: string;
+    /** If true, don't send to LLM */
+    handled: boolean;
+    /** If set, clear messages */
+    clearMessages?: boolean;
+    /** If set, update model */
+    newModel?: string;
+    /** If set, replace messages with compacted version */
+    compactedMessages?: Message[];
+};
+export type CommandContext = {
+    messages: Message[];
+    model: string;
+    permissionMode: string;
+    totalCost: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    sessionId: string;
+};
+/**
+ * Check if input is a slash command. If so, execute it.
+ */
+export declare function processSlashCommand(input: string, context: CommandContext): CommandResult | null;
+/**
+ * Get all registered command names (for autocomplete/display).
+ */
+export declare function getCommandNames(): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG;IAC1B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAC;CAC/B,CAAC;AAIF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AA4KF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa,GAAG,IAAI,CAiBhG;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C"}