Skip to main content

Support

Need help? Email [email protected] for bug reports, feature requests, privacy questions, or account issues.

Frequently asked questions​

What AI agents work with Agmente?​

Agmente supports both ACP and Codex app-server server types.

Popular options:

  • Gemini CLI — npx @google/gemini-cli --experimental-acp
  • Claude Code — via Zed adapter
  • Qwen — qwen --experimental-acp
  • Vibe — vibe-acp
  • Codex app-server — codex app-server (local or remote endpoint)
  • Goose, Kimi CLI, and other ACP implementations

See the local agent guide for setup.

Why can't I connect from my iPhone to localhost?​

localhost only works in the iOS Simulator. On a physical device, use your computer's IP (for example, 192.168.1.100:8765). For remote access, use Cloudflare Tunnel.

Why does session creation fail with ENOENT?​

The working directory you entered does not exist on the agent host. Provide a valid path that exists on the machine running the agent.

My sessions disappeared after restarting the app​

  • Agents with session/list (for example, Qwen) return sessions from the server.
  • Agents without session/list store session IDs locally.

If sessions disappeared, make sure you are connecting to the same server and that the agent process was not restarted.

How do I delete a server or session?​

  • Delete a server: tap the server → ⋯ → Delete.
  • Delete a session: swipe left on the session in the sidebar → Delete.

Can I use Agmente with ChatGPT or other chat APIs?​

No. Agmente speaks ACP, which targets coding agents that can read/write files and execute tools. Standard chat APIs do not implement ACP.

Is my data sent to your servers?​

No. Agmente is client-only. Data goes directly to the agent servers you configure and is stored on your device. See the Privacy Policy.

How do I update the app?​

Updates ship through the App Store. Enable automatic updates or update manually.

Why is the agent not responding?​

  1. Ensure the agent server (and bridge) is running.
  2. Confirm API keys (for example, GEMINI_API_KEY).
  3. Check network reachability.
  4. Verify the endpoint URL, port, and path.
  5. Make sure firewalls allow the connection.

Can I attach files other than images?​

Not yet. Image attachments (JPEG/PNG) are supported today. Other file types may be added later.

Troubleshooting​

Connection issues​

  1. Verify the agent is running:
lsof -i :8765
  1. Test locally:
curl http://localhost:8765
  1. Check network connectivity (same Wi-Fi, no blocked WebSockets).
  2. Review the server configuration: protocol, host with port, and path (/message for Vibe).

Agent errors​

ErrorLikely causeSolution
"Connection refused"Agent not runningStart the agent server
"Initialization failed"ACP not supportedAdd --experimental-acp flag
"ENOENT"Invalid working directoryProvide a valid path that exists on the agent host
"Unauthorized"Missing/invalid tokenCheck bearer token or Cloudflare credentials
"Timeout"Network or agent issueCheck connectivity, restart agent

App issues​

  • Crashes on launch: Force quit, relaunch, restart device, or reinstall. If it persists, email support with device + iOS version.
  • UI not updating: Pull to refresh or reconnect to the server. Force quit if needed.
  • High battery usage: Disconnect when idle and prefer Wi‑Fi over cellular.

Report a bug or request a feature​

Email [email protected] with:

  • iOS version and device model
  • App version (Settings → About)
  • Steps to reproduce (for bugs)
  • Expected vs. actual behavior
  • Screenshots if available