ai-raccoon-deployment-ops

Operate ai-raccoon MCP server rollouts, serve lifecycle, and watchdog automation.

2|Updated Aug 2, 2026
One-click install
npx skills add https://github.com/Arasz/ai-raccoon --skill ai-raccoon-deployment-ops-arasz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-raccoon-deployment-ops
Source: https://github.com/Arasz/ai-raccoon/tree/main/.ai-badger/skills/learned/uncategorized/ai-raccoon-deployment-ops
Command: npx skills add https://github.com/Arasz/ai-raccoon --skill ai-raccoon-deployment-ops-arasz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running the ai-raccoon MCP memory server in production involves non-obvious operational traps: a 4-hour idle watchdog that silently kills the serve, port-7721 ownership races, CLI verbs that moved under settings, and dotnet tool update no-ops when redeploying same-version builds. This Skill captures measured operational facts and rollout mechanics so deployments and upgrades succeed without rediscovering these failures. ## Core Features & Use Cases - Serve lifecycle management: Start ai-raccoon serve on 127.0.0.1:7721 with --idle-timeout 0 for permanence, background it with logs, and avoid silent 4-hour shutdowns. - Version-rollout watchdog pattern: Cron-driven scripts that gate on version, surgically kill the port owner via lsof -ti :7721, assert promotion settings once with a marker file, and verify release features before marking done. - Local QA deploy protocol: Bump versions uncommitted, rebuild into the local nupkg feed, uninstall/reinstall the global tool to force redeploy, back up the SQLite bank, and run a full manual MCP tool matrix. - Use Case: When upgrading ai-raccoon to a new release, follow the rollout watchdog pattern to update the global tool, restart the serve safely, enable extraction settings once, and verify the maintenance service checkpoints in serve.log. ## Quick Start Ask the agent to check the installed ai-raccoon version, restart the serve on port 7721 with a permanent idle timeout, and verify the maintenance service is checkpointing the WAL.

Frequently Asked Questions about ai-raccoon-deployment-ops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep ai-raccoon serve running permanently?

Start it with `ai-raccoon serve --idle-timeout 0` and background it with output redirected to a log file. Without the flag, the default idle watchdog shuts the serve down after 4 hours without MCP traffic.

Why did my ai-raccoon serve shut down overnight?

The idle watchdog default is 4 hours, not off. A serve started without `--idle-timeout` silently exits after 4 hours of no MCP traffic. Set `--idle-timeout 0` for a permanent serve.

Why does dotnet tool update not deploy my rebuilt ai-raccoon nupkg?

`dotnet tool update -g ai-raccoon --version <same>` is a no-op when that version is already installed; rebuilt bits are not pulled. Uninstall the global tool first, then install with `--add-source` pointing at the local feed.

How do I safely restart the ai-raccoon serve on port 7721?

Kill the port owner surgically with `lsof -ti :7721` and SIGTERM, never `pkill -f`, which also kills scratch servers on other ports. Only one process may own 7721; a second serve attaches to the existing one and exits.

Why does ai-raccoon config extract fail with unrecognized command?

There is no `config` verb; CLI configuration lives under `settings`, for example `ai-raccoon settings extract enable true`. Pre-1.21.0 builds accepted root-level verbs, but they were moved under `settings` with no compatibility alias.