wingetCollections
  • Auto
  • Search
  • Awesome Collections
  • Awesome Programs
  • My Favorite Collections
  • My Collections
  • Account / Settings
  • Terms of Service
  • Privacy
  • About
  • What is WinGet?

© 2026 winget.ragerworks.com

Loading...
Install Harnest using Winget - wingetCollections
  1. Go back
  2. Packages
  3. Harnest
Harnest logo

Harnest Alex Gladkov

ai claude-code cli codex coding-assistant cursor developer-tools opencode qwen-code windsurf
Use this command to install Harnest:
winget install --id=AlexGladkov.Harnest -e

Harnest is an AI coding assistant configurator designed to simplify the setup of project contexts for tools like Claude Code, Cursor, Windsurf, Codex, OpenCode, and Qwen Code. It automates the detection of your project stack and generates configurations automatically.

Key Features:

  • Automated Stack Detection: Harnest identifies your project's technology stack across various languages and frameworks.
  • Interactive Agent Assignment Wizard: Guides you to assign appropriate agents for different roles in your project.
  • Multi-Tool Support: Works seamlessly with multiple AI coding tools, streamlining configuration across them.
  • Custom Content Preservation: Updates maintain any custom content outside managed blocks, ensuring your configurations stay intact.
  • CI/CD Integration: Offers a non-interactive mode ideal for automating setup in continuous integration pipelines.
  • Accessible CLI: Operates via the command line with installation available via winget.

Audience & Benefit: Ideal for developers leveraging AI coding assistants, particularly those managing complex or multi-stack projects. Harnest saves time and reduces configuration errors by automating setup processes, allowing you to focus on development rather than manual configurations.

README

Harnest

AI coding assistant configurator. Detects your project stack, runs an interactive agent wizard, and generates configs for Claude Code, Cursor, Windsurf, Codex, OpenCode, and Qwen Code.

About

Every AI coding tool needs project context. Manually maintaining CLAUDE.md, .cursorrules, .windsurfrules is tedious — especially for multi-stack projects where wrong agents get assigned.

Harnest solves this with a three-layer system:

Install

1. Get the binary

brew tap AlexGladkov/tap
brew install harnest

Or with npm:

npm install -g harnest

Or with Go:

go install github.com/AlexGladkov/harnest/cmd/harnest@latest

Or download from Releases.

2. Install the framework

harnest install

Installs 6 workflow profiles and global CLAUDE.md framework to ~/.claude/. Uses `` markers — your custom content is preserved on updates.

Scenarios

First-time setup

# 1. Install profiles + global CLAUDE.md
harnest install

# 2. Go to your project and generate config
cd my-project
harnest init

The wizard detects your stack, then asks for each role and exec scope:

Detected stack:
  - spring-boot (kotlin) [springApp/]
  - vue (typescript) [webApp/]
  - docker (dockerfile) [.]

── Agent Wizard ──
Found 42 agents on this machine
Enter = accept suggestion, s = skip, ? = search

