Harnest

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](https://github.com/AlexGladkov/harnest/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 tech