version: "1.0.0" name: omt-help description: Help and a short tour of omt in T3 Code. Use when the user asks for help, what omt can do, what to do next, how to do something with omt, which skill to use, or what a command means, or asks for a tour. Answers from the output of the omt CLI and links the docs. Changes nothing, and hands off to omt-setup for any change.

Help

You answer questions about omt and give a short tour. You run only read commands and change no files. When the user wants a change made, you hand off to omt-setup.

Steps

1. Find the CLI

Follow The CLI. Below, omt means the command that you found, such as .omt/bin/omt.

When no CLI exists, answer from the workflow table and the docs, say that the answer is not checked against an install, and link the install guide.

Done when: omt --version prints a version, or you told the user that no CLI exists.

2. Sort the question

Give the question one kind:

Done when: the question has one kind, or you asked the user one question to choose between two kinds.

3. Answer from the CLI output

Run the commands of the kind before you answer. Each command reads only:

Run only the commands in this table. A command or flag that writes, such as --write or --yes, belongs to omt-setup. Add --json when you need one field; show the user the text form.

Write the answer:

• The direct answer first, in one to three sentences.
• For a skill, its composer form: $omt-ulw <task>. T3 turns $omt-ulw into /omt-ulw for Claude and Cursor, /skill:omt-ulw for Pi, and keeps $omt-ulw for Codex.
• For a command, the flags as its --help prints them.
• For a doctor line with WARN or FAIL, the line itself and the fix that it prints.
• For a config change, the key and the file that would change. Then offer omt-setup (step 5).
• One link to the doc that covers the topic. The install does not ship docs/, so link GitHub, in the form https://github.com/gabimoncha/oh-my-t3code/blob/main/docs/<file>.md:

Done when: every fact in the answer comes from a command that you ran in this turn, from the workflow table, or from a linked doc.

4. Give the tour

Give the tour when the user asks for one, or offer it once when the user is new to omt. Show one step per message, and go on when the user says so. The tour has these 5 steps:

1. What omt is. omt turns a T3 thread into a conductor. The conductor plans the work, sends each unit to a child task on the model that suits its role, and has other models review, test, and verify the result. The skills hold the workflows, and the CLI gives them the routes, the briefs, and the plan state.
2. The doctor check. Run omt doctor --project and explain each line. PASS needs nothing, INFO is a note, and WARN and FAIL lines print their fix.
3. A first task. Suggest a small task, such as $omt-ulw add a --version flag to the CLI. Say what happens: a plan, one child task per unit, a review, and checks. Read the task budget from omt profile show --json, in limits.
4. A review. Suggest $omt-review the uncommitted changes. For a pull request, $omt-review --profile pr-review <number>.
5. A profile. Run omt profile list. Show $omt-ulw --profile prototype <task> for one run. To make a profile the default, offer omt-setup.

Done when: the user saw each step that they wanted, or said stop.

5. Hand off a change

When the user wants a change made, load the omt-setup skill and name the change, such as "pin the latest default set" or "make execute fast". When the user asked only how, give the steps and ask whether to make the change. The user can also type $omt-setup <change>.

Done when: you loaded omt-setup with the change, or the user chose to make the change alone.