sq-status

/sidequest:sq-status

Comprehensive health check for SideQuest.

Steps

Perform these checks in order and collect the results:

1. Authentication Status

Read the config file:

cat ~/.sidequest/config.json | python3 -c "
import sys, json
try:
    config = json.load(sys.stdin)
    token = config.get('token')
    if token:
        print('OK')
    else:
        print('NO_TOKEN')
except:
    print('NO_CONFIG')
"

• If output is NO_TOKEN: Auth status = "Not authenticated"

  • Add advice: "Run /sidequest:sq-login to authenticate."

• If output is NO_CONFIG: Auth status = "Not configured"

  • Add advice: "Run /sidequest:sq-login to set up SideQuest."

• If output is OK: Auth status = "Authenticated"

2. Native App Status

Test socket connection to the native app:

echo "" | nc -U -w1 ~/.sidequest/sidequest.sock 2>/dev/null && echo "RUNNING" || echo "NOT_RUNNING"

• If output is RUNNING: Native App status = "Running (socket connected)"
• If output is NOT_RUNNING: Native App status = "NOT RUNNING"
  • Add advice: "Quests can't be delivered. Run: open ~/Applications/SideQuestApp.app"

3. API Health

Test connectivity to the API:

curl -s --max-time 3 https://api.trysidequest.ai/health && echo "OK" || echo "FAILED"

• If output contains OK: API status = "Healthy"
• If output is FAILED: API status = "Unreachable"
  • Add advice: "Check your internet connection."

4. Last Quest Timing

Read timing state:

cat ~/.sidequest/timing-state.json 2>/dev/null | python3 -c "
import sys, json, time
try:
    data = json.load(sys.stdin)
    last_quest = data.get('last_quest_shown', 0)
    daily_count = data.get('daily_quest_count', 0)
    if last_quest:
        print(f'OK:{last_quest}:{daily_count}')
    else:
        print('NEVER')
except:
    print('NO_TIMING')
"

• If output is NO_TIMING or NEVER: Last Quest = "Never"
  • Add: "Your first quest will appear after a git commit or 10-minute coding gap."