Skip to main content

Installation

Requirements​

  • iOS 17.0 or later on iPhone or iPad
  • An ACP-compatible agent server to connect to

Download​

Grab Agmente from the App Store. The app is free—you provide the agent server.

First launch walkthrough​

  1. Add a server – Tap + or Add Server and fill in:
    • Name: Display name (for example, “Gemini Local”).
    • Protocol: ws for local, wss for secure/remote.
    • Host: Server address (for example, localhost:8765 or my-tunnel.trycloudflare.com).
    • Path: Usually empty; use /message for Vibe.
    • Working directory: Optional path sent to the agent when creating sessions.
  2. Connect to the server – Tap the server, then Connect. The status should show Connected.
  3. Initialize the client – Tap Initialize to exchange ACP capabilities. Status changes to Initialized.
  4. Create a session – Tap + or New Session in the sessions area. A new chat appears in the sidebar.
  5. Start chatting – Send a message and watch the agent respond and execute tools in real time.

Understanding the interface​

Server list​

Displays each configured server with connection status and active session count.

Session sidebar​

Organizes sessions by time (Today, Yesterday, This Week, Older). Tap a session to view the transcript.

Chat view​

Shows your messages, agent responses (Markdown), tool calls, and any agent thoughts returned by the server.

Troubleshooting​

Connection failed​

  • Verify the server is running and reachable.
  • Confirm the URL, including port.
  • For local servers, ensure your device is on the same network.
  • For wss:// connections, verify SSL certificates.

Initialization failed​

  • The agent may not support ACP or needs the --experimental-acp flag.
  • Check the agent console for errors.
  • Restart the agent server and try again.

Session creation failed​

  • If you set a working directory, ensure the path exists on the agent host.
  • Try leaving the working directory empty.
  • Some agents require specific configuration before accepting sessions.

Next steps​