TheTechromancer

## AGENTS.md

      
              1 file
            
          
              0 forks
            
          
                0 comments
              
            
              1 star
            
          
                TheTechromancer
                / AGENTS.md
            
            
              Last active
              May 9, 2026 16:22
            
              
                A battle-tested AGENTS.md for higher quality code output. Helps avoid "AI slop creep" by keeping your codebase lean and clean.
              
          
    Engineering Principles

Universal principles for building solid codebases. Language- and domain-agnostic.
Modularity: code lives in the thing it's about

Module-specific code lives in the module — and nowhere else. When adding a new variant to a system, it should be a single new file containing everything: type, implementation, registration, helpers, constants. No central dispatcher with a match arm to update. No hand-maintained registry list. No constants table to extend.
Prefer auto-discovery (build-time scanning, decorator-based registration, plugin loading) over manual lists. Adding a new variant should touch exactly one file.

  
## prevent_vpn_lockout_ssh.sh
echo <<EOF > /etc/systemd/system/vpn-bypass.service
[Unit]
Description=VPN Bypass for SSH and UDP ports 60000-61000
After=network.target

[Service]
Type=oneshot
# ExecStart=/bin/sh -c 'grep -q "200 vpnbypass" /etc/iproute2/rt_tables || echo "200 vpnbypass" >> /etc/iproute2/rt_tables'
# ExecStart=/bin/sh -c 'ip rule del fwmark 0xca6c lookup 200 priority 100 2>/dev/null || true'
# ExecStart=/bin/sh -c 'ip route add unreachable default metric 4278198272 table 200 2>/dev/null || true'

## python_attach_howto.md

      
              1 file
            
          
              0 forks
            
          
                0 comments
              
            
              1 star
            
          
                TheTechromancer
                / python_attach_howto.md
            
            
              Last active
              February 11, 2025 16:03
            
              
                Attach to a running python process and explore its state - useful for troubleshooting deadlocks, memory leaks, etc.
              
          
    Attach to PID with GDB

Prerequisites


If running inside docker, make sure to execute docker exec with --privileged
Install remote_pdb

pip install remote_pdb

  
## clean_dns_records.py
#!/usr/bin/env python3

import sys
import asyncio

from bbot.scanner import Scanner

try:
    file = sys.argv[-1]
except KeyError:

## clean_dns_records.py
#!/usr/bin/env python3

import sys
import string
import random
import dns.resolver
import threading
import tldextract
import concurrent.futures

## top_subdomain_mutations.txt
# top subdomain append/prepends
# derived from top 1 million subdomains: https://github.com/bitquark/dnspop

401055	{}
8350	{}2
8035	{}1
4012	{}3
2766	{}4
2585	{}01
2183	{}5

## kill_detached_mosh_sessions.sh
kill $(last -f /var/run/utmp | egrep -o 'mosh \[[0-9]+\]' | egrep -o '[0-9]+')

## session_logging.sh
# default tmux config
cat <<EOF > "$HOME/.tmux.conf"
set -g mouse on
set -g history-limit 50000

# List of plugins
set -g @plugin 'tmux-plugins/tmux-logging'

# Initialize TMUX plugin manager (keep this line at the very bottom of tmux.conf)
run '~/.tmux/plugins/tpm/tpm'

## dhcp_option_121.py
#!/usr/bin/env python3

from ipaddress import *

routes = [
    # destination       # router
    ('10.0.0.0/24',     '172.16.0.2'),
    ('0.0.0.0/0',       '172.16.0.1')
]
	echo <<EOF > /etc/systemd/system/vpn-bypass.service
	[Unit]
	Description=VPN Bypass for SSH and UDP ports 60000-61000
	After=network.target

	[Service]
	Type=oneshot
	# ExecStart=/bin/sh -c 'grep -q "200 vpnbypass" /etc/iproute2/rt_tables \|\| echo "200 vpnbypass" >> /etc/iproute2/rt_tables'
	# ExecStart=/bin/sh -c 'ip rule del fwmark 0xca6c lookup 200 priority 100 2>/dev/null \|\| true'
	# ExecStart=/bin/sh -c 'ip route add unreachable default metric 4278198272 table 200 2>/dev/null \|\| true'
	#!/usr/bin/env python3

	import sys
	import asyncio

	from bbot.scanner import Scanner

	try:
	file = sys.argv[-1]
	except KeyError:
	#!/usr/bin/env python3

	import sys
	import string
	import random
	import dns.resolver
	import threading
	import tldextract
	import concurrent.futures
	# top subdomain append/prepends
	# derived from top 1 million subdomains: https://github.com/bitquark/dnspop

	401055 {}
	8350 {}2
	8035 {}1
	4012 {}3
	2766 {}4
	2585 {}01
	2183 {}5
	# default tmux config
	cat <<EOF > "$HOME/.tmux.conf"
	set -g mouse on
	set -g history-limit 50000

	# List of plugins
	set -g @plugin 'tmux-plugins/tmux-logging'

	# Initialize TMUX plugin manager (keep this line at the very bottom of tmux.conf)
	run '~/.tmux/plugins/tpm/tpm'
	#!/usr/bin/env python3

	from ipaddress import *

	routes = [
	# destination # router
	('10.0.0.0/24', '172.16.0.2'),
	('0.0.0.0/0', '172.16.0.1')
	]