Commit Graph

177 Commits

Author SHA1 Message Date
Cal Corum
10f0f6ca03 docs: add Stackmon game setup notes and games directory
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 13:03:31 -06:00
Cal Corum
062f51e85f docs: add tui-testing context and fix MCP config location
Add mcp-tui-driver documentation with tool reference, workflow guide,
and correct MCP config location (~/.claude.json, not ~/.claude/.mcp.json).
Add context loading keyword entry for TUI testing topics.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-01 20:13:37 -06:00
Cal Corum
66d0412250 docs: add tmux as standalone keyword in context loading table
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-01 10:42:48 -06:00
Cal Corum
d798a1309a docs: add tmux config to workstation dotfiles inventory
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-01 10:40:41 -06:00
Cal Corum
0451252cb5 docs: document fish shell functions and tmux aliases in workstation context
Add fish functions/aliases section covering tls, tma, tmn, cc helpers
and config.fish abbreviations. Add fish/tmux keywords to CLAUDE.md
context loading table.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-01 10:05:00 -06:00
Cal Corum
babf062d6a docs: archive headless-claude design docs to legacy/
Original planning folder (no git repo) for the server diagnostics system
that runs on CT 300. Live deployment is on claude-runner; this preserves
the Agent SDK reference, PRD with Phase 2/3 roadmap, and N8N workflow designs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-01 08:15:13 -06:00
Cal Corum
28abde7c9f chore: add recovered CT 302 configs, archive tdarr scripts, clean up repo
- Add recovered LXC 300/302 server-diagnostics configs as reference
  (headless Claude permission patterns, health check client)
- Archive decommissioned tdarr monitoring scripts
- Gitignore rpg-art/ directory
- Delete stray temp files and swarm-test/

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-01 00:41:41 -06:00
Cal Corum
64f9662f25 docs: add scheduled tasks context and systemd timer inventory
Document the new claude-scheduled system in CLAUDE.md keyword table
and add a comprehensive systemd user timers section to workstation
CONTEXT.md covering both cognitive-memory and claude-scheduled timers.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-01 00:36:06 -06:00
Cal Corum
deac021c7b docs: add workstation/dotfiles context and CLAUDE.md keyword entry
New workstation/CONTEXT.md documents the ~/dotfiles symlink repo setup.
Added workstation keywords to context loading table.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-26 23:45:20 -06:00
Cal Corum
5ff94a9d20 docs: remove decommissioned MCP Gateway (CT 303) from monitoring inventory
Migrated MCP servers back to local stdio config, shut down LXC 303.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 12:39:53 -06:00
Cal Corum
df553e5142 docs: add AI infrastructure LXCs (301-303) to monitoring server inventory
Groups Claude Discord Coordinator, Claude Runner, and MCP Gateway
under a shared section. Documents new CT 303 MCP Gateway with n8n
and Gitea MCP server configuration details.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-23 19:58:19 -06:00
Cal Corum
28851a9012 docs: add pihole1, sba-bots, foundry to monitoring server inventory
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-20 14:15:43 -06:00
Cal Corum
3737c7dda5 docs: expand monitoring coverage, update Proxmox upgrade plan, remove decommissioned tdarr scripts
- Update monitoring CONTEXT.md with 6-server inventory table, per-server
  SSH user support, and pre-escalation Discord notification docs
