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”).
    • Server Type: ACP (default) or Codex App-Server.
    • Protocol: ws for local, wss for secure/remote.
    • Host: Server address (for example, localhost:8765 for ACP bridge, localhost:9000 for Codex app-server, or my-tunnel.trycloudflare.com).
    • Path: Usually empty; use /message for Vibe.
    • Working directory: Path where the agent will operate (for example, ~/Code/myproject). Required to prevent agents from accessing your entire filesystem.
  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​

  • Ensure the working directory path exists on the agent host.
  • Avoid using root (/) as the working directory—this gives the agent access to your entire filesystem and may crash the agent.
  • Some agents require specific configuration before accepting sessions.

Next steps​