Browse · Help archive

Getting Started

Account & Security

Billing & Plans

Organization & Roles

QA-QC

Project Matrix

File Management

Project Members

Access Requests

Project Setup

Attribute Extract

Attribute Import

Scheduled Jobs

Power BI Analytics

Foreman Assistant

Permissions Graph

Archive
/
Foreman Assistant
/
Slash Commands & @ Mentions in Foreman Assistant

Slash Commands & @ Mentions in Foreman Assistant

Learn how to use slash commands and @ mentions in Foreman Assistant to quickly run actions, insert prompts, and navigate the command palette efficiently.

Opening the palette

Type / at the start of an empty composer. A floating palette appears above the composer with two kinds of items:

Actions — one-click operations that manipulate the chat itself.
Prompts — pre-written starter messages you can send or tweak before sending.

A command stays in the palette as long as the first character is / and there's no space in the input. Adding a space dismisses the palette so you can type a normal message that happens to start with a slash.

Navigating the palette

Key	Action
↓ / ↑	Highlight next / previous command
Tab or Enter	Pick the highlighted command
Escape	Dismiss without picking
Click	Pick any row directly

Filtering is live — keep typing after the / to narrow the list by command name or description.

Available commands

Actions

Command	What happens
`/new`	Creates a new conversation immediately. Your draft message is discarded.
`/clear`	Archives the current conversation and starts a new one. Original stays in the Archived tab if you need it back.
`/export`	Downloads the current conversation as a Markdown file. Same as the export button in the widget header.

Pre-built prompts

These commands replace the composer text with a ready-made prompt. Review it, edit if needed, then press Enter to send.

Command	Pre-fills
`/qa`	"Help me set up a QA check. I want to validate files for naming conventions and required metadata. Walk me through the options."
`/extract`	"I want to extract attributes from files in a folder. Show me how to configure an extract definition step by step."
`/find`	"Help me find files. Ask me which project and what I'm looking for, then search."
`/access`	"Show me any pending access requests for my hub. Summarize who is waiting and for what project."
`/members`	"List members of a project — ask me which project first."

Each prompt is designed to get the AI into the right "mode" quickly: ready to call the relevant tool with a clarifying question if it needs more info.

The pre-built prompts are starting points — feel free to adjust them before sending. Add your project name, a folder path, a date range, whatever makes the question specific. The more context the better.

Where the list comes from

Slash commands are served by the GET /api/foreman-assistant/slash-commands endpoint. They are not the same as AI tools — a command lives entirely on the client: it either performs an action in the UI or fills the composer with template text. Tools, by contrast, are what the AI calls when processing your request.

The list is currently curated and identical for all users. Per-user or per-tenant custom commands may come later.

Usage tips

Escape back to typing normally — hit Escape to dismiss the palette and keep the slash character in your text if that's what you meant to send.
Commands are not context-sensitive (yet) — /qa prompts the AI to walk through QA setup even if you're already on the QA page. Future versions may surface page-aware shortcuts.
No custom aliases — you can't remap slash commands from the UI. If you need a different starter, type your own prompt directly.

Mentioning a project with `@`

Typing @ anywhere in the composer — either at the start of a message or after whitespace — opens a mention palette listing your MCP-enabled projects. It behaves exactly like the slash palette:

Key	Action
↓ / ↑	Highlight next / previous project
Tab or Enter	Insert the highlighted project as `@alias` (trailing space)
Escape	Dismiss without picking
Click	Pick any row directly

Keep typing after the @ to filter by alias or project name. Picking an item replaces your typed @query with @alias , leaving the caret positioned so you can keep writing the rest of the request.

Deleting a mention (or slash command) as one unit

Both @alias and /command behave like tokens when you Backspace at the end of them — one Backspace removes the whole word instead of one character. Combined with the trailing space the palette adds, that means:

First Backspace removes the space.
Second Backspace removes the entire @alias or /command.

If you have an active text selection, Backspace still works on the selection as normal. Put the caret in the middle of a token and you'll get char-by-char deletion again — the token-delete only fires when the caret sits at the very end of the token.

Mentioning every project at once

The first row of the palette is "All projects" (shown whenever you have two or more MCP-enabled projects). Picking it inserts every alias into the composer as @alias1 @alias2 @alias3 … — delete the mentions you don't want to include and keep the rest. Handy for cross-project questions like "compare @acme @beta @gamma storage trends this quarter".

What the AI does with a mention

When your message contains @alias tokens, Foreman looks up each alias against your MCP-enabled projects before sending the message to the AI, and appends a small resolution block to the system prompt:

Resolved mentions (from @alias tags in the latest user message):
- @acme: projectId=b.25d…, hubId=b.3f2…, name="Acme Tower Refit"

The AI uses those IDs directly and skips the get_projects / get_hubs lookup round-trip for pinned projects. The @alias stays visible in your message so you can see exactly which project the answer is about.

If an alias isn't MCP-enabled for your account (or you mistype it), the resolution block reports NOT FOUND and the AI will tell you so and offer to find it through get_hubs.

When to mention a project

Narrow the scope — "list recent files in @acme" is faster and cheaper than "list recent files in Acme Tower Refit" because the AI doesn't have to resolve the name first.
Disambiguate — if you have multiple projects with similar names, an alias is unambiguous.
Chain operations — once you've tagged a project early in the conversation, the AI keeps it in context for follow-up turns.

Enabling more projects for `@` mentions

Only MCP-enabled projects appear in the palette. To enable more, visit the MCP Settings → Projects tab and flip the toggle on the project you want. You can also assign or change the alias there — shorter aliases are easier to type.