Mentions & Commands¶
Anywhere you type in BotBoss — the chat composer, a task description, a workflow step — you can pull in the things you work with by typing a trigger character. One picker, the same everywhere: type @ to reference a person, file, table, or bot; # to reference content; / to run a command or a saved workflow.
What you can do¶
Reference anything with @. Type @ followed by a name to insert a structured mention — a person, a team, a bot, a file, a folder, a table, a database, a connector, or a skill. The mention becomes a clickable chip, and the agent receives the referenced thing as context rather than as plain text.
Reference content with #. Type # to narrow to referenceable content — files, tables, databases, and connectors. Use it when you specifically want to point at data rather than people.
Run commands and workflows with /. In the chat composer, type / to invoke a command (like /status or /clear) or to run a saved workflow — picking a workflow expands its prompt right into the composer for you to review and send. (See Run a workflow from chat.)
Filter by category. Once the picker is open, a chip bar shows every category that
trigger can match — @ covers People, Bots, Teams, Files, Folders, Tables, Databases,
Connectors, and Skills; # narrows to just Folders, Files, Databases, Tables, and
Connectors; / shows Commands, Skills, and Workflows. Click a chip to filter to just that
kind, or press ← / → to cycle through them from the keyboard. The bar sits right
where you're typing, so it's always in reach.
Search by typing — including multi-word names. Keep typing to narrow the list. Spaces are allowed, so @deploy staging matches a person or workflow whose name has more than one word; the picker only closes if what you typed stops matching anything (so a normal sentence after an @ reads as prose, not a stuck menu).
Scope a search to one database. When you reference a table, you can drill into a specific database first — the picker scopes the table search to that database (for example, only the tables inside your QuickBooks warehouse). A chip shows the active scope; clear it to search everywhere again.
Drag instead of type. In the chat composer you can also drag a file row straight into the message — same structured mention, no typing.
How it works¶
Every surface drives the same picker, so the keyboard, categories, and result list behave identically whether you're in a DM, a task, or a workflow step. As you type a trigger, BotBoss searches across the relevant catalogs (people and teams from your workspace, files from the agent's filesystem, tables and databases you can read, and so on) and groups the matches by category. Use ↑ / ↓ to move the highlight and Enter (or Tab) to insert the highlighted result; ← / → switch categories; Esc closes the picker without losing your place. The list scrolls when there are more matches than fit, and the highlighted row stays in view as you arrow through it.
What a pick does depends on the kind: most kinds insert a reference chip (the agent resolves it to the underlying file, table, or person). A / command runs immediately. A workflow picked from / in the chat composer is run — its prompt is rendered into the composer for you to review and send.
Example — referencing a file and a teammate¶
In a chat with your finance agent, you type:
Hey @Priya — can you review the figures in #Q3-budget.xlsx before I send them out?
As you type @Pri, the picker surfaces Priya under People; you press Enter and @Priya becomes a chip. As you type #Q3, the picker narrows to content and surfaces Q3-budget.xlsx under Files; you pick it and it becomes a chip too. The agent receives both as structured context — it knows exactly which person and which file you mean, and the file's contents come along for the ride.
Example — narrowing with the keyboard¶
You type @ to open the picker on everything, then press → a few times to reach the
Tables category, type inv to narrow to Invoices, and press Enter — all without
touching the mouse.