Skip to content

HeyAira

HeyAira connects AI chats (ChatGPT, Claude) and coding agents (Codex, Claude Code) to one project state. Think in chat: PRDs, docs, task definitions, reviews. Build with agents. Save your agent's limits for the code.

Chats and agents read and write the same project memory and tasks through one MCP server. A task sent from that state runs on your Mac with Codex or Claude Code, is checked by a separate verifier agent unless the task turns verification off, and ends as a pull request the server checks on GitHub.

Choose your path

For people

For agents

Use the agent contract before taking project action:

The boundary

Concern Source of truth
Files, branches, commits, and pull requests Git and GitHub
Decisions and durable project context HeyAira memory
Task definition, status, and handoff HeyAira tasks
What an agent did and how it was verified HeyAira workflow history and receipts
Provider accounts and GitHub publishing Your Mac (HeyAira Bridge)
Live prompt and model context The client or agent session

HeyAira stores references to repository state. It does not copy source code, credentials, or conversation transcripts into its database. Sending a task copies only the agent instruction files the catalog names (at most 60 KiB per agent).

Public endpoint

Every project has its own address:

https://mcp.heyaira.eu/p/<project-slug>/mcp

The service uses MCP Streamable HTTP. Public clients use OAuth 2.1 with PKCE; internal compatibility clients may use a project-scoped Bearer credential. The shared https://mcp.heyaira.eu/mcp is deprecated but still works and still issues new grants; connect new clients to the project's address. See the endpoint reference.

Documentation status

This site is built from the docs/ directory in the HeyAira repository and published from main. Contract changes update the relevant reference pages and tests in the same pull request. Pages marked as history explain why something exists; they do not describe the current state.