Run it from anywhere

Related: Guide 4 (the ts03 pack), Guide 5 and Guide 6 (iPhone, Tailscale), Guide 10 (formats, HTML), Guide 13 (bot messages), Guide 14 (routing and fixes). Class schedules: Guide 16. Jev router: Guide 17. Every guide and diagram by name: docs index.

Contents: 1 Map · 2 Which door · 3 iPhone · 4 MacBook Pro · 5 GUI · 6 CLI · 7 Bot · 8 Prompts · 9 Recipes · 10 Quick fixes

1. The map

Ways in: where each surface connects

2. Which door for which job

3. iPhone (Termius over SSH)

3.1 Once

On the Mac, turn on System Settings, General, Sharing, Remote Login, then:

sudo systemsetup -getremotelogin     # Remote Login: On
hostname                              # e.g. Your-MacBook.local
ipconfig getifaddr en0                # e.g. 192.168.1.20
mkdir -p ~/.ssh && chmod 700 ~/.ssh
nano ~/.ssh/authorized_keys           # paste the ONE public-key line from Termius
chmod 600 ~/.ssh/authorized_keys

In Termius: Hostname Your-MacBook.local (or the IP), Port 22, Username from whoami, your key. Set the Startup Snippet:

source ~/.zshrc && clear && ts03-health

Away from home, put Tailscale on the Mac and the iPhone (same account) and point Termius at the Mac's Tailscale address:

/Applications/Tailscale.app/Contents/MacOS/Tailscale ip -4     # the 100.x address
caffeinate -dimsu &                                             # keep the Mac awake

Keep the Mac plugged in with the lid open. A closed lid on battery sleeps and the SSH session drops.

3.2 First connection

whoami && hostname
ts03-health          # google-sheets ... ✔ Connected
ts03-brief

If it says Not logged in, run claude, type /login, open the URL in Safari and approve. Then ctrl d.

3.3 Snippets worth saving in Termius

3.4 Bot, cluster and schedules from the phone

tail -n 20 ~/Library/Logs/ts03-bot.log                      # what the bot just did
~/.local/bin/ts03-bot selftest                              # sandbox audit, must end with the green tick
launchctl kickstart -k gui/$(id -u)/com.ts03.bot.whatsapp   # restart the bot
launchctl start com.ts03.material-index                     # re-read the Drive folders now
cat ~/Library/Logs/ts03-material-index.log                  # what it found
launchctl start com.ts03.schedule-index                     # refresh the class schedule cache now
cat ~/Library/Logs/ts03-schedule-index.log                  # what it found
~/.local/bin/ts03-bot router-status                         # Jev router: decisions logged and failures
kubectl get pods -n waha                                    # WAHA should be 1/1 Running
kubectl get cronjob ts03-digest -n waha                     # the 08:00 and 22:00 schedule
kubectl get jobs -n waha                                    # one Job per brief
SECRET=$(kubectl get secret waha-secrets -n waha -o jsonpath='{.data.WAHA_API_KEY}' | base64 -d)
curl -s http://localhost:3100/api/sessions/default -H "X-Api-Key: $SECRET" | head -c 200   # "status":"WORKING"

launchctl kickstart works while you are logged in on the Mac. If launchctl list | grep ts03 prints nothing over SSH, use launchctl print gui/$(id -u)/com.ts03.bot.whatsapp | grep -E "state|pid" instead.

3.5 What not to run over SSH

macOS blocks SSH sessions from reading ~/Desktop, ~/Documents and ~/Downloads (you will see Operation not permitted). Your repo lives in ~/Desktop, so over SSH do not run ./scripts/... or git. Use the installed copy (~/.local/bin/ts03-bot) and launchctl start as above, and do those jobs from the Mac's own terminal. Keep credentials in ~/.config/mcp-credentials/, never on the Desktop.

3.6 Siri shortcut

Shortcuts app, new shortcut: Run Script over SSH (host, user, SSH key) with source ~/.zshrc && ts03-brief, then Speak Text. Add the Shortcuts app's own public key to ~/.ssh/authorized_keys.

4. MacBook Pro

4.1 Local terminal, or SSH from another computer

The same commands as the iPhone work in Terminal or iTerm on the Mac. From another computer:

ssh <your-user>@Your-MacBook.local          # or the Tailscale name or 100.x address

Run these from the repo folder on the Mac's own terminal:

Never use install-bot.sh whatsapp --uninstall to restart. It removes the service. Do not pass --digest: the CronJob owns the brief.

4.2 Services at a glance

5. GUI

