What it does
Turn-0 workspace grounding, spin-loop blocker, and defect-only stop gate for AI coding agents.
- Connects 내 컴퓨터에서 실행
- Account or key No key needed
- Category 개발자 도구
함께 쓰기
이런 작업을 AI에게 가르치는 Skill, 이것과 함께 쓸 수 있습니다
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
graphify
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
이 순위인 이유
목록은 사용 점수(100점 만점)로 정렬되며 구성은 다음과 같습니다
| 인기 | 0/80 | GitHub 별 또는 주간 다운로드: 큰 쪽 60, 작은 쪽 20 |
|---|---|---|
| 최신성 | 12/12 | 30일 안에 릴리스나 코드 변경이 있으면 만점 |
| 응답 중 | 0/8 | 마지막 점검 때 클라우드 엔드포인트가 응답 |
| 사용 점수 | 12/100 |
품질: 기본 점검 3/3개 통과(표시만, 정렬에는 안 씀) · 상승세: 데이터 없음 (급상승 탭에서만 사용)
설치
쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.
한 문장으로 AI에게 설치 맡기기
Krusch Grounded Harness 설치해 줘. https://mcp.popnx.com/i/krusch-grounded-harness.md 를 따라 하고, 명령을 먼저 보여 주고 내가 승인하면 실행해.내 컴퓨터에서 작업하는 AI(Claude Code, Cursor 등)에 붙여 넣으세요. 단계를 읽고 명령을 보여 준 뒤 승인을 기다립니다. 키도 가입도 필요 없습니다. · AI가 읽을 전체 내용 보기
검사 3/3 통과 · 내 컴퓨터에서 실행돼요 · ✓ 명령 확인 2026년 11월 19일
먼저: 어떤 AI를 쓰시나요?
쓰는 앱을 고르면 아래에 단계가 나옵니다.
Claude에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만) · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요
AI에게 설치 맡기기
이 메시지를 Claude 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Claude에 MCP server Krusch Grounded Harness을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "mcpServers": { "grounded-harness": { "command": "npx", "args": [ "-y", "krusch-grounded-harness", "mcp" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 Krusch Grounded Harness의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Node.js 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -v- 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다:
node -v한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
컴퓨터용 Claude 앱 설정 파일 열기
SettingsDeveloperEdit Config
이 설정을 붙여 넣고 저장
{ "mcpServers": { "grounded-harness": { "command": "npx", "args": [ "-y", "krusch-grounded-harness", "mcp" ] } } }Claude를 끄고 다시 열기
해 보기
Krusch Grounded Harness을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude가 Krusch Grounded Harness을 쓰고 있다고 하거나 답에 Krusch Grounded Harness 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
ChatGPT는 아직 Krusch Grounded Harness에 연결할 수 없어요
Krusch Grounded Harness는 내 컴퓨터에 설치해서 쓰지만 ChatGPT는 웹에서 도는 서버만 연결할 수 있어요
대신 이렇게 할 수 있어요
A · Krusch Grounded Harness에 연결되는 앱 쓰기
- 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만) · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요
- 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
- 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
- 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
B · 개발자 도구에서 ChatGPT에 연결되는 다른 서버
같은 분류에서 많이 쓰는 것 중 키 없이 주소만으로 연결되는 것을 골랐어요
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Claude Code에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
AI에게 설치 맡기기
이 메시지를 Claude Code 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Claude Code에 MCP server Krusch Grounded Harness을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): claude mcp add --scope user grounded-harness -- npx -y krusch-grounded-harness mcp 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 Krusch Grounded Harness의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Node.js 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -v- 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다:
node -v한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
터미널 열기
Mac: Command+스페이스를 누르고 Terminal 입력 · Windows: PowerShell 열기
이 명령을 붙여 넣고 Enter
claude mcp add --scope user grounded-harness -- npx -y krusch-grounded-harness mcpClaude Code에서 /mcp 입력
Krusch Grounded Harness이 목록에 있고 연결됨으로 보이면 돼요
해 보기
Krusch Grounded Harness을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude Code가 Krusch Grounded Harness을 쓰고 있다고 하거나 답에 Krusch Grounded Harness 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
Cursor에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
AI에게 설치 맡기기
이 메시지를 Cursor 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Cursor에 MCP server Krusch Grounded Harness을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "mcpServers": { "grounded-harness": { "command": "npx", "args": [ "-y", "krusch-grounded-harness", "mcp" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 Krusch Grounded Harness의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Node.js 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -v- 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다:
node -v한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
Cursor에서 AI 채팅을 Agent 모드로 열기
해 보기
Krusch Grounded Harness을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Cursor가 Krusch Grounded Harness을 쓰고 있다고 하거나 답에 Krusch Grounded Harness 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Cursor 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
VS Code에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
AI에게 설치 맡기기
이 메시지를 VS Code 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 VS Code에 MCP server Krusch Grounded Harness을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "servers": { "grounded-harness": { "type": "stdio", "command": "npx", "args": [ "-y", "krusch-grounded-harness", "mcp" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 Krusch Grounded Harness의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Node.js 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -v- 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다:
node -v한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
VS Code에서 AI 채팅을 Agent 모드로 열기
해 보기
Krusch Grounded Harness을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ VS Code가 Krusch Grounded Harness을 쓰고 있다고 하거나 답에 Krusch Grounded Harness 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
개발자용: 터미널 명령과 JSON 설정
컴퓨터에 설치
Claude Code
claude mcp add --scope user grounded-harness -- npx -y krusch-grounded-harness mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"grounded-harness": {
"command": "npx",
"args": [
"-y",
"krusch-grounded-harness",
"mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"grounded-harness": {
"command": "npx",
"args": [
"-y",
"krusch-grounded-harness",
"mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"grounded-harness": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"krusch-grounded-harness",
"mcp"
]
}
}
}이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.
한눈에 보기
어떤 앱에서 쓸 수 있나요
이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.
내 컴퓨터에서 실행하는 앱
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
할 수 있는 일
내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.
기본 점검i
누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 19일 점검
- ✓ 통과
제작자와 저장소 일치
레지스트리 이름이 도메인 krusch.dev 기준으로 확인되었어요(레지스트리가 도메인 소유를 확인해요)
- ✓ 통과
계속 관리되고 있음
코드 마지막 변경: 오늘
- ✓ 통과
라이선스 있음
MIT 사용
- – 해당 없음
엔드포인트 응답
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
- – 해당 없음
OAuth로 로그인
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
- … 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요
공개된 취약점 (OSV.dev)
OSV.dev에 krusch-grounded-harness@0.2.1 항목이 없습니다
이 버전의 패키지 자체만 확인하며 모든 의존성은 아닙니다 · 확인 2026년 11월 19일
제작자: 재확인 요청 또는 잘못된 정보 신고
제작자용: README에 배지 달기
제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.
[](https://mcp.popnx.com/en/servers/krusch-grounded-harness)토론
질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.
사용자 리뷰
아직 리뷰가 없어요
개발자 도구 카테고리의 다른 서버와 비교i
- 이 카테고리의 다른 서버 6116개 중 0%보다 스타가 많아요
- 이 카테고리의 다른 서버 6116개 중 99%보다 최근에 레지스트리에 공개됐어요
- 기본 점검 결과가 이 카테고리의 다른 서버 6116개 중 99%와 같거나 더 좋아요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
자주 묻는 질문
Krusch Grounded Harness, 안전한가요?
해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
어떤 키나 코드가 필요한가요?
레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.
내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?
내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).
아직 관리되고 있나요?
GitHub 저장소는 마지막으로 오늘 변경됐고, 최신 버전(0.2.1)은 오늘 레지스트리에 올라왔어요.
어떤 앱에서 쓸 수 있나요?
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Node.js도 있어야 해요.
대신 쓸 수 있는 건 뭐가 있나요?
같은 카테고리에는: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
비슷하게 동작하는 다른 것
같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.
카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| 이 항목 Krusch Grounded Harness | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| 실행 위치 | 컴퓨터에 설치 필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드 또는 컴퓨터 설치 모두 가능 |
| 키 필요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 |
| Claude에서 +로 추가 | 아니요 | 아니요 | 아니요 | 예 | 아니요 | 아니요 |
| 기본 점검 | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| 라이선스 | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| 가격 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 |
제작자의 README
README 열기
제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.
Krusch Grounded Harness (krusch-grounded-harness v0.2.0)
Standalone Turn-0 workspace grounder, duplicate-call spin-loop blocker, and zero-turn defect-only output gate for AI coding and data agents. Runs 100% locally on Node 22 `node:sqlite` (`7` MCP tools + HTTP `:3782` gateway + ESM library) with zero cloud calls.
Turn-0 Grounded, Scale-Aware, Low-Tool-Call Agent Harness (HTTP :3782 Control Gateway + 7-tool stdio MCP Server + Node 22 ESM library) built on @krusch/toolkit (v1.8.1).
⚡ 30-Second Standalone Quickstart (Zero Cloud, Zero Docker)
1. Clone, Test & Ground Any Workspace Locally
Requires only Node.js `>= 22.0.0` (uses built-in node:sqlite in WAL mode with zero Docker containers, zero native C++ compilation, and zero API keys):
git clone https://github.com/kruschdev/grounded-harness.git
cd grounded-harness npm ci npm test
Verify SQLite WAL engine, 7 annotated MCP tools, and v0.2.0 invariants
node bin/krusch-grounded-harness.js doctor
Compile Turn-0 workspace schemas, dataset hazard flags & Raw-RAG chunks (0 LLM calls)
node bin/krusch-grounded-harness.js ground --dir . --goal "Inspect workspace schemas and hazards"
2. Connect to Your Agent (.mcp.json / Cursor) or Run via krusch-stack
Paste into your project .mcp.json, Cursor (~/.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcp_config.json), or Antigravity (~/.gemini/antigravity/mcp_config.json):
{
"mcpServers": { "krusch-grounded-harness": { "command": "node", "args": ["/absolute/path/to/grounded-harness/bin/krusch-grounded-harness.js", "mcp"] } } }
Prefer a zero-clone npx command or single-package ESM import? Run the bundled engine directly through krusch-stack:
# Start the 7-tool stdio MCP server without cloning a separate repo
npx -y krusch-stack mcp --server krusch-grounded-harness
// Embed via krusch-stack (zero external runtime dependencies) or standalone package
import { createGroundedHarnessEngine } from 'krusch-stack/grounded-harness'; // Standalone repo import: import { createGroundedHarness } from 'krusch-grounded-harness';
🩹 Before vs. After (What It Fixes)
| Common Agent Failure Mode | Without krusch-grounded-harness | With krusch-grounded-harness ($0.00, 0 Cloud Calls) |
|---|---|---|
| Blind file foraging & CSV `"NA"` = North America `NaN` corruption | Wastes 60%–75% of turns running ls/head/cat and silently drops "NA" country codes as NaN or misreads JSON null vs. [] wildcards. | compileTurnZeroGrounding introspects RFC-4180 CSV/TSV, JSON/JSONL, read-only SQLite DDL, code symbols, and 256/32-tok Raw-RAG docs before Step 1, flagging keep_default_na=False and null/[] hazards automatically. |
| Identical failing or redundant tool-call spin loops | Re-runs the same broken query or file read with tweaked comments/whitespace, burning context and API budget. | normalizeCodeSnippetForHash strips comments outside strings (preserving Python // floor division) to serve MEMOIZED_PRIOR_READ on repeats and BLOCK_SPIN_LOOP (0 wasted re-executions) on repeat failures while keeping maxReadStreak = 0 for distinct reads. |
| Raw `np.float64(...)` / ` ` leaks or self-doubt nudges | Leaks raw np.float64(...), pandas dtype:, XML, or NaN into final answers, or loses accuracy from unconditional "are you sure?" stop-nudges. | inspectOutputDefects approves clean answers in `0` extra turns and triggers a single targeted repair (maxDefectRetries = 1) strictly on objective output defects. |
🧩 Ecosystem Fit (Use Standalone or Combined)
krusch-grounded-harness has zero runtime service dependencies and works standalone out of the box, or pairs cleanly with sibling tools when you want deeper state guarantees:
- [`krusch-context-mcp`](https://github.com/kruschdev/krusch-context-mcp) (Persistent Working Memory): Pair Turn-0 workspace grounding with cross-session episodic memory, decision lineage, and pre-commit invariant nudges (
5MCP tools onnode:sqlite). - [`krusch-coding-harness`](https://github.com/kruschdev/krusch-coding-harness) (2PC Staged File Diffs): Add content-addressed diff staging, Bubblewrap sandbox verification, and
SIGKILL-recoverable write-ahead disk apply for unattended background daemons. - [`krusch-stack`](https://github.com/kruschdev/krusch-stack) (Unified One-Command Bundle): Run Turn-0 grounding alongside memory, Git/AST symbol graphs, and staged execution via
npx -y krusch-stack init(supports--server krusch-grounded-harness,--components grounded-harness, and--profile coding-agent).
⚡ Overview & Six Empirical Design Laws (INV-GH-01..10)
Distilled from 16,800 Official DolphinBench traces (28 official 600-task multi-session tool runs across 6 model families: 17 $0.00 open-weights + 11 frontier/model-matched runs, 98.33% Oracle@28, 83.17% $0.00 Oracle@17), 120 DABstep multi-step analytics episodes, BEAM (100K–10M tokens), and BFCL v3 (64 live tools), krusch-grounded-harness replaces unconditional outer-loop 2PC stop-nudging with six zero-overhead-when-healthy structural laws:
- Turn-0 Schema + `Raw-RAG` Briefing with Dataset Hazard Flags (`INV-GH-01`, `INV-GH-02`)
compileTurnZeroGroundingintrospects RFC-4180 CSV/TSV columns, JSON/JSONL object arrays, read-only SQLite DDL & row counts, code symbols, and256/32-tokenRaw-RAGdocumentation chunks with `0` LLM ingestion calls, paired with Okapi BM25 tool deferral (-70%to-80%schema tokens) and SHA-256prefixHashKV-cache normalization.- Explicitly flags CSV `"NA"` string literals (
keep_default_na=Falseinpandas.read_csv) and JSON `null` vs. empty-list `[]` wildcards before Step 1 (skipping.env/ secret files automatically).
- Gemini Tool-Less `functionCallingConfig: { mode: "NONE" }` Guard (`INV-GH-09`)
buildSafeGeminiToolConfig(andbuildGeminiPayloadin@krusch/toolkit/llm) automatically injectstoolConfig: { functionCallingConfig: { mode: 'NONE' } }whenevertoolsis omitted or empty[], eliminatingMALFORMED_FUNCTION_CALLempty turns on markdown```pycode blocks.
- **Zero-Turn *Defect-Only* Output Gate (
inspectOutputDefects,INV-GH-05)**
- Approves clean completions in `0` extra turns while blocking objective output defects (
maxDefectRetries = 1): EMPTY_OR_NULL_BAILOUT: literal"",None,null,NaN,[],{}when an answer is expected (never blocking"0",0,false,"Not Applicable", or"N/A").TRUNCATED_OUTPUT:finishReasoninMAX_TOKENS/length/MALFORMED_FUNCTION_CALLor truncated tool JSON.SERIALIZED_TOOL_CALL_IN_TEXT: raw{...}orcall:fn{...}emitted in prose whentoolCalls.length === 0.RAW_DATAFRAME_OR_NUMPY_REPR: unformattednp.float64(...)or pandasdtype:repr leaks in final answers.
- Quote-Safe Comment-Normalized Call Hashing (`BLOCK_SPIN_LOOP`) & `maxReadStreak = 0` (`INV-GH-04`)
normalizeCodeSnippetForHashstrips comments outside string literals (preserving Python//floor division and indentation) prior to SHA-256 hashing. First repeats ofCOMMITTEDreads returnMEMOIZED_PRIOR_READwith cached preview; repeat identicalFAILEDcalls or repeats afterMEMOIZED_PRIOR_READreturnBLOCK_SPIN_LOOPwith0tool re-executions. Distinct multi-step reads (1..N) are never throttled (maxReadStreak === 0).
- Scale-Aware Thinking Curve & Staged-Diff-Only `FORCE_VERIFY` (`INV-GH-03`, `INV-GH-05`)
SMALL_MODEL(< 15Bnon-thinking) receives compact[PLAN -> BIND -> ACT]guidance plus placeholder ({{var}}) and invalid-calendar-date soft-holds (HOLD);MID_MODEL(15B–70B) andFRONTIER_REASONING(>= 70Bor native thinking) execute with0outer thinking overhead.FORCE_VERIFYfires strictly when `pendingDiffsCount > 0 && !latestVerificationPassed`, never on read-only analytics or policy abstentions.
- Partial `stdout` Preservation on Sandbox Timeouts (`INV-GH-10`)
execCommandWithPartialStdoutandformatTimeoutWithPartialStdoutpreserve partialstdoutemitted prior to timeout alongsideTimeoutErrorwhile clearing stalefinalAnswer: null(hasFinalAnswer: false).
📊 Empirical Benchmark Results (4,200 Grounded / 16,800 Total Official DolphinBench Traces & 120 Adyen DABstep Episodes)
1. Official DolphinBench Multi-App Suite (7 × 600 = 4,200 Grounded Traces Within 28 Runs / 16,800 openai/gpt-5.6-sol Traces, 0o444 Frozen SQLite, 5/5 Clean-Room Gates)
Model & Scale Tier (N = 600 Tasks/Run) | Standard Harness | + Grounded Harness (v0.2.0 / v0.3) | Key Latency, Persona & Telemetry Outcomes | Archive SHA-256 |
|---|---|---|---|---|
| `Google Gemini 4 Argon` (`FRONTIER_REASONING`, Low, `v0.3`, `$24.54` / `$30.54`) | `91.17%` (`547/600`, uploaded `dolphinbench.ai` submission `UUID c047b063`, `status: "queued"` awaiting leaderboard acceptance; exceeds current `70.67%` published leaderboard entry in independent `600/600` evaluation) | `90.67%` (`544/600`, self-run clean-room evaluation; highest `Riley` slice `181/200 = 90.50%`, published SHA-256 audit logs) | `+1.50 pp` (`+9` tasks: `+28W / -19L`) over `Grounded v0.2` (statistically tied w/ Std., exact McNemar $p = 0.766$ NS) · `Morgan 94.5%` (`189`), `Alex 87.0%` (`174`), `Riley 90.5%` (`181`, first-ever `90%+` on `Riley`) · 192/600 (32.0%) zero-turn live-state delta hydrations, 80/600 deep 4–8 memory-search tasks, 7,994 passive duplicates suppressed · `+21` unique wins vs. `Std.` (`Argon Low Oracle@2 = 94.67%` [`568/600`], `Argon Low Oracle@3 = 95.83%` [`575/600`], `Argon Oracle@4 = 96.83%` [`581/600`]) | 665fb7ad5a042eeb943f15a875b3be1a06f7d1aa26e21842a69fb597d1939ba7 |
| [`krush420/gemma4-31b-sre-lora`](https://huggingface.co/krush420/gemma4-31b-sre-lora) (`Wave-6 QLoRA+DPO`, `MID_MODEL`, Thinking ON, `$0.00`) | 54.83% (329/600 *Wave-5*) / 54.17% (325/600 *Stock*, uploaded & queued UUID 288671ad) | `57.33%` (`344/600`, highest open-weights score in self-run 28-run evaluation) | `+3.17 pp` (`+19` tasks) over `54.17%` Stock (+0.67 pp / +4 tasks over 56.67% Stock + Grounded) · Morgan 74.5% (149), Alex 51.5% (103), Riley 46.0% (92) · 50.81s median · Beats all 8 non-Luna cloud stacks up to $1,830.57 (Grounded Oracle@2 = 65.33% [392/600], `Gemma 4 Oracle@6 = 71.83%` [`431/600`, +1.16 pp > published 70.67% Mem0 entry]) | b7a26ef96ae99a93042ba2270ed5cae4094850f4cb789c782143e145a2eb069e |
| `Google Gemma 4 31B Dense Stock` (`MID_MODEL`, Thinking ON, `$0.00`) | 54.17% (325/600, uploaded & queued UUID 288671ad) | `56.67%` (`340/600`, clean-room stock + Grounded) | `+2.50 pp` (`+15` net tasks) · Lifts every persona (Morgan 73.0% [146], Alex 48.5% [97], `Riley 48.5%` [`97`, `+5.50 pp`]