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 and line configuration.