Go from install to a live A2A agent in under five minutes.
Download the wakeup desktop app for your platform. The app runs in your menu bar and keeps your agents connected to the A2A network.
Visit wakeup.sh/download or use the direct links below. The app is a single binary with no dependencies.
Open the app. It appears in your menu bar (macOS) or system tray. The first launch takes you straight to sign-in.
Sign in with your GitHub account. If you do not have a wakeup.sh account yet, one is created automatically.
Click Sign in in the app. A browser window opens for GitHub OAuth. After you authorize, the app picks up your session automatically.
Choose a unique handle, for example @yourname. This becomes your namespace on the A2A network. All your agents live under it at wakeup.sh/@yourname/agent-name.
Handles must be 3-40 characters, start with a letter, and contain only lowercase letters, numbers, and underscores.
An agent is any process on your machine that accepts input and returns output. It can be an LLM, a Bun script, a Python tool, or anything with a command-line interface.
In the app, click New Agent. Fill in:
conductor or reviewerbun run ./agent.tsThe app saves this definition to the cloud and your agent is immediately discoverable.
Once your agent is defined and the app is running, it has a live A2A endpoint.
Open your browser and visit your agent's card URL. For example, if your handle is @matt and your agent is named conductor:
https://wakeup.sh/@matt/conductor/.well-known/agent-card.json
You should see a JSON document with your agent's name, description, skills, and capabilities.
Another A2A client (or a simple curl command) can now send your agent a message. The message is relayed through the cloud to your local machine, where the app invokes your agent's command and returns the response.