- Remove tdarr local monitoring scripts (decommissioned per prior decision)
- Update Proxmox upgrade plan with Phase 1 completion and Phase 2 prep
- Update vm-management CONTEXT.md with current PVE 8 state
- CLAUDE.md: auto-run /save-memories at 25% context instead of asking

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-20 11:08:48 -06:00
Cal Corum
f20e221090 docs: update monitoring CONTEXT.md with expanded server inventory
Add server table with all 6 monitored hosts, per-server SSH user
docs, updated workflow server list, and pre-escalation Discord
notification documentation.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-20 11:05:40 -06:00
Cal Corum
ed16fee9f7 docs: add CT 302 SSH alias and git auth details to server-diagnostics
Documents the claude-runner SSH alias, HTTPS token auth method,
and notes that SSH git remotes don't work from CT 302.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-20 09:04:33 -06:00
Cal Corum
b75a09e86e Add backup docs and context loading for restic setup
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 07:24:33 -06:00
Cal Corum
43b7440030 Update Gitea docs for shared actions and runner config
- Document DEFAULT_ACTIONS_URL=self and REQUIRE_SIGNIN_VIEW=false
- Correct runner setup: internal URL, config.yaml mount, no .netrc
- Add shared composite actions table (calver, gitea-tag, discord-notify)
- Document action reference rules (short form local, full URL GitHub)
- Add auth troubleshooting entry
- Update reference implementations with all 5 projects
- Replace semver references with CalVer

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 14:09:08 -06:00
Cal Corum
2744630382 Enable pyright-lsp plugin and reformat settings
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 16:12:03 -06:00
Cal Corum
a5d019eb3f Add Vagabond RPG PDFs and STL config change notes
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 10:39:12 -06:00
Cal Corum
0ff1d2211a Add project-local agent template and steam-game-setup skill
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 10:38:11 -06:00
Cal Corum
64a902bbb1 Update gaming docs to match steam-game-setup skill standard
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 10:34:42 -06:00
Cal Corum
beb1ccb376 Add Handy speech-to-text documentation
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 10:11:58 -06:00
Cal Corum
d656f1732e Add docs for CORE.md auto-load via MEMORY.md symlinks
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-16 10:46:02 -06:00
Cal Corum
9c59b07baa Optimize project CLAUDE.md from 105 to 42 lines
- Trim keyword triggers to distinctive terms per topic
- Remove redundant loading convention, directory triggers, priority sections
- Remove documentation structure tree (discoverable from repo)
- Consolidate file extension triggers into special loads
- Shrink maintenance section to just the auto-prompts

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-14 08:17:04 -06:00
Cal Corum
b237d6c056 Optimize CLAUDE.md and fix Gitea Actions Docker cache
CLAUDE.md optimization (329 → 104 lines):
- Compress repetitive loading rules into keyword table
- Remove 72 redundant "Note:" lines (info already in CONTEXT.md files)
- State loading convention once instead of repeating 13 times
- Preserve all functionality, special cases, and maintenance protocol
- 68% reduction in size, easier to scan and maintain

Gitea Actions Docker buildx fix:
- Remove conditional from Docker Hub login step
- Login now runs on all builds (PR and main), not just main
- Fixes "push access denied" on second build when writing cache layers
- Push flag still gates actual image publishing to main-only

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-13 15:14:35 -06:00
Cal Corum
3b2e031f45 Update monitoring docs with Uptime Kuma monitors and Discord alerts
Document all 20 active monitors with targets and tags, Discord
notification configuration, and API access details for programmatic
management via uptime-kuma-api.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 23:02:49 -06:00
Cal Corum
ceb4dd36a0 Add docker scripts, media-tools, VM management, and n8n workflow docs
Add CONTEXT.md for docker and VM management script directories.
Add media-tools documentation with Playwright scraping patterns.
Add Tdarr GPU monitor n8n workflow definition.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 22:26:10 -06:00
Cal Corum
b186107b97 Add Ollama benchmark results and model testing notes
Document local LLM benchmark results, testing methodology, and
model comparison notes for Ollama deployments.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 22:26:04 -06:00
Cal Corum
cbdb7a6bb0 Update Home Assistant platform analysis and env example
Expand home automation platform comparison with 2026 Matter/Thread
status, Hubitat alternative, and detailed implementation plan.
Update HA .env.example template.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 22:25:58 -06:00
Cal Corum
4c9fe64fc3 Add server configs for discord-bots, foundry-lxc, termix, and pihole
Pull Docker Compose configs for discord-bots VM, foundry-lxc LXC, and
termix. Add pihole and orbital-sync compose files for ubuntu-manticore.
Back up LXC 223 (foundry) Proxmox config.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 22:21:17 -06:00
Cal Corum
7d9aae4ac3 Expand gaming scripts documentation with full script catalog
Document all 12 gaming scripts including RON setup, STL log analysis,
Proton testing, mod installation, and backup utilities.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 22:21:11 -06:00
Cal Corum
425bb1abd8 Update OpenClaw documentation with deployment details
Update CONTEXT with npm installation model, Homebrew wrapper setup,
systemd service config, and MiniMax integration. Expand troubleshooting
with gateway, Docker, and Homebrew error scenarios.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 22:21:05 -06:00
Cal Corum
d0dbe86fba Add NVIDIA update checker and monitoring scripts documentation
Add nvidia_update_checker.py for weekly driver update monitoring with
Discord alerts. Add scripts CONTEXT.md and update README.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 22:21:00 -06:00
Cal Corum
0d552a839e Add NVIDIA driver management and media server troubleshooting
Document NVIDIA driver hold/update workflow, GPU health monitoring,
and update checker integration for Jellyfin on ubuntu-manticore.
Add media-servers troubleshooting guide.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 22:20:55 -06:00
Cal Corum
6c8d199359 Add Pi-hole HA documentation and networking updates
Add dual Pi-hole high availability setup guide, deployment notes, and
disk optimization docs. Update NPM + Pi-hole sync script and docs.
Add UniFi DNS firewall troubleshooting and networking scripts CONTEXT.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 22:19:56 -06:00
Cal Corum
a35891b565 Add Uptime Kuma service monitoring on LXC 227
Deploy Uptime Kuma for centralized service uptime monitoring at
https://status.manticorum.com. Proxmox LXC 227 (10.10.0.227) running
Ubuntu 22.04 with Docker. Updated monitoring documentation, CLAUDE.md
context loading rules, and server-configs host inventory.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 22:18:51 -06:00
Cal Corum
201aa9ee32 feat: Add git tagging and remove emojis from Gitea Actions workflows
- Add automatic git tag creation after successful builds/deployments
- Tags match VERSION file and include deployment metadata
- Remove emojis from all Discord notifications and console output
- Add git tag links to Discord success notifications
- Update troubleshooting section with git tag issues
- Add customization checklist for git email configuration

