Using @ to Add Context

Use @ to reference files, folders, code symbols, Warp Drive objects, or even blocks from other sessions as context, giving Warp’s Agent richer and more precise information to work with.

How the @ context menu works

You can attach specific files, folders, code symbols, Warp Drive objects, and blocks from other sessions as context to a prompt using the @ symbol. When you’re inside a Git repository, typing @ opens a context menu that allows you to search for and select files or directories to include.

Attaching context with @ works in both natural language mode (when interacting with Agents) and classic terminal commands for referencing file paths.

Note: the search in the @-context menu is always relative to the root of the Git repository, even when you're working in a subdirectory. This means you can reference any file or folder tracked in the repo, regardless of the current working directory.

Using the @ symbol to search for and attach a file or folder from the project root.

Additionally, no codebase indexing (via Codebase Context) is required — file search is available immediately in any Git-initialized directory. The search also respects .gitignore rules and will exclude ignored files from the results.

Filtering files using @app to locate files containing “app” in their name or path.
Referencing a folder or all files within it by typing @styles.

Referencing code symbols

The @ menu can also be used to fuzzy-search for code symbols in your codebase. This includes functions, classes, interfaces, etc.

If you type something like @main, Warp will surface a matching main() function and insert it into your prompt as a reference with the line number. By pointing the Agent to a specific symbol, you can give it exactly the context it needs to make a targeted edit or explanation.

Referencing Warp Drive objects

Warp Drive objects are another way to attach context with @. You can reference:

  • Workflows — parameterized commands you can name and save in Warp with descriptions and arguments.

  • Notebooks — runnable documentation consisting of markdown text and list elements, code blocks, and runnable shell snippets that can be automatically executed in your terminal session.

  • Rules — reusable guidelines and constraints that inform how Agents respond to your prompts/

When you select one of these objects, Warp inserts a reference token into your prompt. The contents of the object are then automatically passed as context to the Agent.

Referencing blocks from other sessions

You are not limited to the current terminal session. With @, you can also bring in blocks of output from earlier sessions.

In the demo below, Ian shows how he previously ran cargo clippy and now wants help fixing the reported errors. Typing @cargo clippy surfaces the relevant block, which you can insert into your prompt. Once added, the Agent parses the output and generates fixes or explanations directly.

You can also reference live blocks, not just those that have already completed execution.

Why @ to reference context?

Attaching context with @ helps you:

  • Reference exact outputs instead of copy-pasting entire logs

  • Attaching relevant files or directories without leaving Warp

  • Reuse existing context and knowledge in Warp Drive

This makes Agent interactions more accurate, clearer, and efficient, without additional setup.

Last updated

Was this helpful?