Configuration & layout

~/.agentsync/ is just files. Use the CLI or edit them in $EDITOR — both are first-class. There is no hidden internal representation: the TOML structs that parse these files are the canonical model.

Directory layout

• Directory~/.agentsync/

  • agentsync.toml agents, update defaults, secrets backend
  • Directorymcp/

    • github.toml one MCP server per file
  • Directorymarketplaces/

    • anthropic.toml one marketplace per file
  • Directoryplugins/

    • atlassian.toml one plugin enablement per file
  • Directorymemory/

    • AGENTS.md canonical memory
    • Directoryfragments/ reusable @import pieces

      • …
  • Directoryskills/

    • Directorymy-skill/

      • SKILL.md standalone skills
  • Directorysecrets/

    • secrets.age age-encrypted vault
  • ignore.toml paths reconcile should stop tracking
  • Directory.state/ machine-local bookkeeping (gitignored)

    • …

Override the directory’s location with AGENTSYNC_HOME.

agentsync.toml

The top-level config: which agents are registered, update defaults, and the secrets backend.

~/.agentsync/agentsync.toml

# Registered agents and whether each is enabled.
[[agents]]
name    = "claude"
enabled = true

[[agents]]
name    = "opencode"
enabled = true

# Secrets backend — see the Secrets guide.
[secrets]
backend       = "age"
recipient     = "age1…"                              # public key, safe to commit
identity_file = "${env:HOME}/.config/agentsync/age.key"  # private key, per-machine

Note

Use the CLI (agentsync agent add, agentsync secrets set, …) and let it write these files, or hand-edit them — agentsync re-reads the files either way. The exact key set is validated by agentsync verify and surfaced by agentsync doctor.

Per-component files

File	Holds
mcp/<name>.toml	one MCP server (guide)
marketplaces/<name>.toml	one marketplace (guide)
plugins/<id>.toml	one plugin enablement (guide)
memory/AGENTS.md + fragments/	canonical memory (guide)
skills/<name>/SKILL.md	standalone skills
secrets/secrets.age	the age-encrypted vault (guide)

Project overlay

A repo can carry a .agentsync.toml marker at its root that merges onto your user config. See Project-local config.

State

~/.agentsync/.state/ is gitignored machine-local bookkeeping: the last-applied hashes (targets.json) that make drift detection possible, the apply lock, the two-phase write staging dir, first-apply backups, and the marketplace/plugin cache. Keys are stored ${HOME}-relative so state is portable across machines.