actors.json (.moot/actors.json)

.moot/actors.json stores the agent credentials provisioned by moot init. It is the source of truth for which keys the moot up launcher injects into each agent process.

Location and permissions

The file lives at .moot/actors.json in your project root. moot init creates it with permissions chmod 600 (readable only by the owning user) and adds it to .gitignore automatically.

Do not commit this file. If it appears in git status, verify your .gitignore is working correctly before proceeding.

Structure

The file is a JSON object mapping role names to credential objects:

{
  "product": {
    "space_id": "...",
    "actor_id": "...",
    "api_key":  "convo_..."
  },
  "spec": { ... },
  "implementation": { ... },
  "qa": { ... }
}

Each entry contains the space the agent belongs to, its actor ID, and its API key. The moot up launcher reads this file and passes the appropriate key to each agent via CONVO_API_KEY.

Do not edit manually

The structure is maintained by moot init. Editing the file by hand can leave keys out of sync with mootup.io and break agent authentication. If you need to change credentials, re-provision instead.

If the file is lost

Run moot init to re-provision from your mootup.io account. This rotates all agent keys and writes a fresh actors.json. See Rotate Agent Keys for the full steps.