Benefits:
- Immutable version markers in git history
- Easy version checkout and rollback (git checkout v1.2.3)
- Clean, professional notification messages
- Enable changelog generation between tags

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-05 21:41:07 -06:00
cal
744be40ced Merge pull request 'Add Gitea Actions workflow templates and automation' (#1) from gitea-workflow-templates into main
Reviewed-on: #1
2026-02-05 20:00:45 +00:00
Cal Corum
93ea435237 Add Gitea Actions workflow templates and automation
- Add Docker build workflow template with semantic versioning
- Add branch protection automation script
- Add deployment strategies documentation
- Add Harbor registry setup guide
- Update Gitea README with runner troubleshooting
- Add workflow template snippets for auto-deploy

Templates support:
- Semantic version validation on PRs
- Docker build and push to Docker Hub
- Discord notifications (success/failure)
- Build summaries and metadata extraction
- GitHub Actions cache optimization

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-05 13:40:17 -06:00
Cal Corum
2017b56985 Add NPM + Pi-hole DNS sync automation and documentation
## Changes
- Created comprehensive NPM + Pi-hole setup documentation
- Added DNS sync script to automatically sync NPM proxy hosts to Pi-hole
- Updated hosts.yml with npm-pihole host entry

## Features
- Automatic local DNS resolution for homelab services
- Fixes 403 errors with "Internal Only" access lists
- Hourly cron sync keeps Pi-hole updated with NPM changes
- Cloudflare real IP configuration for proper IP detection

## Files Added
- server-configs/networking/nginx-proxy-manager-pihole.md
- server-configs/networking/scripts/npm-pihole-sync.sh

## Files Modified
- server-configs/hosts.yml (added npm-pihole host)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-04 21:06:01 -06:00
Cal Corum
7eadacc6db Add comprehensive Proxmox VE 7.1 → 9.1 upgrade plan
Create detailed two-phase upgrade strategy for Proxmox hypervisor:
- Phase 1: 7.1 → 8.4 (Debian Bullseye → Bookworm)
- Phase 2: 8.4 → 9.1 (Debian Bookworm → Trixie)

Plan includes:
- Pre-upgrade preparation and backup procedures
- Step-by-step upgrade execution for both phases
- Service validation and dependency order
- Rollback procedures for failure scenarios
- Risk assessment with mitigation strategies
- Timeline: 3-4 weeks total, ~4 hours downtime

Critical considerations:
- 8 LXC containers + 17 VMs to maintain
- Production services (Discord bots, databases, Gitea, n8n)
- Home Assistant dual network requirements
- LXC systemd compatibility checks for PVE 9

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-03 17:11:51 -06:00
Cal Corum
76dc82ce7c Add OmniTools self-hosted utility suite to n8n LXC
Deploy OmniTools (https://github.com/iib0011/omni-tools) on n8n LXC
for client-side file processing and utility tools.

- Container: omni-tools (iib0011/omni-tools:latest)
- Port: 8080 → 80
- Location: /opt/omni-tools on n8n LXC (10.10.0.210)
- Public URL: omnitools.manticorum.com (via NPM)
- Features: Image/PDF/audio processing, all client-side

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-03 16:48:16 -06:00
Cal Corum
05285a53b3 Document repository mirroring setup
Add information about GitHub and Gitea mirroring to the Gitea
documentation for future reference.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-03 16:23:48 -06:00
Cal Corum
1a0bc3dee4 Add Gitea self-hosted Git server (LXC 225)
Deploy Gitea 1.22.6 on LXC 225 to enable self-hosted Git repositories
with CI/CD capabilities via Gitea Actions, reducing dependency on GitHub
and associated costs while maintaining GitHub Actions workflow compatibility.

- LXC 225 (10.10.0.225) running Ubuntu 20.04 with PostgreSQL 12
- Public access via git.manticorum.com through NPM reverse proxy
- Comprehensive documentation including setup, backup, and CI/CD guides
- Gitea Actions enabled for GitHub Actions-compatible workflows
- Git LFS, SSH access, and webhooks configured

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-03 16:12:41 -06:00
Cal Corum
b4defab163 CLAUDE: Add OpenClaw personal AI assistant deployment
Infrastructure:
- Created LXC 224 (openclaw-lxc) at 10.10.0.224
- 2 CPU cores, 4GB RAM, 32GB disk
- Docker-in-LXC with AppArmor unconfined
- OpenClaw installed via npm with MiniMax M2.1 and Discord integration

Documentation:
- productivity/openclaw/CONTEXT.md - Comprehensive technology overview
- productivity/openclaw/troubleshooting.md - Complete troubleshooting guide
- productivity/openclaw/README.md - Quick reference
- productivity/openclaw/DEPLOYMENT_STATUS.md - Deployment checklist and status

Configuration:
- Added OpenClaw keywords to CLAUDE.md auto-loading rules
- Updated server-configs/hosts.yml with openclaw host entry
- Backed up LXC config to server-configs/proxmox/lxc/224.conf
- Created .env.example template in server-configs/openclaw/

Status: Fully operational
- Gateway accessible at http://10.10.0.224:18789 (SSH tunnel required)
- Discord bot connected and online
- MiniMax M2.1 model configured (200K context window)
- Daemon running as systemd service

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-02 08:02:58 -06:00
Cal Corum
3112b3d6fe CLAUDE: Add Jellyfin GPU health monitor with auto-restart
- Created jellyfin_gpu_monitor.py for detecting lost GPU access
- Sends Discord alerts when GPU access fails
- Auto-restarts container to restore GPU binding
- Runs every 5 minutes via cron on ubuntu-manticore
- Documents FFmpeg exit code 187 (NVENC failure) in troubleshooting

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-28 22:57:04 -06:00
Cal Corum
a900f9c744 CLAUDE: Document Home Assistant Matter/Thread setup and network config
- Update deployment guide with operational status (VM 109)
- Add ZBT-2 USB passthrough documentation (303a:831a)
- Document critical dual-NIC network config for Matter
  - net0 must be on home network (vmbr1) for Matter Server
  - net1 on server network (vmbr0) for management
- Add Thread network configuration details
- Add Matter commissioning steps and troubleshooting
- Update VM config with current settings and comments
- Add lessons learned from Matter commissioning debugging

Key insight: Matter requires HA to be on same subnet as IoT devices
for mDNS discovery. This was root cause of commissioning failures.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 10:58:19 -06:00
Cal Corum
282a2f8a9c CLAUDE: Add Home Assistant to infrastructure inventory
Added Home Assistant OS VM (10.10.0.174, VMID 109) to hosts.yml with new
'homeassistant' type for API-based smart home management. Includes API
config template with token storage pattern (.env.example).

Also added foundry-lxc entry that was missing from inventory.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 09:55:16 -06:00
Cal Corum
cd614e753a CLAUDE: Add server-configs version control system
Introduces centralized configuration management for home lab:
- sync-configs.sh script for pull/push/diff/deploy operations
- hosts.yml inventory tracking 9 hosts (Proxmox, VMs, LXCs, cloud)
- Docker Compose files from all active hosts (sanitized)
- Proxmox VM and LXC configurations for backup reference
- .env.example files for services requiring secrets

All hardcoded secrets replaced with ${VAR} references.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-11 16:13:28 -06:00
Cal Corum
b8b4b13130 CLAUDE: Update Tdarr context for ubuntu-manticore deployment
Rewrote documentation to reflect current deployment on ubuntu-manticore
(10.10.0.226) with actual performance metrics and queue status:
- Server specs: Ubuntu 24.04, GTX 1070, Docker Compose
- Storage: NFS media (48TB) + local NVMe cache (1.9TB)
- Performance: ~13 files/hour, 64% compression, HEVC output
- Queue: 7,675 pending, 37,406 total jobs processed
- Added operational commands, API access, GPU sharing notes
- Moved gaming-aware scheduler to legacy section (not needed on dedicated server)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-07 01:17:27 -06:00