# Rules

Warp’s **Rules** feature lets you create reusable guidelines that inform how agents respond to your prompts. Rules help tailor responses to match your coding standards, project conventions, and personal preferences, making agent interactions smarter and more consistent.

Warp supports two types of rules: **Global Rules** and **Project Rules**.

{% embed url="<https://youtu.be/fDr0-3bLxMQ>" %}

## Global Rules

Global Rules apply across all projects and contexts. They're ideal for:

* Coding standards and best practices
* Workspace-wide guidelines
* Tool configurations or preferences you want applied everywhere

Warp may also suggest Global Rules based on your usage patterns to make future interactions smarter and more consistent.

## Project Rules

Project Rules live in your codebase and apply automatically when working within that project. They're stored in an `AGENTS.md` file (or `WARP.md` for backwards compatibility) and can be:

* Placed in the root of your repository
* Added in subdirectories for more targeted guidance

{% hint style="info" %}
Warp uses `AGENTS.md` as the default project rules file. Existing `WARP.md` files are still fully supported—if you have `WARP.md`, it will continue to work as expected. You can also rename `WARP.md` to `AGENTS.md` at any time without additional changes.

If both `WARP.md` and `AGENTS.md` exist in the same directory, `WARP.md` takes priority.
{% endhint %}

{% hint style="warning" %}
The filename must be in **all caps** for Warp to recognize it (e.g., `AGENTS.md`, not `agents.md` or `Agents.md`). We recommend creating `AGENTS.md` for new projects.
{% endhint %}

**When you're in a directory:**

* Warp automatically applies the `AGENTS.md` (or `WARP.md`) in the root and in the current directory.
* If you edit files in another subdirectory, Warp makes a best-effort attempt to include that subdirectory's rules file as well.

Example project structure:

```
project/
  api/
    AGENTS.md      # API-specific rules
  ui/
    AGENTS.md      # UI-specific rules
  AGENTS.md        # Project-wide rules
```

How Warp applies these Project Rules:

* **If the current directory is `ui/`**
  * Automatically applied: `project/AGENTS.md` and `project/ui/AGENTS.md`
  * Best effort: `project/api/AGENTS.md` if editing files there
* **If the current directory is `api/`**
  * Automatically applied: `project/AGENTS.md` and `project/api/AGENTS.md`
  * Best effort: `project/ui/AGENTS.md` if editing files there

### **Rules precedence**

When multiple rules apply, Warp follows this order of precedence:

1. Rules in the current subdirectory's project rules file
2. Rules in the root directory's project rules file
3. Global Rules

This ensures the most specific, project-relevant rules take priority over broader ones.

***

## How to access Rules

* From [Warp Drive](https://docs.warp.dev/knowledge-and-collaboration/warp-drive): **Personal** > **Rules**
* From the [Command Palette](https://docs.warp.dev/terminal/command-palette): search for "Open AI Rules"
* From the Settings panel: **Settings** > **AI** > **Knowledge** > **Manage Rules**
  * Here, you can manage both Global as well as Project Rules.
* From the macOS Menu: `AI > Open Rules`
* From the Slash Commands menu: `/open-project-rules` to open Project Rules directly in Warp's code editor

<figure><img src="https://769506432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAULCelT4yIUOcSwWWvPk%2Fuploads%2Fgit-blob-e9984714550343faa2746aaf7d263fd3606c6c84%2Fproject-scoped-rules-pane.png?alt=media" alt=""><figcaption><p>Project Rules UI open in a Rules pane</p></figcaption></figure>

## How to create, edit, or delete Rules

#### Global Rules

* **From Warp Drive Rules pane:** **Personal** > **Rules** > **Global**\
  Add, edit, or delete any number of rules. Each rule can include:
  * Name (optional)
  * Description (what the rule does and when to apply it)
* **From the Slash Commands menu:** `/add-rule` in Auto or Agent input modes to create a new Global Rule (automatically opens the Warp Drive Rules pane).

{% embed url="<https://www.loom.com/share/3a49462c01e149cf9c040130cebe1184?hideEmbedTopBar=true&hide_owner=true&hide_share=true&hide_title=true>" %}
Rules Demo (legacy) with just Global Rules. Project rules can also be found there.
{% endembed %}

#### Project Rules

* **When in a directory, set up Project Rules with a slash command:** Use `/init` in Auto-Detection or Agent Mode to:
  * Begin indexing your codebase or display indexing status
  * Generate an `AGENTS.md` file with initial context, or
  * Link an existing Rules file to `AGENTS.md`
    * Warp currently supports linking the following external Rules files: `CLAUDE.md`, `.cursorrules`, `AGENT.md`, `GEMINI.md`, `.clinerules`, `.windsurfrules`, `.github/copilot-instructions.md`

To view all Project Rules and open them in Warp, access it via the Warp Drive Rules pane: **Personal** > **Rules** > **Project-based**

### Rules as Agent context

When relevant, Agents automatically pull in applicable rules to guide their responses. Rules used in an interaction will appear in the conversation under **References** or marked as derived from a specific rule.

<figure><img src="https://769506432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAULCelT4yIUOcSwWWvPk%2Fuploads%2Fgit-blob-87a00de59467e7881853e667870d0e3f72d04fe8%2Fcontext-derived-from-memory.png?alt=media" alt="Context derived from memory"><figcaption><p>Derived from rules</p></figcaption></figure>

<figure><img src="https://769506432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAULCelT4yIUOcSwWWvPk%2Fuploads%2Fgit-blob-580cbe282a47aa93d4ee6e6b0063f003a1629aa1%2Fcontext-references-memory.png?alt=media" alt="Context derived from memory"><figcaption><p>Rules as references</p></figcaption></figure>

### Rules privacy

See our [Privacy Page](https://docs.warp.dev/support-and-community/privacy-and-security/privacy) for more information on how we handle data with Rules.