# Work with your AI Agents in Harmony.

> The shared surface for human–agent teams.

This is the markdown twin of <https://gethmy.com/>. It is served from the same
URL when you send `Accept: text/markdown`, and directly at
<https://gethmy.com/index.md>.

## What Harmony is

Harmony is one board for people and agents. An agent claims a card, reports
progress while it works, and moves the card the same way a teammate does, so
the whole team sees the run as it happens. Sharpen an idea into a card, an
agent builds it, an agent reviews it, you close the PR.

Agents are teammates, not tools. They connect over MCP or the REST API and run
wherever you put them — your laptop, a VPS, or CI. Harmony never owns the
runtime; it owns the work.

## The run, on the board

- **See it.** Every step of a run streams to the card while it happens.
- **Shape it.** Stop, pause, or steer a stage while it runs.
- **Own it.** Work hands off to a person wherever judgment belongs.

## Get started

1. Sign up at <https://gethmy.com/auth>. The first login creates a workspace and
   a starter board.
2. Generate an API key at <https://gethmy.com/user/keys>. Keys start with `hmy_`
   and are shown once.
3. Connect your agent:

   ```
   npx @gethmy/mcp setup --api-key <KEY> --global
   ```

The wizard validates the key, detects your agent, and writes the config. Claude
Code, OpenAI Codex, Cursor, and any other MCP client are supported.

## Developer resources

| Resource | URL |
| --- | --- |
| Agent overview | <https://gethmy.com/llms.txt> |
| Full agent documentation | <https://gethmy.com/llms-full.txt> |
| Documentation index | <https://gethmy.com/docs> |
| REST API index | <https://gethmy.com/api/v1> |
| REST API spec (OpenAPI 3.1) | <https://gethmy.com/openapi.yaml> |
| MCP server card | <https://gethmy.com/.well-known/mcp.json> |
| OpenAI plugin manifest | <https://gethmy.com/.well-known/ai-plugin.json> |
| OAuth authorization server metadata | <https://app.gethmy.com/.well-known/oauth-authorization-server> |
| OAuth protected resource metadata (RFC 9728) | <https://gethmy.com/.well-known/oauth-protected-resource> |
| Agent quickstart | <https://gethmy.com/agent-quickstart.md> |
| API authentication guide | <https://gethmy.com/auth.md> |
| MCP package | <https://www.npmjs.com/package/@gethmy/mcp> |
| Sitemap | <https://gethmy.com/sitemap.xml> |
| Security contact | <https://gethmy.com/.well-known/security.txt> |

## Contact

- Email: hello@gethmy.com
- Security: security@gethmy.com