| name | overcast-init |
| description | Install and configure overcast for this harness: install the CLI, verify the system ffmpeg, and configure reusable provider profiles. Use once per machine/profile before driving the `overcast` skill. |
overcast-init
One-time setup for overcast.
- Install the CLI —
pi install npm:@kdrrr/overcast (inside pi) or
npm i -g @kdrrr/overcast for the standalone binary.
- Install bundled skills for this agent — for Codex, Cursor, and other
non-Claude harnesses, copy the shipped skills into the agent's skills
directory explicitly:
overcast skills install --dest ~/.codex/skills
Bare overcast skills install remains the Claude Code default
(~/.claude/skills), and --harness claude-code is the explicit Claude
target.
- Install/update tinycloud — the default perception backend. Get the latest
(
npm i -g @cloudglue/tinycloud@0.3.12 then tinycloud install --latest, or
tinycloud update). overcast needs tinycloud ≥ 0.3.12 — its watch
envelope inlines the verbatim watch/listen transcripts
(watch.speech.v1); the face + index verbs need ≥ 0.3.4, and the image
see/extract verbs behind the opt-in see:tinycloud provider need
≥ 0.3.7. Override the invocation with OVERCAST_TINYCLOUD_CMD if it isn't
on PATH.
- Verify —
overcast doctor --json (pi pinned, ffmpeg/ffprobe runnable,
Cloudglue key, tinycloud CLI + version, optional uv/visual-db readiness).
- Cloudglue key — the default
watch/listen/face/index providers
reach Cloudglue via the tinycloud CLI; configure it (tinycloud setup cloudglue)
or export CLOUDGLUE_API_KEY.
- Provider profile setup — choose reusable providers once per profile, not
once per case. Always preview before applying:
overcast provider setup show --profile default --json
overcast provider setup plan --preset cloudglue --profile default --json
overcast provider setup apply --preset cloudglue --profile default --yes --json
overcast doctor --profile default --json
Optional presets/choices:
cloudglue for tinycloud watch/listen/face plus built-in ffmpeg enhance.
fal for see/enhance with FAL_KEY.
hf for see/enhance with HF_TOKEN.
elevenlabs for listen/enhance with ELEVENLABS_API_KEY.
owl-local for OWLv2 open-vocabulary object detection.
see:tinycloud (choice, --verb see --choice tinycloud) for Cloudglue
file-level image analysis via tinycloud see/extract (needs tinycloud
≥ 0.3.7; --detect facts are boxless — no crop).
deepface-local for local face detect/match through DeepFace.
- Optional visual DB setup — prepare visual DB Python once per
checkout/machine. DeepFace can be selected as a profile provider for the
face verb, while image/face DBs are still case-owned local indexes:
scripts/visual-db-uv.sh --face
overcast doctor --json
overcast provider setup apply --verb face --choice deepface-local --profile default --yes --json
overcast index create logos --type image-ransac --local --json
overcast index create localfaces --type deepface-local --local --json
- Case setup later — use the main
overcast skill per investigation to run
case setup, select targets/sources/indexes, and optionally set case-level
automation such as --auto-sense, --auto-index-new, and --findings
(defaults to suggest — score/text triggers auto-suggest leads; review is
the legacy text-only mode, off disables).
Then use the overcast skill to drive the verbs.