CTO Telegram Dispatcher Primer

Start local Codex work from your phone.

The dispatcher is a bridge between Telegram and local Codex running on the ThinkBook. Use it when you want to queue a Codex assessment or handoff without opening the laptop.

Ask for analysis

/cto assess <what you want checked>

Ask for Codex handoff

/cto handoff <what Codex should pick up> --for codex

Plain English

Text the dispatcher bot. The website files the request. The ThinkBook dispatcher notices it. Local Codex runs the work. You get a short Telegram summary back.

How The Loop Works

1. Telegram You send a supported /cto command from your phone.
2. dvo88.com The webhook validates the command and creates a Firestore report.
3. Dispatcher The ThinkBook local service claims the ready report.
4. Codex The dispatcher starts codex exec with the handoff prompt.
5. Reply The result is saved and a Telegram summary comes back to you.

Use assess When

You want Codex to inspect, diagnose, compare options, or tell you what is true before changing anything.

Health check

/cto assess verify production health and dispatcher status

Bug diagnosis

/cto assess why Telegram CTO commands repeated replies today

Planning first

/cto assess dark mode implementation plan for D:\ria-marketing-page

Use handoff When

You want Codex to pick up a concrete task. Include the repo path, expected behavior, and verification target.

Codex-owned repo

/cto handoff diagnose and fix the CTO health page failing in D:\dvo88\dvo88-command-center --for codex

Cross-repo assist

/cto handoff in D:\ria-marketing-page, assess and implement dark mode if safe; preserve the brand system; verify locally before reporting back --for codex

Decision Table

Situation Use Why
You are not sure what is wrong. /cto assess ... Gets a diagnosis before any fix.
You know the task and want Codex to act. /cto handoff ... --for codex Creates a direct local Codex handoff.
The task is in RIA Builder, marketing, or another non-dvo88 repo. Usually start with assess. Codex can assist, but the agent split normally assigns RIA surfaces to Claude.
You see old documentation or muscle memory for /codex. /codex still works as a compatibility alias. Use /cto going forward so the command matches CTO's production intake surface.
You want a simple bot response like echo, reminder, or casual chat. Do not use the dispatcher. The dispatcher is not a general chat bot. It only understands assess and handoff.

What Good Looks Like

  1. Telegram immediately replies that the Codex report was queued.
  2. The reply includes a report id.
  3. The local dispatcher claims the report on the ThinkBook.
  4. Codex runs the request.
  5. You receive a completion summary in Telegram.
Queued Claimed Completed Telegram summary sent

What Not To Send

These are valid Telegram messages, but they are not valid dispatcher commands.

/cto echo hello
/cto remind me tomorrow
/cto do this thing
/ria handoff anything

If you use an unsupported action, the bot should reply once with guidance. Repeated replies mean the webhook retry path needs attention.

Good Command Writing

Copyable Templates

General diagnosis

/cto assess <problem or question>

Production check

/cto assess verify <site or feature> in production and report the current state

Codex implementation handoff

/cto handoff in <repo path>, implement <specific change>; preserve <important behavior>; verify <checks> --for codex

Safer first step for another agent's lane

/cto assess implementation plan for <task> in <repo path>; note which agent should own it