Skip to content

Projects and sources of truth

A project is the HeyAira tenant and security boundary. The authenticated credential selects the project; tools do not accept a caller-supplied project ID to decide authorization.

Ownership

  • Git owns files, branches, commits, and pull requests.
  • HeyAira owns project memory, tasks, receipts, and repository references.
  • The harness owns the live thread and model context.

Projects may reference multiple repositories. A repository reference is not a repository copy.

Project mismatch

If a requested task or memory does not exist in the authenticated project, the agent must stop. It must not create a duplicate, switch instances, or ask the operator to paste the whole task into another client as a workaround.