[Consilium: architect]
  Suggestion: voltagent-lang:java-architect
  Enter=accept, s=skip, ?=search: _
  • Enter — accept suggestion
  • s — skip role (won't appear in config)
  • ? — search installed agents by name
  • type name — use your own agent (confirms if not found locally)

Detect stack without generating

harnest detect

Shows detected technologies without creating any config files.

Change agents after init

Versions
0.11.0
Website
github.com
License
Last updated
7/7/2026
Download latest version

Generated config wrong agent? Override it:

harnest agents set architect my-custom-architect

Or edit the generated file directly (CLAUDE.md, .cursorrules, .windsurfrules) — it's plain markdown.

View current agent mappings

harnest agents list

Shows consilium roles and exec scopes from your project config. If no config exists, shows suggestions based on detected stack.

Switch to a different harness

Already have CLAUDE.md but need .cursorrules too?

harnest convert --from claude-code --to cursor

Or re-run init for a specific harness:

harnest init --harness windsurf

CI / scripts (no wizard)

harnest init --non-interactive

Uses suggested agents automatically. Defaults to Claude Code.

Update profiles after Harnest upgrade

harnest install

Re-running install updates profiles and the managed block in global CLAUDE.md. Your custom content outside `` stays intact.

Manage profiles

harnest profiles list              # show installed profiles
harnest profiles add my-workflow    # interactive wizard to create custom profile
harnest profiles edit my-workflow   # open in $EDITOR
harnest profiles remove research   # delete profile

The add wizard lets you build a custom profile step by step: pick stages, assign agent types (single / consilium / bash / none), select roles, and auto-generates stage transitions.

CLI Reference

harnest install                                          Install framework
harnest init [dir] [--harness ] [--non-interactive]  Generate project config
harnest detect [dir]                                     Show detected stack
harnest profiles list|add|edit|remove [name]             Manage profiles
harnest agents list [dir]                                View agent mappings
harnest agents set   [--dir ]         Override agent for role
harnest convert --from  --to  [dir]    Convert between formats
harnest update                                           Check for mapping updates
harnest version                                          Show version

Stack Detection

Harnest auto-detects 92 stacks across 30+ languages by scanning build files and dependency manifests. All detectors scan every first-level subdirectory — non-standard folder names like springApp/ or webApp/ work out of the box.

Backend

StackLanguageDetection signal
spring-bootKotlinbuild.gradle.kts with spring-boot/springframework
ktorKotlinbuild.gradle.kts with io.ktor
quarkusKotlin/Javabuild.gradle.kts / pom.xml with quarkus
micronautKotlin/Javabuild.gradle.kts / pom.xml with micronaut
spring-boot-javaJavapom.xml / build.gradle with spring-boot
vaporSwiftPackage.swift with vapor
swift-packageSwiftPackage.swift
nodeTypeScriptpackage.json with express/fastify/nestjs/koa/hono
denoTypeScriptdeno.json / deno.jsonc
bunTypeScriptbunfig.toml
strapiTypeScriptpackage.json with @strapi/strapi
fastapiPythonpyproject.toml / requirements.txt with fastapi
djangoPythonpyproject.toml / requirements.txt with django
flaskPythonpyproject.toml / requirements.txt with flask
starlettePythonpyproject.toml / requirements.txt with starlette
pyramidPythonpyproject.toml / requirements.txt with pyramid
litestarPythonpyproject.toml / requirements.txt with litestar
goGogo.mod
ginGogo.mod with gin-gonic/gin
fiberGogo.mod with gofiber/fiber
echoGogo.mod with labstack/echo
chiGogo.mod with go-chi/chi
rustRustCargo.toml
axumRustCargo.toml with axum
actixRustCargo.toml with actix-web
rocketRustCargo.toml with rocket
railsRubyGemfile with rails
sinatraRubyGemfile with sinatra
laravelPHPcomposer.json with laravel/framework
symfonyPHPcomposer.json with symfony/framework-bundle
wordpressPHPwp-config.php / wp-content/
dotnetC#*.csproj / *.sln
phoenixElixirmix.exs with phoenix
elixirElixirmix.exs
erlangErlangrebar.config
scala / play / akkaScalabuild.sbt
clojureClojuredeps.edn / project.clj
grailsGroovybuild.gradle with grails
haskellHaskellstack.yaml / *.cabal
ocamlOCamldune-project
cCCMakeLists.txt (C project) / Makefile with gcc
cppC++CMakeLists.txt (CXX) / meson.build / Makefile with g++
zigZigbuild.zig
nimNim*.nimble
vlangVv.mod
crystalCrystalshard.yml
gleamGleamgleam.toml
luaLua*.rockspec / .luacheckrc
perlPerlcpanfile / Makefile.PL

Frontend

StackLanguageDetection signal
vueTypeScriptpackage.json with "vue" (excl. nuxt)
nuxtTypeScriptpackage.json with "nuxt"
reactTypeScriptpackage.json with "react" (excl. next/remix/expo/RN)
nextjsTypeScriptpackage.json with "next"
gatsbyTypeScriptpackage.json with "gatsby"
remixTypeScriptpackage.json with "@remix-run/react"
angularTypeScriptangular.json
svelteTypeScriptpackage.json with "svelte" (excl. sveltekit)
sveltekitTypeScriptpackage.json with "@sveltejs/kit"
solidTypeScriptpackage.json with "solid-js"
qwikTypeScriptpackage.json with "@builder.io/qwik"
astroTypeScriptpackage.json with "astro"
emberTypeScriptpackage.json with "ember-cli"
eleventyTypeScriptpackage.json with "@11ty/eleventy"
hugoGohugo.toml / config.toml with baseURL
jekyllRubyGemfile with jekyll

Mobile

StackLanguageDetection signal
compose-multiplatformKotlincomposeApp/ directory
androidKotlinapp/build.gradle.kts (no composeApp)
ios-nativeSwiftiosApp/ or *.xcodeproj
flutterDartpubspec.yaml
expoTypeScriptpackage.json with "expo"
react-nativeTypeScriptpackage.json with "react-native" (excl. expo)
ionicTypeScriptpackage.json with "@ionic/*"
capacitorTypeScriptpackage.json with "@capacitor/core"
mauiC#*.csproj with Maui

Desktop

StackLanguageDetection signal
electronTypeScriptpackage.json with "electron"
tauriRustCargo.toml with tauri / tauri.conf.json

Data / Scientific

StackLanguageDetection signal
streamlitPythonrequirements.txt with streamlit
gradioPythonrequirements.txt with gradio
jupyterPython*.ipynb files in root
juliaJuliaProject.toml with uuid
rRDESCRIPTION with Type / *.Rproj

Infrastructure

StackLanguageDetection signal
dockerDockerfileDockerfile / docker-compose.yml / compose.yaml
terraformHCL*.tf files
helmYAMLChart.yaml
pulumiYAMLPulumi.yaml
ansibleYAMLansible.cfg / playbook.yml / roles/
github-actionsYAML.github/workflows/

Multi-stack projects are fully supported — each detected stack gets its own exec agent scope with the correct directory path.

Agent Discovery

The wizard scans installed agents from multiple sources:

  • Harness agent dirs: ~/.claude/agents/, ~/.cursor/agents/, ~/.windsurf/agents/, ~/.codex/agents/, ~/.config/opencode/agents/, ~/.qwen/agents/
  • Plugins: ~/.claude/plugins/cache/*/plugin.json — scans /agents/*.md directory (primary) and explicit agents field in plugin.json (backward compat). Agents are namespaced as plugin-name:agent-name.
  • Project agents (0.12.0+): /.claude/agents/*.md, /.cursor/agents/*.md, /.windsurf/agents/*.md, etc. — all registered harness agent dirs. YAML frontmatter with name: field, falls back to filename. Project agents take priority over global agents with the same name.

Search with ? in the wizard to filter by substring.

Package

Workflow profiles

Installed to ~/.claude/profiles/. Each profile defines stages and roles — no hardcoded agents.

ProfileStages
business-featureResearch → Plan → Executing → Validation → Report
bug-huntingReproduce → Diagnose → Fix → Validation → Report
researchConsilium investigation, no code changes
refactoringAudit → Plan → Executing → Regression check
e2e-testingPrepare → Deploy → Run → Fix → Re-run → Report
e2e-authoringResearch → Propose → Approve → Save scenarios

Consilium roles

9 roles available for agent assignment during harnest init:

RolePurpose
architectArchitecture, modules, dependencies, SOLID
frontendUI/UX review, frontend patterns
uiVisual design, UX, components
securityOWASP, vulnerabilities, auth
devopsInfrastructure, CI/CD, deployment
apiAPI contracts, REST/GraphQL
diagnosticsLogs, stacktraces, debugging
testTest coverage, quality
mobileMobile platforms, cross-platform

Harness output formats

HarnessOutput FileFeatures
Claude CodeCLAUDE.mdFull consilium + exec scope + profiles
Cursor.cursorrulesExpert roles + file ownership
Windsurf.windsurfrulesStack context + code areas
CodexAGENTS.mdExpert perspectives + file ownership
OpenCodeopencode.jsonSubagent declarations + agent files
Qwen CodeQWEN.mdExpert perspectives + file ownership

License

This software is licensed under CC BY-NC 4.0 — free for non-commercial use. For commercial licensing, contact the author.