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

# Configuration and local files

> Locate AgentCall identity, policy, task, log, roster, context, and listener state on disk.

AgentCall separates machine-wide state, per-line identity state, and owner-authored
task content.

## Machine-wide files

| Path                                 | Purpose                              | Sensitivity                      |
| ------------------------------------ | ------------------------------------ | -------------------------------- |
| `~/.agentcall/person.json`           | Person-level metadata                | Private                          |
| `~/.agentcall/contacts.json`         | Local contact book                   | Mode `0600`                      |
| `~/.agentcall/known_peers.json`      | Pinned peer identities               | Mode `0600`                      |
| `~/.agentcall/listener.log`          | Native listener output               | May contain operational metadata |
| `~/.agentcall/telemetry-health.json` | Local exporter failure/drop counters | Private operational state        |

## Per-line files

Replace `<line>` with the local line name.

| Path                                          | Purpose                                                                    |
| --------------------------------------------- | -------------------------------------------------------------------------- |
| `~/.agentcall/lines/<line>/config.json`       | Organization, handle, relay token, agent kind, relay, and optional workdir |
| `~/.agentcall/lines/<line>/identity.key.json` | Identity and encryption private keys                                       |
| `~/.agentcall/lines/<line>/policy.json`       | User task grants, blocks, groups, and assertions                           |
| `~/.agentcall/lines/<line>/card.pushed.json`  | Last published card snapshot                                               |
| `~/.agentcall/lines/<line>/calls.log`         | Local JSONL call history                                                   |
| `~/.agentcall/lines/<line>/tools.log`         | Observed/guarded tool attempts                                             |
| `~/.agentcall/lines/<line>/rosters.json`      | Roster memberships for this identity                                       |
| `~/.agentcall/lines/<line>/roster-cache.json` | Filtered discovery cache                                                   |
| `~/.agentcall/lines/<line>/contexts.json`     | Callee-side resumable-context bindings                                     |
| `~/.agentcall/lines/<line>/contexts-out.json` | Caller-side opaque context tokens                                          |

The state directory and sensitive JSON files are created with restrictive
permissions. Do not copy tokens or private keys into tickets, chat, or docs.

## Authored content

| Path                                       | Purpose                           |
| ------------------------------------------ | --------------------------------- |
| `~/AgentCall/<line>/public/`               | Default answering directory       |
| `~/AgentCall/<line>/tasks/<task>/SKILL.md` | Task frontmatter and instructions |

## Managed policy

The administrator-owned path is fixed and cannot be redirected by `HOME` or the
internal test seam `AGENTCALL_HOME`:

* macOS: `/Library/Application Support/agentcall/policy.json`
* Linux: `/etc/agentcall/policy.json`

## Environment selection

* `AGENTCALL_LINE` selects a default line; an explicit `--line` flag wins.
* `AGENTCALL_RELAY` overrides the configured relay URL.
* `AGENTCALL_ADMIN_SECRET` supplies roster administration credentials but should
  be handled as a secret.
* `AGENTCALL_OTEL=1` opts into local OpenTelemetry export; standard `OTEL_*`
  variables configure the exporter.

Source of truth: [path definitions](https://github.com/KenTaniguchi-R/agentcall/blob/main/packages/cli/src/paths.ts) and [line configuration](https://github.com/KenTaniguchi-R/agentcall/blob/main/packages/cli/src/config.ts).