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

# Files and folders

> Where Archetype keeps settings, keys, records, logs and worktrees, and the environment variables that change it.

Paths are for macOS and Linux. `~/.config` is `$XDG_CONFIG_HOME` when it is set, and `~/.local/share` is `$XDG_DATA_HOME`.

## Settings

Your settings, a project's settings, the env file, instructions, skills and named agents: see [Configuration](https://docs.archetype.ing/en/reference/config.md). Also in `~/.config/archetype/`:

| What | Where |
| - | - |
| The app's folder list | `workspaces.json` |
| Keyboard shortcuts | `shortcuts.json` |
| Your own model providers | `providers/*.json` |

A flag wins over a project's settings, and a project's over yours. A project's config can narrow what the agent may do, never widen it: it cannot set the provider or model, allow edits or commands, add hooks or set a sandbox.

## Data

In `~/.local/share/archetype/`:

| What | Where |
| - | - |
| Each folder's conversations and records | `projects/<folder>-<id>/` |
| Chat channels' conversations | `chat/` |
| Worktrees of sessions and child agents | `worktrees/<folder>/<session>/` |
| Memory | `memory/` |
| Your permission mode and "always allow" | `permissions.json` |
| Keys the agent asked you for | `secrets/` |
| Archetype's ChatGPT sign-in | `auth/chatgpt.json` |
| Engines' extra accounts | `engine-accounts/` |
| Plugins' data | `plugin-data/<plugin>/` |

A session's worktree is on the branch `archetype/<session>`. Records are kept until you delete them; `"keepRecordsDays": 90` in your user config removes finished ones older than that.

## Logs

| What | Where |
| - | - |
| The background service | `~/.local/share/archetype/daemon/daemon.log`, or `archetype daemon logs -n 100 --follow` |
| Its service definition | macOS: `~/Library/LaunchAgents/ai.pairful.archetype.daemon.plist`; Linux: `~/.config/systemd/user/archetype-daemon.service` |

`archetype --doctor` checks the config, model, keys and record folder without calling a model.

## Environment variables

| Variable | What it does |
| - | - |
| `XDG_CONFIG_HOME` | Moves `~/.config` |
| `XDG_DATA_HOME` | Moves `~/.local/share` |
| `ARCHETYPE_NO_CONFIG=1` | Reads no config file, and only the built-in agents |
| `ARCHETYPE_NO_NETWORK=1` | Skips the update check and the online model list |
| `ARCHETYPE_NO_BROWSER=1` | Does not open a browser to sign in to an MCP server |
| `ARCHETYPE_INSTALL_DIR` | Where the install script puts `archetype` (default `~/.local/bin`) |
| `ARCHETYPE_WORK_NICE` | How much the agent's commands give way to the app (1–19, default 10; `off` turns it off) |
| `ARCHETYPE_PLAIN=1` | The terminal prints line by line instead of full screen |
| `ARCHETYPE_INLINE=1` | The terminal keeps its output in the scrollback instead of full screen |
| `ARCHETYPE_MOUSE=0` | The terminal leaves the mouse wheel and selection to your terminal |
| `NO_COLOR` | No colors in the terminal |

API keys are environment variables too; see [Accounts and keys](https://docs.archetype.ing/en/use/accounts.md).


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