Skip to content
Back to search

HarnessKit

More than a skill manager โ€” manage skills, MCP servers, plugins, hooks, CLIs, configs, memory & rules across every AI coding agent. ๐ŸŒŸ Star if you like it!

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/RealZST/HarnessKit with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/RealZST/HarnessKit'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/realzst--harnesskit/badge.svg)](/listings/realzst--harnesskit)

HTML

<a href="/listings/realzst--harnesskit"><img src="/api/listings/realzst--harnesskit/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

**Requirements:** At least one supported AI coding agent installed.

๐Ÿ–ฅ๏ธ Desktop App (macOS)

1. Download the DMG for your architecture from the [latest release](https://github.com/RealZST/HarnessKit/releases/latest):

| Chip | File | |------|------| | Apple Silicon (M1/M2/M3/M4) | `HarnessKit_x.x.x_aarch64.dmg` | | Intel | `HarnessKit_x.x.x_x64.dmg` |

2. Open the DMG and drag **HarnessKit** to the Applications folder. 3. Launch HarnessKit. It will automatically detect your installed agents and scan their extensions.

Already installed? Open **Settings โ†’ Check for Updates** to upgrade in-app.

๐ŸŒ Web Mode (macOS / Linux / Windows)

Local machine

1. Install HarnessKit:

   # macOS / Linux
   curl -fsSL https://raw.githubusercontent.com/RealZST/HarnessKit/main/install.sh | sh
   # Windows (PowerShell)
   irm https://raw.githubusercontent.com/RealZST/HarnessKit/main/install.ps1 | iex

2. Start the web interface:

   hk serve

Then open the `http://localhost:7070/?token=โ€ฆ` URL that `hk serve` prints. Auth is on by default; the token is saved, so next time `http://localhost:7070` just works. On a trusted single-user machine, `hk serve --no-token` skips the token entirely.

Remote server

1. Install HarnessKit on the server:

   # macOS / Linux server
   ssh user@your-server
   curl -fsSL https://raw.githubusercontent.com/RealZST/HarnessKit/main/install.sh | sh
   exit
   # Windows server
   ssh user@your-server
   irm https://raw.githubusercontent.com/RealZST/HarnessKit/main/install.ps1 | iex
   exit

2. Start the web interface:

   ssh -L 7070:localhost:7070 user@your-server
   hk serve

Then open the `http://localhost:7070/?token=โ€ฆ` URL that `hk serve` prints, in your local browser. Auth is on by default; the token is saved, so next time `http://localhost:7070` just works. Keep the SSH session running while you use HarnessKit.

> <sub>**Tip:** Managing several remote nodes? Start each with `hk serve --name <label>` (e.g. `--name my-macbook`). The label shows in the sidebar and the browser tab title, so multiple tabs are easy to tell apart. Defaults to the machine hostname.</sub>

<details> <summary><strong>Manual download</strong> โ€” if you prefer not to use the install script, or your machine doesn't have <code>curl</code></summary>

<br/>

Download the binary for your platform from the [latest release](https://github.com/RealZST/HarnessKit/releases/latest) (referred to as `<file>` below):

| Platform | File | |----------|------| | macOS (Apple Silicon) | `hk-macos-arm64` | | macOS (Intel) | `hk-macos-x64` | | Linux (x64) | `hk-linux-x64` | | Linux (ARM64) | `hk-linux-arm64` | | Windows | `hk-windows-x64.exe` |

**Local machine:**

1. Install HarnessKit:

   # macOS / Linux
   chmod +x <file>
   mkdir -p ~/.local/bin
   mv <file> ~/.local/bin/hk
   # Windows (PowerShell)
   New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.local\bin" | Out-Null
   Move-Item <file> "$env:USERPROFILE\.local\bin\hk.exe"

2. Start the web interface:

   hk serve

Then open the `http://localhost:7070/?token=โ€ฆ` URL that `hk serve` prints. Auth is on by default; the token is saved, so next time `http://localhost:7070` just works. On a trusted single-user machine, `hk serve --no-token` skips the token entirely.

**Remote server:**

1. Upload and install the binary on the server:

   scp <file> user@your-server:~/
   ssh user@your-server
   chmod +x ~/<file>
   mkdir -p ~/.local/bin
   mv ~/<file> ~/.local/bin/hk
   exit

2. Start the web interface:

   ssh -L 7070:localhost:7070 user@your-server
   hk serve

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md ยท README ยท 404 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="public/icons/harnesskit-icons.png" alt="HarnessKit" width="160" />
  3. </p>
  4. <h1 align="center">HarnessKit</h1>
  5. <p align="center">
  6. <strong>English</strong> ยท <a href="README.zh-CN.md">็ฎ€ไฝ“ไธญๆ–‡</a>
  7. </p>
  8. <p align="center">
  9. <strong>One home for every agent.</strong><br/>
  10. A free, open-source app to manage all your AI coding agents โ€” desktop, CLI, or web.
  11. </p>
  12. <p align="center">
  13. <a href="https://github.com/RealZST/HarnessKit/releases/latest"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/RealZST/HarnessKit/main/.github/badges/release.json&style=flat-square" alt="Latest Release" /></a>
  14. <a href="https://github.com/RealZST/HarnessKit/releases"><img src="https://img.shields.io/github/downloads/RealZST/HarnessKit/total?style=flat-square&color=blueviolet&cacheSeconds=86400" alt="Total Downloads" /></a>
  15. <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue?style=flat-square" alt="License" /></a>
  16. <a href="#getting-started"><img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey?style=flat-square" alt="Platform" /></a>
  17. </p>
  18. <p align="center">
  19. <a href="https://harness-kit.dev">Website</a>&nbsp;&nbsp;&bull;&nbsp;&nbsp;<a href="https://harness-kit.dev/docs/">Docs</a>&nbsp;&nbsp;&bull;&nbsp;&nbsp;<a href="#why-harnesskit">Why</a>&nbsp;&nbsp;&bull;&nbsp;&nbsp;<a href="#key-features">Features</a>&nbsp;&nbsp;&bull;&nbsp;&nbsp;<a href="#getting-started">Get Started</a>&nbsp;&nbsp;&bull;&nbsp;&nbsp;<a href="#roadmap">Roadmap</a>
  20. </p>
  21. <br/>
  22. <p align="center">
  23. <img src="media/agents-animation.gif" alt="HarnessKit Agents Animation" width="800" />
  24. </p>
  25. <p align="center">
  26. <small><i>Every supported agent shows on the Overview by default, installed or not. In Settings โ†’ Agent Paths, switch to "Detected only" to hide and disable undetected agents, or flip a single agent's "Enabled" toggle off.</i></small>
  27. </p>
  28. <br/>
  29. ## Why HarnessKit?
  30. Every agent, a different world. Extensions, configs, memory, and rules โ€” scattered across different directories, in different formats, with different conventions.
  31. **HarnessKit brings them all under one roof** โ€” see, secure, and manage everything across every agent, from one place.
  32. <p align="center">
  33. <img src="media/overview.png" alt="HarnessKit Overview" width="800" />
  34. </p>
  35. ---
  36. ## Key Features
  37. ### ๐Ÿงฉ Full Suite Extension Management
  38. HarnessKit manages **all five extension types** from a unified interface โ€” **Skills**, **MCP Servers**, **Plugins**, **Hooks**, and **Agent-first CLIs**.
  39. <div align="center">
  40. | Agent | Skills | MCP | Plugins | Hooks | Agent-first CLIs |
  41. |:---|:---:|:---:|:---:|:---:|:---:|
  42. | **Claude Code** | โœ“ | โœ“ | โœ“ | โœ“ | โœ“ |
  43. | **Codex** | โœ“ | โœ“ | โœ“ | โœ“ | โœ“ |
  44. | **Gemini CLI** | โœ“ | โœ“ | โœ“ | โœ“ | โœ“ |
  45. | **Cursor** | โœ“ | โœ“ | โœ“ | โœ“ | โœ“ |
  46. | **Antigravity** | โœ“ | โœ“ | โ€” | โ€” | โœ“ |
  47. | **Copilot** | โœ“ | โœ“ | โœ“ | โœ“ | โœ“ |
  48. | **Devin Desktop** | โœ“ | โœ“ | โ€” | โœ“ | โœ“ |
  49. | **OpenCode** | โœ“ | โœ“ | โœ“ | โ€” | โœ“ |
  50. | **Hermes** | โœ“ | โœ“ | โœ“ | โœ“ | โœ“ |
  51. | **Kiro** | โœ“ | โœ“ | โ€” | โœ“ | โœ“ |
  52. | **Oh My Pi** | โœ“ | โœ“ | โœ“ | โ€” | โœ“ |
  53. | **DeepSeek Harness** | โœ“ | โœ“ | โœ“ | โ€” | โœ“ |
  54. | **Grok Build** | โœ“ | โœ“ | โœ“ | โœ“ | โœ“ |
  55. | **Qoder CN** | โœ“ | โœ“ | โœ“ | โœ“ | โœ“ |
  56. | **OpenClaw** | โœ“ | โœ“ | โ€” | โ€” | โœ“ |
  57. | **PenguinHarness** | โœ“ | โ€” | โ€” | โ€” | โ€” |
  58. | **Pi** | โœ“ | โœ“ | โœ“ | โ€” | โœ“ |
  59. <small><i>* "โ€”" means HarnessKit does not manage this extension type for the agent yet.</i></small>
  60. </div>
  61. - **Smart organization** โ€” Filter by *type*, *agent*, or *source*, and search by name. Extensions from the same repo are automatically grouped into *packs* for batch management.
  62. - **Full visibility** โ€” Every extension shows its *agents*, *permissions*, *trust score*, and *status* at a glance. Open the detail panel for per-agent *file paths*, *directory structure*, and *audit findings*.
  63. - **Effortless management** โ€” Enable or disable right from the list. Check for updates across all extensions with one click.
  64. - **Cross-agent deployment** โ€” See which agents have the extension and which don't โ€” deploy to any missing agent with one click. HarnessKit handles the format differences between agents (JSON, TOML, hook conventions, MCP schemas) automatically.
  65. https://github.com/user-attachments/assets/897611c4-4ca3-426f-91ba-fcda301e9cfe
  66. https://github.com/user-attachments/assets/a2a74fd1-f3f2-4525-9d64-ba00378d6eef
  67. ---
  68. ### ๐Ÿค– Agent Configs, Memory & Rules
  69. HarnessKit manages every agent's **Configs**, **Memory**, **Rules**, **Subagents**, and **Ignore** files from one place. Currently supporting **17 agents**: **Claude Code**, **Codex**, **Gemini CLI**, **Cursor**, **Antigravity**, **Copilot**, **Devin Desktop**, **OpenCode**, **Hermes**, **Kiro**, **Oh My Pi**, **DeepSeek Harness**, **Grok Build**, **Qoder CN**, **OpenClaw**, **PenguinHarness**, and **Pi**.
  70. - **Config file tracking** โ€” Automatically discovers every agent's config files โ€” both global and per-project. Add your project directories or custom paths and HarnessKit picks them up alongside the global ones.
  71. - **Per-agent dashboard** โ€” Each agent gets its own page with all files organized by category, showing scope, path, file size, and a summary of installed extensions. Expand any file to preview its content right in the app.
  72. - **Custom paths** โ€” Add any file or folder to an agent's dashboard for tracking. Useful for custom configs or scripts that HarnessKit doesn't auto-discover โ€” they show up alongside everything else with the same live preview.
  73. - **Real-time detection** โ€” The moment a config file is modified, the dashboard reflects it.
  74. https://github.com/user-attachments/assets/9b38494a-2ab3-4071-a450-02a30b859323
  75. ---
  76. ### ๐Ÿ›ก๏ธ Security Audit & Permission Transparency
  77. Every extension is scanned by a built-in security engine with 20 static analysis rules and receives a **Trust Score** (0โ€“100), grouped into three tiers โ€” **Safe** (80+), **Low Risk** (60โ€“79), and **Needs Review** (below 60). A dedicated Audit page lets you search, filter by tier, and drill into every finding.
  78. - **One-click audit** โ€” Run a full security scan across all extensions with a single click. The dashboard shows how many extensions were scanned and when the last audit ran.
  79. - **Precise tracing** โ€” Every finding pinpoints the exact file and line number, so you can trace the issue immediately.
  80. - **Per-agent scanning** โ€” Even if multiple agents share the same extension, each agent's copy is audited independently โ€” because versions can drift, and a safe copy on one agent doesn't guarantee safety on another.
  81. - **Permission transparency** โ€” Every extension's permissions are surfaced across five dimensions โ€” filesystem paths, network domains, shell commands, database engines, and environment variables. You see exactly what each extension can reach before you decide to keep it.
  82. https://github.com/user-attachments/assets/5650c759-f30f-42df-83b2-cf0bafd3fb95
  83. ---
  84. ### ๐Ÿช Marketplace Ecosystem
  85. Discover, evaluate, and install โ€” three marketplaces in one, each with trending lists and search:
  86. - **Skills** โ€” Browse and install from the [skills.sh](https://skills.sh) registry. Also supports install from **Git URL** or **local directory**.
  87. - **MCP Servers** โ€” Browse the [Smithery](https://smithery.ai) registry of Model Context Protocol servers.
  88. - **Agent-first CLI** โ€” Discover CLI tools built specifically for agents โ€” the newest frontier of the agent extension ecosystem.
  89. Every listing shows its description, install count, and source. For skills, you can preview the documentation, check third-party security audit scores before installing, and install to any agent with one click โ€” HarnessKit tracks the source so you always know where each extension came from.
  90. https://github.com/user-attachments/assets/a80e2c95-52fe-4cd5-aab1-bd01b4c224cf
  91. ---
  92. ### ๐Ÿ”€ Project-Level Management
  93. The sidebar scope picker switches between **Global**, **All scopes**, or any registered project. Agents, Extensions, and Audit all filter by the active scope โ€” per-project setups are managed independently of your global config.
  94. https://github.com/user-attachments/assets/321fc4b6-4f6b-4f6e-a9eb-1b0084334cb2
  95. https://github.com/user-attachments/assets/6392967a-e8a3-4805-9dc3-c4cf16f5c07f
  96. ---
  97. ### ๐Ÿ“ฆ Kits
  98. Pack a curated set of **skills**, **MCP servers**, **rules** and **memory** files into a portable **Kit** โ€” then deploy the whole bundle to any project with one click. Skip the setup churn every time you spin up a new project.
  99. - **Compose once, reuse everywhere** โ€” Build a Kit from your existing extensions, rules, and memory files. Pick a target agent at install time and HarnessKit writes everything to the right places.
  100. - **Multi-project ready** โ€” Install the same Kit to as many projects as you need. The detail drawer shows where each one is currently deployed, and removing it from a project cleans up cleanly.
  101. - **Portable bundles** โ€” Export any Kit as a self-contained `.hk-kit.zip` to share with teammates or carry across machines. Import is one click.
  102. - **Origin tracking** โ€” Kit-installed extensions keep their marketplace origin in the Extensions list, so you always know where each extension came from.
  103. https://github.com/user-attachments/assets/e9621e72-f47d-4ea6-99b3-fbd296692048
  104. https://github.com/user-attachments/assets/ec88b596-7999-436f-943e-1dce169cd6f0
  105. https://github.com/user-attachments/assets/c84b6513-484d-4b5d-b083-73de0b3e800e
  106. ---
  107. ### ๐Ÿ“‚ In-Place Management
  108. HarnessKit works directly with your agents' native directories instead of copying them into a managed folder โ€” no shadow copies, no sync conflicts.
  109. - **Native directories** โ€” Reads and writes directly to each agent's own config directory. Your files stay exactly where they are.
  110. - **Non-destructive operations** โ€” Disabling uses the agent's own off switch where it has one. Otherwise a skill is renamed in place (`SKILL.md.disabled`), and a config entry is removed and kept as a snapshot, ready to restore. Nothing is moved or duplicated.
  111. - **Zero lock-in** โ€” Uninstall HarnessKit and everything is exactly where it was. No migration, no cleanup needed.
  112. ---
  113. ### โŒจ๏ธ CLI Support
  114. HarnessKit ships a standalone command-line interface (`hk`) for terminal-first workflows, available on **macOS**, **Linux**, and **Windows**:
  115. ```shell
  116. $ hk status
  117. Agents 15 detected (claude ยท codex ยท gemini ยท cursor ยท antigravity ยท copilot ยท windsurf ยท opencode ยท hermes ยท kiro ยท omp ยท dsh ยท grok ยท qoder-cn ยท penguin)
  118. Extensions 136 total (124 skills ยท 2 mcp ยท 8 plugins ยท 1 hooks ยท 1 clis)
  119. $ hk list --kind skill --agent claude # filter by type and agent
  120. $ hk list --kind mcp --agent grok # Grok Build MCP servers
  121. $ hk audit # security audit with trust scores
  122. $ hk enable my-skill # enable by name
  123. $ hk disable --pack owner/repo # batch disable by source
  124. ```
  125. ---
  126. ### ๐ŸŒ Web Mode
  127. The same full-featured UI that runs in the desktop app is also available as a **web interface** โ€” served directly from the `hk` CLI binary. No extra dependencies, no separate install.
  128. ```shell
  129. $ hk serve
  130. HarnessKit Web UI [my-host] running at http://127.0.0.1:7070/?token=a1b2c3โ€ฆ
  131. ```
  132. This makes HarnessKit usable on **Linux servers**, **HPC clusters**, or any **headless machine** where a desktop app isn't an option. Web mode has **full feature parity** with the desktop app โ€” the only difference is that file-system operations (like "Open in Finder") are desktop-only. See [Getting Started](#getting-started) for setup instructions.
  133. ---
  134. ### โœจ Thoughtful & Interactive UX
  135. - ๐Ÿ’ก **Tip of the Day** โ€” The Overview dashboard surfaces contextual tips for each detected agent from a community-maintained library. Learn shortcuts and best practices as you work.
  136. - ๐Ÿ“Š **Dynamic Activity Feed** โ€” Agent Activity and Recently Installed timelines capture every config change, extension install, and agent event in real time.
  137. - โšก **Quick Actions** โ€” One-click View Agents, Run Audit, Check Updates, and Marketplace access right from the dashboard.
  138. - ๐ŸŽฏ **Playful Touches** โ€” Smooth animations and micro-interactions throughout the app make daily use feel alive.
  139. - ๐ŸŽจ **Themes** โ€” Multiple themes with Light, Dark, and System mode support.
  140. <p align="center">
  141. <img src="media/theme-tiesen.png" alt="Tiesen Theme" width="40%" />
  142. <img src="media/theme-claude.png" alt="Claude Theme" width="40%" />
  143. </p>
  144. ---
  145. ## Getting Started
  146. **Requirements:** At least one supported AI coding agent installed.
  147. <a href="https://github.com/RealZST/HarnessKit/releases/latest"><img src="https://img.shields.io/badge/Download-Latest_Release-brightgreen?style=for-the-badge&logo=github" alt="Download Latest Release" /></a>
  148. ### ๐Ÿ–ฅ๏ธ Desktop App (macOS / Windows)
  149. 1. Download the installer for your platform from the [latest release](https://github.com/RealZST/HarnessKit/releases/latest):
  150. | Platform | File |
  151. |----------|------|
  152. | macOS, Apple Silicon (M series) | `HarnessKit_x.x.x_aarch64.dmg` |
  153. | macOS, Intel | `HarnessKit_x.x.x_x64.dmg` |
  154. | Windows 10 / 11, 64-bit | `HarnessKit_x.x.x_x64-setup.exe` |
  155. 2. Install it:
  156. - **macOS:** open the DMG and drag **HarnessKit** to the Applications folder.
  157. - **Windows:** run the installer. It is not code-signed yet, so Windows SmartScreen shows a warning on first run: click **More info โ†’ Run anyway**.
  158. 3. Launch HarnessKit. It will automatically detect your installed agents and scan their extensions.
  159. Already installed? Open **Settings โ†’ Check for Updates** to upgrade in-app.
  160. ### ๐ŸŒ Web Mode (macOS / Linux / Windows)
  161. #### Local machine
  162. 1. Install HarnessKit:
  163. ```bash
  164. # macOS / Linux
  165. curl -fsSL https://raw.githubusercontent.com/RealZST/HarnessKit/main/install.sh | sh
  166. ```
  167. ```powershell
  168. # Windows (PowerShell)
  169. irm https://raw.githubusercontent.com/RealZST/HarnessKit/main/install.ps1 | iex
  170. ```
  171. 2. Start the web interface:
  172. ```bash
  173. hk serve
  174. ```
  175. Then open the `http://127.0.0.1:7070/?token=โ€ฆ` URL that `hk serve` prints. Auth is on by default; the token is saved, so next time `http://127.0.0.1:7070` just works. On a trusted single-user machine, `hk serve --no-token` skips the token entirely.
  176. #### Remote server
  177. 1. Install HarnessKit on the server:
  178. ```bash
  179. # macOS / Linux server
  180. ssh user@your-server
  181. curl -fsSL https://raw.githubusercontent.com/RealZST/HarnessKit/main/install.sh | sh
  182. exit
  183. ```
  184. ```powershell
  185. # Windows server (the SSH shell is cmd, so call PowerShell explicitly)
  186. ssh user@your-server
  187. powershell -c "irm https://raw.githubusercontent.com/RealZST/HarnessKit/main/install.ps1 | iex"
  188. exit
  189. ```
  190. 2. Start the web interface:
  191. ```bash
  192. ssh -L 7070:localhost:7070 user@your-server
  193. hk serve
  194. ```
  195. Then open the `http://127.0.0.1:7070/?token=โ€ฆ` URL that `hk serve` prints, in your local browser. Auth is on by default; the token is saved, so next time `http://127.0.0.1:7070` just works. Keep the SSH session running while you use HarnessKit.
  196. > <sub>**Tip:** Managing several remote nodes? Start each with `hk serve --name <label>` (e.g. `--name my-macbook`). The label shows in the sidebar and the browser tab title, so multiple tabs are easy to tell apart. Defaults to the machine hostname.</sub>
  197. <details>
  198. <summary><strong>Manual download</strong> โ€” if you prefer not to use the install script, or your machine doesn't have <code>curl</code></summary>
  199. <br/>
  200. Download the binary for your platform from the [latest release](https://github.com/RealZST/HarnessKit/releases/latest) (referred to as `<file>` below):
  201. | Platform | File |
  202. |----------|------|
  203. | macOS (Apple Silicon) | `hk-macos-arm64` |
  204. | macOS (Intel) | `hk-macos-x64` |
  205. | Linux (x64) | `hk-linux-x64` |
  206. | Linux (ARM64) | `hk-linux-arm64` |
  207. | Windows | `hk-windows-x64.exe` |
  208. **Local machine:**
  209. 1. Install HarnessKit:
  210. ```bash
  211. # macOS / Linux
  212. chmod +x <file>
  213. mkdir -p ~/.local/bin
  214. mv <file> ~/.local/bin/hk
  215. ```
  216. ```powershell
  217. # Windows (PowerShell)
  218. New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.local\bin" | Out-Null
  219. Move-Item <file> "$env:USERPROFILE\.local\bin\hk.exe"
  220. ```
  221. 2. Add `~/.local/bin` to your `PATH` if it isn't there yet (the install script does this for you), then restart the terminal:
  222. ```bash
  223. # macOS / Linux โ€” ~/.zshrc for zsh, ~/.bashrc for bash
  224. echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
  225. ```
  226. ```powershell
  227. # Windows (PowerShell)
  228. [Environment]::SetEnvironmentVariable("Path", "$env:USERPROFILE\.local\bin;" + [Environment]::GetEnvironmentVariable("Path", "User"), "User")
  229. ```
  230. 3. Start the web interface:
  231. ```bash
  232. hk serve
  233. ```
  234. Then open the `http://127.0.0.1:7070/?token=โ€ฆ` URL that `hk serve` prints. Auth is on by default; the token is saved, so next time `http://127.0.0.1:7070` just works. On a trusted single-user machine, `hk serve --no-token` skips the token entirely.
  235. **Remote server:**
  236. 1. Upload and install the binary on the server:
  237. ```bash
  238. scp <file> user@your-server:~/
  239. ssh user@your-server
  240. chmod +x ~/<file>
  241. mkdir -p ~/.local/bin
  242. mv ~/<file> ~/.local/bin/hk
  243. exit
  244. ```
  245. If `~/.local/bin` isn't in the server's `PATH`, add it as in step 2 above.
  246. 2. Start the web interface:
  247. ```bash
  248. ssh -L 7070:localhost:7070 user@your-server
  249. hk serve
  250. ```
  251. Then open the `http://127.0.0.1:7070/?token=โ€ฆ` URL that `hk serve` prints, in your local browser. Auth is on by default; the token is saved, so next time `http://127.0.0.1:7070` just works. Keep the SSH session running while you use HarnessKit.
  252. </details>
  253. #### Updating
  254. Re-run the install script from [Local machine](#local-machine) or [Remote server](#remote-server) above โ€” both scripts overwrite the existing `hk` binary. After updating, restart `hk serve` to pick up the new version.
  255. If you installed via manual download, grab the latest binary from [releases](https://github.com/RealZST/HarnessKit/releases/latest) and replace your existing `hk` (or `hk.exe`).
  256. ### โŒจ๏ธ CLI (macOS / Linux / Windows)
  257. If you've already installed HarnessKit via the [Web Mode](#-web-mode-macos--linux--windows) steps above, the CLI is ready to use โ€” it's the same `hk` binary.
  258. See [CLI Support](#%EF%B8%8F-cli-support) above for the full list of commands.
  259. ---
  260. ## Roadmap
  261. - ๐Ÿค– **More Agents** โ€” more to come
  262. - โŒจ๏ธ **CLI Enhancements** โ€” More commands and richer functionality for `hk`
  263. ---
  264. ## Contributing
  265. Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for local setup, project structure, and PR guidelines.
  266. ---
  267. ## License
  268. This project is licensed under [Apache-2.0](LICENSE).
  269. Artwork (`public/icons/` and `src/components/shared/agent-mascot/`) is **All Rights Reserved** and is not covered by the Apache-2.0 license.
  270. All product names, logos, and trademarks are property of their respective owners. HarnessKit is an independent project, not affiliated with or endorsed by any agent vendor.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If itโ€™s helped, pass it on.