ariana-dot-dev/kimi-box-plugin/background-worker

Background / 24-7 worker (Box)

Use this when work must keep running unattended: a queue worker, a Telegram/Discord bot, a polling agent, a scheduled scraper, or any always-on service. Ephemeral sandboxes (E2B microVMs, Codespaces) auto-die on a timer — wrong tool. A Box can be told to never auto-stop, persists its disk, and keeps a dedicated IPv4.

Why Box

• No session cap — runs hours/days/indefinitely.
• Persistent + resumable — disk survives stop; box resume brings it back.
• Cheap steady-state — flat per-second pricing beats ephemeral providers (50 always-on VMs ≈ $432/mo vs ~$4k+).

Prereqs

curl -fsSL https://box.ascii.dev/install | sh (Windows: irm https://box.ascii.dev/install.ps1 | iex), then box login "$BOX_API_KEY" --json.

Recipe

box_id="$(box new --no-auto-stop --json | jq -r 'select(.event == "ready") | .id')"
box ssh "$box_id" -- bash -s < ./setup.sh
box ssh "$box_id" -- "cd /app && nohup ./worker.sh > /var/log/worker.log 2>&1 &"
box extend "$box_id" --ttl 2592000                 # optional: 30-day deadline

Survival rules

Running processes do not survive stop/resume or fork — only the disk does. Make startup idempotent and relaunch after resume; use a process manager (systemd, pm2, nohup).

Limits

EU-only; disk-level snapshots; active-box cap scales by plan (100+); max 30-day TTL per extension (re-extend as needed).