Documentation
18 written guides, in the order to follow them. Every guide was written while building the real thing, with every error hit along the way. Free to self-host, MIT licence.
The path
Stop after any step. Each one leaves you with something that works.
Mac first. About 30 minutes end to end.
Commands, formats and phone access.
--table/--text/--json/--yaml/--html, always-on report server, one-tap Shortcut
why Samayly lives in WhatsApp and Telegram, what to say when someone asks for an app, add samayly.com to a phone's home screen
Remote Login, SSH keys, Termius, snippets
Tailscale, VPN notes, keep the Mac awake
Share safely, then put the bot in the chat.
Share the sheet safely, announcement template
Colima + k3d + WAHA, owner vs member paths, sandbox selftest, @bot commands, formats, every fix
every command with a plain-words prompt, paste-ready group messages, owner commands, terminal ops
Study material, schedules and routing.
Drive folders, indexer, local cache, grounded answers, routing aliases
NLP lectures, holidays and exams from the course sheet, cached for the bot
an optional decision model that sends a message to the tracker (quiz, assignment, task, test) or the professors' course sheet (NLU, NLP, FoVL), with shadow mode and a replay of your log
When something breaks, or you want to know how it works.
Every real error hit while building this
What never to commit, scrubbing, .gitignore
how every message is routed, mermaid architecture and workflows, every bug fixed, release steps
iPhone SSH, Mac terminal, GUI, CLI, bot and every prompt, with copy-paste command lines
Phone options
Start with Option 6. It runs on your Mac, needs no cloud, and is what the hosted product is built on.
Templates and scripts
| File | Goes to / does |
|---|---|
templates/CLAUDE.md.example | ~/.claude/CLAUDE.md |
templates/settings.json.example | merged into ~/.claude/settings.json |
templates/zshrc-tracker.sh | appended to ~/.zshrc |
templates/zshrc-formats.sh | appended after the tracker pack |
templates/ts03-bot.env.example | bot environment |
templates/subject-routes.json.example | /prep subject routing |
templates/ts03-router.json.example | Jev router config |
scripts/install-bot.sh | one-command bot install |
scripts/ts03-bot | the bot |
scripts/ts03-material-index | Drive material indexer |
scripts/ts03-schedule-index | class schedule indexer |
k8s/waha.yaml | WhatsApp gateway on k3d |
Each file opens on this site with a copy button. Edit it for your setup before use.
Write to us. We answer within a working day.