/docs
Guide
Start / Stop

Turn Spark on, check it, and stop it safely.

Use this page for Spark Live, autostart, daily checks, restart, and uninstall. If something is broken, go to Fix next.

The daily health path.

Spark Live Provider Telegram Memory Missions
spark guide
spark live status
spark providers status
spark providers test --role chat
spark verify --onboarding

Symptom map.

No Telegram reply

Run spark fix telegram, then spark logs spark-telegram-bot.

Check token, admin ID, and duplicate polling.

Only memory labels

Run spark providers status and spark verify --deep.

The LLM role or memory bridge may not be wired.

Memory missing

Send /remember and /recall. Then run spark verify --deep.

Missions missing

Send /run, then /board. If nothing appears, run spark fix spawner.

Autostart and uninstall.

Spark Live and autostart

spark live start
spark live status
spark autostart status
spark autostart uninstall
spark autostart install telegram-starter --now

Uninstall

spark autostart uninstall
spark uninstall

Deleting local files is destructive. Agents must ask first.

Keep improving

Keep adding real failure examples from support runs: exact error line, likely cause, and the smallest fix.

Health report schema.

spark-health-report.v1for agents
{
  "sparkStatus": "ok | needs_attention | unknown",
  "providerStatus": "ok | missing | miswired | unknown",
  "telegramStatus": "ok | quiet | token_error | duplicate_polling | unknown",
  "memoryStatus": "ok | not_configured | failing | unknown",
  "missionStatus": "ok | not_configured | failing | unknown",
  "nextSmallestFix": "one command or one question"
}