Slash commands and references

In the message box, / runs a command or a skill, and @ points Oda at a file, a folder, an earlier chat or a helper. This page covers how both work; the commands themselves are described in Chat with Oda.

Run a command

  1. Type / at the start of the message box. The menu opens, listing the commands and the skills of the open chat.
  2. Keep typing to narrow the list, then press Enter or Tab to pick the highlighted entry. You can also type a command's name in full. Escape closes the menu and keeps what you typed.
  3. Send the message. The command runs on its own; it does not start a model turn.

The full list, with what each command does, is in Chat with Oda. Plans and questions are covered in Plan review and questions, and access modes in Workspaces, files and permissions.

What counts as a command

A command starts at the very beginning of your message: a slash and a lowercase name made of letters, digits, underscores and dashes. If the shape does not match, nothing runs:

Lines like these go to Oda as normal messages, and Oda answers them like any other prompt. Everything you type after a command's name is handed to the command as it is.

Files and images with commands

Attachments are checked before a command runs. Only a command that accepts attachments takes them: /plan and /goal do; many others, such as /compact, do not.

If you send an attachment to a command that does not take one, nothing runs: the message box shows a line such as /compact does not accept attachments, and your text and the attachments stay put, so you can remove them and send again. The same happens when an attachment is not ready or an image batch is over the limit.

Point Oda at a file, folder or chat

  1. Type @ in the message box. The menu opens, grouped into Files & folders, Sessions and Subagents.
  2. Keep typing to narrow the list, then pick an entry. Your pick is added to the message as a chip.
  3. For a folder, press Enter to add the folder itself, or Tab (or the row's chevron) to look inside first. A breadcrumb shows where you are, and each step of it takes you back out.

Questions, answered

How do I see all the commands?

Type / in the message box: the menu lists the commands and the skills of the open chat, and typing narrows the list. Chat with Oda describes what each command does.

Why did my message go to Oda instead of running a command?

A command only runs when the message starts with a slash and a lowercase name of letters, digits, underscores and dashes. goal without the slash, /Goal with a capital, /goal/path, and a slash typed after a space stay ordinary text: the message goes to Oda as a normal prompt.

Do commands use model tokens?

No. A command runs on its own rather than as a model turn: its answer stays in the chat and is not sent to the model, so running it spends no model tokens.

What happens if a command fails?

It answers with an error line in the chat saying what went wrong, and nothing else changes. Fix the cause and run the command again.

Can I add files or images to a command?

Only if the command accepts attachments: /plan and /goal do, while many others, such as /compact, do not. A command that does not take them refuses with a line such as /compact does not accept attachments, and your text and attachments stay in the message box, so you can remove them and send again.

What is the difference between a command and a skill?

Both appear in the / menu. A command runs directly, for example /compact. A skill is a set of instructions: /<name> sends your message with the skill loaded, and Oda follows those instructions while it works. See Using skills.

Can I remove a reference I added?

Yes. Put the caret right after the chip and press Backspace, or point at the chip and click the ✕. Removing a chip changes nothing else in your message.

How do I point Oda at a folder, not only a file?

Choose the folder from the Files & folders group to add the folder itself, or press Tab (or the row's chevron) to look inside first. A breadcrumb shows the way back out.

What does the Sessions group in the @ menu list?

Your earlier chats. Choosing one points Oda at that conversation, so it can use what is there while it works on the current task.

Can I reference a helper?

Yes, when the chat has helpers. They appear under Subagents in the @ menu. See Subagents.

Does a reference read the file straight away?

No. A reference tells Oda what to look at; Oda reads the file, folder or chat with its own tools when the task needs it, and the read shows in the chat as a step. See Reading files and images.