Commit Graph

134 Commits

Author SHA1 Message Date
Cal Corum
0726d0337b feat: add SubagentStop → Discord notification via n8n (#4)
- Add SubagentStop HTTP hook to .claude/settings.json pointing at n8n
- Add importable n8n workflow (claude-agent-done.json): webhook trigger →
  extract agent name → POST to Discord
- Add setup guide (claude-agent-notifications.md) with payload reference,
  test curl command, and future extension notes
- Update n8n CONTEXT.md and workflows/README.md with new workflow entry

Discord webhook URL is stored as n8n variable DISCORD_CLAUDE_ALERTS_WEBHOOK
to keep it out of local config files.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-09 14:30:43 +00:00
Cal Corum
c08e779e42 docs: add caddy migration config, tdarr flow backup, and troubleshooting updates
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 13:13:21 -05:00
Cal Corum
1416af2ebb docs: mark paper-dynasty memory fix complete in audit report
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 13:13:21 -05:00
Cal Corum
0b46b51048 docs: add Pi-hole Facebook blocklist incident and v6 API notes
Document Messenger Kids connectivity issue caused by anudeepND Facebook
blocklist blocking edge-mqtt/graph.facebook.com. Includes Pi-hole v6 API
gotcha where numeric ID deletes silently fail (must use URL-encoded address).
TODO added for future per-device group-based blocklist management.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 13:13:21 -05:00
cal
24acf99836 Merge pull request 'docs: add scheduled-tasks CONTEXT.md and update routing (#2)' (#6) from ai/claude-home#2 into main
Reviewed-on: #6
2026-03-05 03:55:19 +00:00
Cal Corum
b50808eb8e docs: add scheduled-tasks documentation and update CLAUDE.md routing (#2)
Adds scheduled-tasks/CONTEXT.md documenting the implemented headless
Claude scheduled task system: runner.sh framework, custom dispatcher
scripts, active tasks, settings reference, auth, monitoring, and
cost safety guardrails.

Updates CLAUDE.md routing table to load CONTEXT.md alongside the
SKILL.md for all scheduled-task-related topics.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-05 03:55:02 +00:00
Cal Corum
48efafe217 docs: reorganize gaming into per-game directories, add tabletop section
Move Ready or Not configs/scripts into gaming/ready-or-not/, Stackmon into
gaming/stackmon/, add Palworld client and server docs. Move Vagabond RPG
PDFs to new tabletop/ directory with Age of Ashes GM reference.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-04 21:50:13 -06:00
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