The dashboard asks you to connect with the API key. Get it with kubectl get secret waha-secrets -n waha -o jsonpath='{.data.WAHA_API_KEY}' | base64 -d. Its username is admin and the password is printed at the top of kubectl logs -n waha deploy/waha unless you set WAHA_DASHBOARD_PASSWORD yourself. Do not paste either value into chats or commits.

6. CLI reference

6.1 The ts03 pack and the prompt each command sends

Every command ends up as claude -p --model sonnet "TS-03 tracker: <prompt>" with your ~/.claude/CLAUDE.md loaded.

6.2 Layouts

The flag works at the start or the end, on ts03 and on every alias above:

ts03 --table list all upcoming items
ts03-week --json
ts03-sub GPU Programming --text
ts03 what is due this week --yaml
ts03-week --html && ts03-link          # saved as ~/ts03-reports/latest.html

Layouts are --table, --text, --json, --yaml and --html. TS03_FORMAT=json sets a default for the session.

6.3 Claude Code

claude -p "say hi"                      # one-shot, no session
claude                                  # interactive, then /login if asked
claude mcp list                         # google-sheets and google-drive should say Connected
claude mcp list | grep google-

6.4 Checks

scripts/ts03-bot selftest                                    # on the Mac
~/.local/bin/ts03-bot selftest                               # same thing, works over SSH
python3 -m json.tool ~/.cache/ts03-material/GPU.json | head  # what /prep can see
./scripts/ts03-schedule-index --show NLP                    # what the bot has cached for the class schedule
ls -l ~/.cache/ts03-schedule                                 # the cache files and their age
ls -A | grep '^\.tmp_'                                       # in the repo, should print nothing

6.5 Git and releases (Mac terminal)

git status --short
git add README.md docs                      # add folders by name, never git add -A
git commit -m "message"
git push
NEXT=$(git tag -l 'v*' | sort -V | tail -1 | awk -F. '{printf "%s.%d", $1, $2+1}'); echo "$NEXT"
git tag "$NEXT" && git push origin "$NEXT"
open "https://github.com/rpaut03l/google-sheets-mcp-guide/releases/new?tag=$NEXT"

6.6 Class schedule indexer

Setup and the config file are in Guide 16.

6.7 Jev router

~/.local/bin/ts03-bot takes the same commands over SSH. The key TS03_ROUTER_KEY lives in ~/.config/ts03-bot.env. Setup is in Guide 17.

7. The bot, and the question each command asks

Start with @bot or a /command. The full list with paste-ready group messages is Guide 13, and how a message is routed is Guide 14. For members each command below puts the question in the second column to the sandboxed model, with the snapshot as data. For you the slash commands run the terminal twin against the live sheet.

8. Prompts

8.1 Read, in plain English (terminal)

ts03 how many rows are in my tracker
ts03 anything due this weekend
ts03 which items are worth the most points this month
ts03 list items for Advanced AI with their notes
ts03 which subjects have nothing due in the next 14 days
ts03 how many days until the next quiz
ts03 compare the points due this week with next week
ts03 --table list every assignment that is not yet submitted
ts03 --json list items due before 15-Oct-2026

8.2 Write (terminal, and / commands for the owner)

ts03-add GPU Quiz-02 on 11-Oct-2026 at 18:00 IST, 10 MCQs
ts03-done Ethics assignment
ts03-submit GPU assignment
ts03-move GPU Quiz to 12-Oct-2026 19:00 IST
ts03-note Innovation assignment: group of 4 finalised

In WhatsApp the same with a slash: /add …, /done …, /submit …, /move …, /note …. Writes are insert and update only. Deleting is blocked, and column J, the reference tab and the archive tab are never written. Be specific when two rows could match (GPU Quiz-02, not GPU Quiz), and send /refresh afterwards so members see the change.

8.3 Ask the bot in plain words (members and owner)

@bot any GPU Programming quiz coming up?
@bot what's due before Friday?
@bot is anything overdue?
@bot which items carry the most points?
@bot IP ka assignment kaise karna hai?
@bot GPU quiz kab hai?
@bot who teaches Advanced AI?
@bot when is the next NLP lecture?
@bot who teaches CV?
@bot is there NLP class on 9 October?
@bot who built you?
@bot can you edit the sheet?

Questions in Hindi or Hinglish get a Hinglish answer, and French gets French. "How do I do X" questions return the requirements and steps from the item's notes, never the finished work.

8.4 Study prompts

/prep CUDA
/prep GPU warp divergence
/prep memory coalescing
/prep patents vs copyright
/prep what is a trademark
@bot prepare me on tiled matrix multiplication
@bot explain me intellectual property rights from scratch
/prep GPU warp divergence table
/prep CUDA json

/prep explains concepts and declines to solve a pasted quiz, exam or assignment question.

