https://github.com/realzst/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!
https://github.com/realzst/harnesskit
ai-coding-agents claude-code cli-tools codex cursor developer-tools gemini-cli skill-manager
Last synced: 1 day ago
JSON representation
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!
- Host: GitHub
- URL: https://github.com/realzst/harnesskit
- Owner: RealZST
- License: apache-2.0
- Created: 2026-03-27T15:37:08.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-21T17:21:42.000Z (3 days ago)
- Last Synced: 2026-05-22T02:22:59.176Z (3 days ago)
- Topics: ai-coding-agents, claude-code, cli-tools, codex, cursor, developer-tools, gemini-cli, skill-manager
- Language: Rust
- Homepage:
- Size: 230 MB
- Stars: 272
- Watchers: 0
- Forks: 13
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
HarnessKit
English ยท ็ฎไฝไธญๆ
One home for every agent.
A free, open-source app to manage all your AI coding agents โ desktop, CLI, or web.
Whyย ย โขย ย Featuresย ย โขย ย Get Startedย ย โขย ย Roadmap
## Why HarnessKit?
Every agent, a different world. Extensions, configs, memory, and rules โ scattered across different directories, in different formats, with different conventions.
**HarnessKit brings them all under one roof** โ see, secure, and manage everything across every agent, from one place.
---
## Key Features
### ๐งฉ Full Suite Extension Management
HarnessKit manages **all five extension types** from a unified interface โ **Skills**, **MCP Servers**, **Plugins**, **Hooks**, and **Agent-first CLIs**.
| Agent | Skills | MCP | Plugins | Hooks | Agent-first CLIs |
|:---|:---:|:---:|:---:|:---:|:---:|
| **Claude Code** | โ | โ | โ | โ | โ |
| **Codex** | โ | โ | โ | โ | โ |
| **Gemini CLI** | โ | โ | โ | โ | โ |
| **Cursor** | โ | โ | โ | โ | โ |
| **Antigravity** | โ | โ | โ | โ | โ |
| **Copilot** | โ | โ | โ | โ | โ |
| **Windsurf** | โ | โ | โ | โ | โ |
| **OpenCode** | โ | โ | โ | โ | โ |
* "โ" indicates the agent currently does not support this extension type.
- **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.
- **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*.
- **Effortless management** โ Enable or disable right from the list. Check for updates across all extensions with one click.
- **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.
---
### ๐ค Agent Configs, Memory & Rules
HarnessKit manages every agent's **Configs**, **Memory**, **Rules**, **Subagents**, and **Ignore** files from one place. Currently supporting **8 agents**: **Claude Code**, **Codex**, **Gemini CLI**, **Cursor**, **Antigravity**, **Copilot**, **Windsurf**, and **OpenCode**.
- **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.
- **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.
- **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.
- **Real-time detection** โ The moment a config file is modified, the dashboard reflects it.
---
### ๐ก๏ธ Security Audit & Permission Transparency
Every extension is scanned by a built-in security engine with 18 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.
- **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.
- **Precise tracing** โ Every finding pinpoints the exact file and line number, so you can trace the issue immediately.
- **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.
- **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.
---
### ๐ช Marketplace Ecosystem
Discover, evaluate, and install โ three marketplaces in one, each with trending lists and search:
- **Skills** โ Browse and install from the [skills.sh](https://skills.sh) registry. Also supports install from **Git URL** or **local directory**.
- **MCP Servers** โ Browse the [Smithery](https://smithery.ai) registry of Model Context Protocol servers.
- **Agent-first CLI** โ Discover CLI tools built specifically for agents โ the newest frontier of the agent extension ecosystem.
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.
---
### ๐ Project-Level Management
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.
---
### ๐ฆ Kits
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.
- **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.
- **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.
- **Portable bundles** โ Export any Kit as a self-contained `.hk-kit.zip` to share with teammates or carry across machines. Import is one click.
- **Origin tracking** โ Kit-installed extensions merge with their marketplace origin in the Extensions list, so you always know where each extension came from.
---
### ๐ In-Place Management
HarnessKit works directly with your agents' native directories instead of copying them into a managed folder โ no shadow copies, no sync conflicts.
- **Native directories** โ Reads and writes directly to each agent's own config directory. Your files stay exactly where they are.
- **Non-destructive operations** โ Enabling or disabling an extension is a simple file rename in place. Nothing is moved or duplicated.
- **Zero lock-in** โ Uninstall HarnessKit and everything is exactly where it was. No migration, no cleanup needed.
---
### โจ๏ธ CLI Support
HarnessKit ships a standalone command-line interface (`hk`) for terminal-first workflows, available on **macOS**, **Linux**, and **Windows**:
```shell
$ hk status
Agents 8 detected (claude ยท codex ยท gemini ยท cursor ยท antigravity ยท copilot ยท windsurf ยท opencode)
Extensions 136 total (124 skills ยท 2 mcp ยท 8 plugins ยท 1 hooks ยท 1 clis)
$ hk list --kind skill --agent claude # filter by type and agent
$ hk audit # security audit with trust scores
$ hk enable my-skill # enable by name
$ hk disable --pack owner/repo # batch disable by source
```
---
### ๐ Web Mode
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.
```shell
$ hk serve
HarnessKit Web UI running at http://127.0.0.1:7070
```
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.
---
### โจ Thoughtful & Interactive UX
- ๐ก **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.
- ๐ **Dynamic Activity Feed** โ Agent Activity and Recently Installed timelines capture every config change, extension install, and agent event in real time.
- โก **Quick Actions** โ One-click View Agents, Run Audit, Check Updates, and Marketplace access right from the dashboard.
- ๐ฏ **Playful Touches** โ Smooth animations and micro-interactions throughout the app make daily use feel alive.
- ๐จ **Themes** โ Multiple themes with Light, Dark, and System mode support.
---
## Getting Started
**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:
```bash
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/RealZST/HarnessKit/main/install.sh | sh
```
```powershell
# Windows (PowerShell)
irm https://raw.githubusercontent.com/RealZST/HarnessKit/main/install.ps1 | iex
```
2. Start the web interface:
```bash
hk serve
```
Then open `http://localhost:7070` in your browser.
#### Remote server
1. Install HarnessKit on the server:
```bash
# macOS / Linux server
ssh user@your-server
curl -fsSL https://raw.githubusercontent.com/RealZST/HarnessKit/main/install.sh | sh
exit
```
```powershell
# Windows server
ssh user@your-server
irm https://raw.githubusercontent.com/RealZST/HarnessKit/main/install.ps1 | iex
exit
```
2. Start the web interface:
```bash
ssh -L 7070:localhost:7070 user@your-server
hk serve
```
Then open `http://localhost:7070` in your local browser. Keep the SSH session running while you use HarnessKit.
Manual download โ if you prefer not to use the install script, or your machine doesn't have curl
Download the binary for your platform from the [latest release](https://github.com/RealZST/HarnessKit/releases/latest) (referred to as `` below):
| Platform | File |
|----------|------|
| macOS (Apple Silicon) | `hk-macos-arm64` |
| macOS (Intel) | `hk-macos-x64` |
| Linux | `hk-linux-x64` |
| Windows | `hk-windows-x64.exe` |
**Local machine:**
1. Install HarnessKit:
```bash
# macOS / Linux
chmod +x
mkdir -p ~/.local/bin
mv ~/.local/bin/hk
```
```powershell
# Windows (PowerShell)
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.local\bin" | Out-Null
Move-Item "$env:USERPROFILE\.local\bin\hk.exe"
```
2. Start the web interface:
```bash
hk serve
```
Then open `http://localhost:7070` in your browser.
**Remote server:**
1. Upload and install the binary on the server:
```bash
scp user@your-server:~/
ssh user@your-server
chmod +x ~/
mkdir -p ~/.local/bin
mv ~/ ~/.local/bin/hk
exit
```
2. Start the web interface:
```bash
ssh -L 7070:localhost:7070 user@your-server
hk serve
```
Then open `http://localhost:7070` in your local browser. Keep the SSH session running while you use HarnessKit.
#### Updating
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.
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`).
### โจ๏ธ CLI (macOS / Linux / Windows)
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.
See [CLI Support](#%EF%B8%8F-cli-support) above for the full list of commands.
---
## Roadmap
- ๐ค **More Agents** โ Hermes-agent, OpenClaw, and more
- โจ๏ธ **CLI Enhancements** โ More commands and richer functionality for `hk`
---
## Contributing
Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for local setup, project structure, and PR guidelines.
---
## License
This project is licensed under [Apache-2.0](LICENSE).
Artwork (`public/icons/` and `src/components/shared/agent-mascot/`) is **All Rights Reserved** and is not covered by the Apache-2.0 license.
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.