What is ls-ssh-mcp CLAUDE.md?

A set of instructions for the ls-ssh-mcp project, which provides SSH terminal access and testing guidance. It documents a fix for duplicated terminal output and the Villenele terminal-history testing framework.

Use it when working on ls-ssh-mcp, especially when investigating duplicated or incorrectly formatted SSH terminal output or running Villenele tests.

It gives the coding agent project-specific context for diagnosing terminal output issues and understanding the expected tests.

How kkoshix/ls-ssh-mcp configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to kkoshix/ls-ssh-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/kkoshix/ls-ssh-mcp/master/CLAUDE.md

Clone the repo

git clone --depth 1 https://github.com/kkoshix/ls-ssh-mcp

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/kkoshix/ls-ssh-mcp/claude-md/github.svg)](https://agentmods.dev/instructions/kkoshix/ls-ssh-mcp/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/kkoshix/ls-ssh-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/kkoshix/ls-ssh-mcp/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/kkoshix/ls-ssh-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/kkoshix/ls-ssh-mcp/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 4,027 This file is loaded in full into every session.

When invoked 4,027 The same file — it is already loaded in full.

Security scan C 2 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin 100% copy Near-identical to another mod in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.04027	$0.04027
Opus 5.5	$0.01611	$0.01611
Sonnet 5.5	$0.00805	$0.00805
Haiku 4.5	$0.00403	$0.00403

Measured 2mo ago against content hash 1e63476d49ee, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade C, and why

ls-ssh-mcp CLAUDE.md scanned grade C with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reaches for credential fileshighPrivilege escalation

SSH keys, cloud credentials, git-credentials, .npmrc, /etc/shadow: reading these is how a config file becomes a credential leak.

'ssh_connect {"name": "test-session", "host": "localhost", "username": "jsbattig", "keyFilePath": "~/.ssh/id_ed25519"}',

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

1. **Verify HTML loads**: `curl -s [MCP_URL] | head -20`

Origin

This is a copy

100% identical to ssh-mcp CLAUDE.md — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

CLAUDE.md · 392 lines

How it starts

The opening of the file, as written. The whole thing — 392 lines — stays where its author put it; the contents beside it link to each section on GitHub.

LS-SSH-MCP Project Documentation

Terminal Echo Duplication Fix (v2.0.1)

Issue Resolution

Problem: Terminal commands showed duplicate output with different formatting - clean output followed by mangled output without ANSI colors.

Root Cause: Dual broadcast architecture in ssh-connection-manager.ts where SSH stream data was processed through two different paths:

Raw SSH stream (preserved ANSI colors and formatting)
Processed stream through prepareOutputForBrowser() (stripped ANSI codes, mangled spacing)

Solution: Modified broadcastToLiveListeners() method to conditionally process data based on source type:

SSH stream data (source === 'system') bypasses prepareOutputForBrowser()
Non-SSH data continues processing for necessary cleanup
Implementation at ssh-connection-manager.ts:205

Result: Single clean terminal output with preserved ANSI colors and formatting. xterm.js handles ANSI codes natively, eliminating need for server-side processing of SSH streams.

Validation: All Villenele testing framework tests passing with exact assertions. Terminal behavior now matches standard SSH client experience.

Villenele - Terminal History Testing Framework

Framework Name: Villenele

Villenele is the official name for our comprehensive Terminal History Testing Framework. When referenced by name, "Villenele" refers to the complete 9-story epic testing infrastructure designed specifically for SSH terminal emulation validation.

Purpose and Overview

The Terminal History Testing Framework is a comprehensive testing infrastructure designed to validate SSH terminal emulation and WebSocket-based browser terminal display. It addresses the critical challenge of testing terminal history formatting, command echo behavior, and real-time terminal interactions in a browser environment.

Core Problem Solved

The framework specifically solves issues with terminal prompt concatenation and display formatting that occurred when browsers connected to SSH sessions. Original problems included:

Read the full file on GitHub · 392 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 392 lines · 4,027 tokens per session scan C 1e63476d49ee

Subscribe to this mod's changes

ls-ssh-mcp CLAUDE.md is an instructions file published in the GitHub repository kkoshix/ls-ssh-mcp (0 stars, last pushed 3mo ago), licensed MIT. It adds 4,027 tokens to every session, about $0.0161 per session on Opus 5.5. A static security scan graded it C with 2 findings (reaches for credential files, makes network calls). It is 100% identical to ssh-mcp CLAUDE.md, differing in 0 lines, and is treated as a copy.

ls-ssh-mcp CLAUDE.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
ls-ssh-mcp CLAUDE.mdkkoshix/ls-ssh-mcp	Instructions file	0	3mo ago	MIT	C	4,027	Claude Code
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	today	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	today	MIT	A	7,461	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	today	MIT	A	5,685	GitHub Copilot
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	today	MIT	A	4,680	Codex, OpenCode
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	279k	yesterday	MIT	A	4,325	Codex, OpenCode
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	today	MIT	A	3,086	GitHub Copilot

ls-ssh-mcp: Instructions file for Claude Code