grisuno/lazyown/hermes

LazyOwn RedTeam Framework

You are operating the LazyOwn professional red-team framework via its MCP server.

• Repo: the current working directory (the checkout that holds payload.json)
• MCP entry: skills/lazyown_mcp.py (~131 tools)
• Shell: ./run → lazyown.py (724+ commands, 126 aliases)
• State: payload.json (config) + sessions/ (campaign artefacts)

The LazyOwn Soul

Read soul.md at the start of every engagement. It defines the operating philosophy: evidence over assumption, abstraction over mechanics, phase discipline, situational awareness first, the 80/20 rule, document for the next shift, ask the machine when uncertain, professional over theatrical, configuration is code, collaboration is not optional.

Ten hard stops are listed there. No exceptions.

Every Session Starts Here

# 1. Situation report — reads world_model, tasks, objectives, creds, daemon
lazyown_campaign_sitrep()
# 2. Session init — checks scans, pwntomate, phase, objectives
lazyown_session_init()

Do not re-run nmap or pwntomate if `sessions/scan_<rhost>.nmap` already exists.

The Golden Path

# 1. Configure target
lazyown_set_config(key="rhost", value="10.10.11.5")
lazyown_set_config(key="domain", value="target.htb")
# 2. OS detection — TTL ~64 = Linux, ~128 = Windows
lazyown_run_command("ping")
# 3. Full port scan (auto-injects rhost)
lazyown_run_command("lazynmap")
# 4. Parse results into structured state
lazyown_auto_populate(target="10.10.11.5")
lazyown_facts_show(target="10.10.11.5")
# 5. AI-ranked next steps
lazyown_recommend_next()

The One Rule

LazyOwn commands are high-level abstractions that auto-inject values from payload.json. Never write raw tool flags.

# CORRECT — payload.json supplies rhost, wordlist, etc.
lazyown_run_command("lazynmap")
lazyown_run_command("gobuster")
lazyown_run_command("secretsdump")
# WRONG — never do this
nmap -sC -sV -p- 10.10.11.5
gobuster dir -u http://10.10.11.5 -w /usr/share/wordlists/dirbuster.txt

Seven Tools You Need

Three Rules

1. Read `sessions/` before any tool. Use lazyown_list_sessions() and lazyown_read_session_file() to check if results already exist.
2. Identify OS before enumeration. ping first. Never run AD tools against Linux or SSH brute against Windows.
3. Use abstract commands. Never write raw flags when a LazyOwn alias exists.

Progressive Documentation

Branching Model

LazyOwn uses three branches. As an autonomous agent, you operate on dev.

Rules

• Start every session on dev (git checkout dev).
• Never commit directly to main or pp.
• Feature branches: feature/<description> cut from dev.
• Hotfix branches: hotfix/<description> cut from main, then back-merge to pp and dev.
• When asked to release, create a PR and request human approval.

Setup

# 1. Clone and install
git clone https://github.com/grisuno/LazyOwn.git
cd LazyOwn
bash install.sh
 
# 2. Register MCP server in Hermes
bash scripts/setup_hermes_mcp.sh
 
# 3. Restart Hermes session or run /reload-mcp