8.5 Maintenance prompts for Claude on the Mac

claude -p "Using the Google Drive tools, list every file directly inside the top-level Drive folder named GPU in My Drive."
claude -p "say hi"
claude mcp list

The first confirms the Drive connector works under the same settings the indexer uses. It lists names only and changes nothing.

8.6 Phrases that change the route

• A message containing subject, course, professor, who teaches or TA is answered from the subject list, not by the model. If it also names NLP, NLU or CV, the schedule answers it.
• "How do I prepare for X" goes to /prep, not to the tracker notes. Use "GPU quiz kaise karna hai" or "what do I need to submit for the GPU assignment" for the notes.
• table, json and yaml change the layout of list answers only. /plan, /load and /remind are always plain text.

8.7 Class schedule prompts

/nlp
/cv
/nlp when is the minor exam
/nlp is there class on 9 October
/nlp how many lectures are left
/nlp slides for lecture 15
/nlp recording of lecture 7
/nlp who is teaching lecture 20
@bot when is the next NLP lecture?
@bot when is the next CV lecture?
@bot who teaches CV?
@bot who teaches NLU?
@bot is there FoVL class tomorrow?
@bot NLP mid sem break kab hai?
@bot when does the FoVL major exam start?

Name the subject or area (NLP, NLU, CV, FoVL). A bare "is there class tomorrow?" goes to the tracker, which has no class schedule. With the Jev router on, the bot asks which subject instead.

8.8 Jev router test messages

Send these in your DM once the router is on (Guide 17):

@bot NLU/NLP InClassActivity2 kaise karna hai?
@bot NLP lecture or assignment due?
@bot when is the next NLU lecture?
@bot who teaches CV?
@bot is there class on 9 October?
@bot explain the concept of perplexity
@bot who is the professor for GPU programming?
@bot tell me about nlp

Expected: the tracker, the tracker, the professors' sheet, the professors' sheet, a question back about the subject, /prep, the subject list, a question back about tracker or course sheet. Check each decision with scripts/ts03-bot router-status.

9. Recipes

Morning, from the iPhone 1. Open Termius, connect to the Mac. The startup snippet runs ts03-health. 2. ts03-brief, then ts03-urgent if anything is red. 3. If you want it styled: ts03-week --html && ts03-link, then open the link in Safari.

A new announcement 1. ts03-add GPU Quiz-02 on 11-Oct-2026 at 18:00 IST, 10 MCQs (or /add … in WhatsApp). 2. Check the row it shows back. 3. /refresh in WhatsApp so members see it. 4. ts03-wa and forward the draft, or let the 08:00 and 22:00 brief carry it.

After you submit something 1. ts03-submit GPU assignment 2. /refresh

Friday audit 1. ts03-check (report only). 2. Fix what it lists with ts03-move and ts03-note, or in the Sheet. 3. ts03-wa for next week's reminder.

Add study material for a subject 1. Create or open the Drive folder and drop in PDFs. Prefer text PDFs over PowerPoint. 2. Make sure the folder name is in ~/.config/ts03-subject-routes.json. 3. On the Mac: ./scripts/ts03-material-index "<folder name>". From the phone: launchctl start com.ts03.material-index, then cat ~/Library/Logs/ts03-material-index.log. 4. Restart the bot so it re-reads the routes: launchctl kickstart -k gui/$(id -u)/com.ts03.bot.whatsapp. 5. Test /prep <topic> and look for 📎 FROM YOUR MATERIAL.

The bot went quiet 1. kubectl get pods -n waha, then the session curl in 3.4. 2. If WAHA shows a QR: kubectl rollout restart deployment/waha -n waha, kubectl logs -n waha deploy/waha -f, scan it (or use the WAHA dashboard). 3. tail -n 20 ~/Library/Logs/ts03-bot.log and send /stats in a DM.

A classmate asks "is there class tomorrow?" 1. Ask them to name the subject: @bot is there NLP class tomorrow?. Without a subject the tracker answers, and it has no class schedule. 2. If the answer looks old, check the footer, then ./scripts/ts03-schedule-index NLP (or launchctl start com.ts03.schedule-index over SSH).

Add or change a class schedule 1. Edit ~/.config/ts03-schedules.json: sheet id, tab, aliases, and parts with the instructors. No restart. 2. ./scripts/ts03-schedule-index NLP --dry-run, then without --dry-run. 3. ./scripts/ts03-schedule-index --show NLP, then test /nlp in a DM.

Publish the docs (Mac terminal) 1. git status --short and check only the files you expect are listed. 2. Commit, push, tag and create the release page with the commands in 6.5.

10. Quick fixes