Skip to content

Start here

HeyAira keeps one project state that your AI chats and coding agents share. You plan, write PRDs and docs, define tasks and review results in ChatGPT or Claude. Codex or Claude Code does the building. Neither has to be told what the other did, because both read and write the same memory and tasks.

What works

Verified in production on 2026-10-04:

  • Shared project state. Project memory, decisions and tasks over MCP, from ChatGPT, Claude and Codex clients, with one address per project and OAuth sign-in.
  • Agent work on your Mac. A task with a repository, an agent and acceptance criteria is sent to the HeyAira Bridge on your Mac. The Bridge runs Codex CLI or Claude Code in a sandboxed Git worktree; a separate verifier agent checks every criterion (unless the task sets verification to none); the worker corrects itself once if the verifier asks; the Bridge opens the pull request; the server checks it on GitHub and records CI.
  • You hear about problems. A blocked task, failed checks or a missing pull request is pushed to the HeyAira iOS app. A CI failure can send the work back to the agent: only on the accepted commit, and only while GitHub still shows its pull request open with that commit as head.
  • Parallel work. Several tasks run at once on one Mac, up to the capacity it reports, and you can watch each agent session live in the Bridge app.

On 2026-10-04 five real tasks ran at once with no operator action: four ended as pull requests opened from the agents' work (two after a self-correction) and one was blocked with a reason and a push to the phone. Every agent pull request is still reviewed independently before it is merged.

Mental model

  1. Authenticate to one HeyAira project. Sign-in needs the project's access token, which only the operator issues (before the first sign-in).
  2. Recover the current context through server_identity and continuity_context.
  3. Use Git for files and code.
  4. Use HeyAira for decisions, task state, handoff, and work receipts.
  5. Send a configured task to an agent when you want it built.
  6. Confirm the state after a meaningful write.

What HeyAira is not

HeyAira is not a repository mirror, a conversation archive or a model router. Agents do not merge or deploy: the pull request is where their work stops and your review starts.

First safe check

After connecting a client, ask it to perform a read-only check using only HeyAira:

Use only HeyAira MCP. Call server_identity and continuity_context.
Report the resource, project, environment, service revision, open task count,
and available context. Do not write anything.

The client must not invent a project ID or use a different endpoint to fill in missing context.

Next