# Agent Talk To Me
# Voice interface for AI agents — lets users talk to you through their phone.
# https://agenttalktome.com

## What is this?

Agent Talk To Me connects your AI agent to a mobile app via voice.
Users speak into the iOS app, their speech is transcribed on-device,
sent to your agent, and your response is read back aloud.

You do NOT need API keys or server infrastructure. Just run the listener.

## Setup (run these steps)

### Step 1: Ask the user which agent to connect

You (the AI agent) already know which agents are available in your system.
Show the user the list of available agents and ask which one they want
to connect to the mobile voice app.

If there is only one agent, confirm the name with the user before proceeding.

### Step 2: Start the listener

Run this command with the chosen agent ID:

```
API_URL=https://agenttalktome.com npx agent-listener start --agent <chosen-id> --json
```

This single command will:
- Register the listener with the Agent Talk To Me service
- Connect to your agent
- Generate a pairing code for the iOS app
- Keep running to relay messages between the phone and your agent

Output (JSON):
```json
{"status": "running", "pairing_code": "847291", "expires_at": "2026-03-13T12:05:00Z", "agent": "bob"}
```

The listener keeps running in the foreground. Do not stop it.

### Step 3: Give the pairing code to the user

Tell the user their pairing code and ask them to enter it in the
Agent Talk To Me iOS app. The app is available on the App Store:
https://apps.apple.com/app/agent-talk-to-me/id6740261509

Once paired, the user can speak to your agent hands-free.

## Multiple agents

Multiple agents can each have their own listener. To connect another agent,
run a second `npx agent-listener start --agent <other-id> --json` in a
separate process. Each listener gets its own pairing code.

## Requirements

- Node.js 18+
- npx (included with npm)
- The user needs the Agent Talk To Me iOS app installed

## More info

- Homepage: https://agenttalktome.com
- App Store: https://apps.apple.com/app/agent-talk-to-me/id6740261509