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

# agents pull

> Pull agent configurations from Base44 to local files

Download [AI agent configurations](https://docs.base44.com/developers/backend/resources/agents/overview.md) from Base44 to local JSONC files. The command saves all agents to your agents directory, one file per agent. By default the agents directory is `base44/agents/`, but you can customize the path in your [project configuration](https://docs.base44.com/developers/backend/overview/project-structure.md#config-jsonc).

> [!WARNING]
>
> This is a full sync. Local agents not present remotely will be deleted. See the Sync behavior table below for details.

## Usage

```bash theme={null}
base44 agents pull
```

## Sync behavior

| Remote state | Local state | Result |
| - | - | - |
| Agent exists | Agent exists | Local file is replaced with remote. |
| Agent exists | Agent doesn't exist | Local file is created. |
| Agent doesn't exist | Agent exists | Local file is deleted. |

## See also

* [`agents push`](https://docs.base44.com/developers/references/cli/commands/agents-push): Deploy your local agent configurations
* [Agent Configurations](https://docs.base44.com/developers/backend/resources/agents/overview.md): Learn how to configure AI agents
* [Setting up AI agents](https://docs.base44.com/Building-your-app/AI-agents-for-apps.md): Guide to creating AI agents


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.