> ## Documentation Index
> Fetch the complete documentation index at: https://docs.piebald.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Context

Piebald provides basic system and project context to the LLM, such as AGENTS.md and skills, and it also allows the LLM to gather context itself through specialized tools.

# Automatically-loaded context

AGENTS.md and skills are automatically loaded from your project directory and your home folder.  You can disable automatic context loading in **Settings → Agent Context**.

## AGENTS.md

<Badge color="blue">Available in Piebald Basic (Free)</Badge>

Piebald supports `AGENTS.md` ([https://agents.md/](https://agents.md/)).  It will automatically read it from the current directory and attach it to the current chat:

<img className="shadow-md rounded-xl" width="400" alt="Screenshot of a message with AGENTS.md attached" src="https://mintcdn.com/piebald/-AaSH-LxuVoxYcZl/imgs/v0-1-10/agents_md.png?fit=max&auto=format&n=-AaSH-LxuVoxYcZl&q=85&s=fa1e54059142d0ce7610669ddd105af8" data-path="imgs/v0-1-10/agents_md.png" />

### Alternative file names

While `AGENTS.md` is preferred, Piebald will also read from the following other common file names:

* `CLAUDE.md`
* `GEMINI.md`
* `CRUSH.md`
* `QWEN.md`
* `IFLOW.md`
* `WARP.md`
* `copilot-instructions.md`
* `.junie/guidelines.md`
* `.kiro/guidelines.md`
* [+ Add](https://github.com/Piebald-AI/piebald-issues/issues/new?title=Add+new+AGENT.md+alternative+file+name%3a%20)

If you'd like Piebald to support another file name, please [open an issue](https://github.com/Piebald-AI/piebald-issues/issues/new?title=Add+new+AGENT.md+alternative+file+name%3a%20)!

## Skills

Piebald also automatically reads and loads [skills](https://agentskills.io/) that you've created or installed locally in your project or globally.

Project-specific skills are read from the following locations:

* `<project root folder>/.claude/skills`
* `<project root folder>/.claude/commands`
* `<project root folder>/.agents/skills`
* `<project root folder>/.agents/commands`

Global skills are read from these locations, relative to your home folder:

* `~/.claude/skills`
* `~/.claude/commands`
* `~/.agents/skills`
* `~/.claude/commands`

Global skills are also discovered from Claude Code plugins.  The `~/.claude/plugins/installed_plugins.json` file is read and parsed and skills are gathered from each plugin's `skills` folder (e.g. `~/.claude/plugins/<plugin>/skills`).

# AI gathering context

## AI chat search

The [`SearchChats`](/features/agentic/builtin-tool-calls) tool allows the LLM to search your past chats.  It provides various options for searching chats:

* Keyword/exact/regex mode.
* Date range (before and after dates).
* Project and worktree paths to search in.
* Filtering by roles (user and AI).

There are also options to refine what messages are returned:

* Number of surrounding messages to include for extra context on each search result.
* Whether to include results from the current chat as the current chat is already available to the model.
* Maximum number of search results to return to the LLM. For example, the LLM might pass `1` for this option for a broad discovery search.

You can view the search results that the LLM sees by expanding the "Search chats for \[query]":

<img class="shadow-md rounded-xl" width="500" alt="search_chats_results.png" src="https://mintcdn.com/piebald/fyeqsH_2V9kEw196/imgs/search_chats_results.png?fit=max&auto=format&n=fyeqsH_2V9kEw196&q=85&s=8133f640bc612cf8a1ccaa47c77fce8b" data-path="imgs/search_chats_results.png" />