scripts/¶

Reusable shell + Python tools. Code lives here, not docs, run from CLI, cron, or systemd.

Top level¶

Entry	Purpose
`dispatcher.sh`	Task queue dispatcher (`tasks/pending/` → `claude -p` workers). Driven by `forge-dispatcher.service`.
`fleet-status.sh`	JSON snapshot of sessions + queue + monitors + system. Powers `dashboard/`.
`fleet-start.sh`	Boot the Remote Control fleet server (capacity 20, web-accessible).
`home-base-session.sh`	Always-on Claude Code Remote Control session. Driven by `forge-tmux-anchor.service`.
`notify.sh`	Multi-channel notify (file/ntfy/n8n/Discord/Slack), priority-routed. Used everywhere.
`checkpoint.sh`	Append `## [Claude Code] Session Checkpoint` to today's daily log. Called by Stop hook.
`prompt-counter.sh`	UserPromptSubmit hook, every 5th prompt injects a checkpoint reminder.
`new-file-log.sh`	PostToolUse hook for `Write`, auto-logs new files to today's daily log.
`remove_shared.py`	One-off Google Drive "Shared with me" cleanup tool.

Dir	Purpose
`assets/`	Asset-grabber (Google/Bing/DDG image search, page scraping, WebP+AVIF optimize). Playwright venv at `~/.forge-venvs/assets/`.
`cleanup/`	`retention.sh`, nightly archive of >30d files in `comms/{results,inbox}`, `tasks/{completed,failed}`, `logs/workers`. Cron 04:15.
`cloudflare/`	`forge_cloudflare_cf.py` API wrapper for DNS + Tunnels + Access. Powers `/cf-add` skill.
`gdoc/`	`forge_gdoc_to_drive.sh`, convert markdown to styled `.docx` in Google Drive. Powers `/save-to-drive` skill.
`hooks/`	`since-last.sh` (SessionStart), `auto-context.py` (UserPromptSubmit), `auto-checkpoint.sh` (Stop).
`integrations/`	`eight-sleep/`, `garmin/`, `telegram/`, `minecraft/`, pollers + bots + utilities.
`monitors/`	`security-check.sh`, `infra-check.sh`, `business-check.sh`, `mount-watchdog.sh`, cron-driven. `install-cron.sh` sets the crontab block.
`n8n/`	`forge_n8n_call.sh` (Forge → n8n outbound), `forge_n8n_decrypt_cred.sh` (extract n8n encrypted creds).
`search/`	`index.py` + `query.py`, fastembed BGE-small + sqlite-vec semantic search. Reindexed nightly 03:30. Powers `/recall` skill.
`sites/`	`forge_sites_new_page.sh`, `forge_sites_preview.sh`, `forge_sites_screenshot.sh`, `forge_sites_deploy.sh`, `forge_sites_all_deploy.sh`, site scaffold tools.