Docs

Start your first chat

Once your server is set up and connected, starting a conversation with an agent takes one click.

First, check you're connected

Open AgentsDock and check your server in the switcher. A green dot means the server is online and you're connected; a red dot means the app can't reach it.

AgentsDock server switcher — one server offline with a red dot, and the selected Mac Mini server online with a green dot — Green = connected and online. Red = not reachable.

To connect to a server you need two things: its address — the server's IP or hostname with port 7850 — and its access token. Add them in the app, then hit Test connection.

AgentsDock Add server form with a Server URL field, an Access token field, and a Test connection button — Add a server with its URL and access token, then **Test connection**.

Haven't set your server up yet? The Setup guide walks you through getting your server running and finding its address and access token, then connecting your device.

Start a chat

Click the + button at the top of the sidebar — the New chat button — or press ⌘N.

Click + to start a new chat and pick an agent.

In the dialog, choose:

a backend — Claude Code or Codex, running on your remote under your own account;
a working directory — the folder on your remote the agent will work in.

Then type your first message and press Enter to send. That's it — the agent runs on your server in that directory, and the chat keeps its own persistent terminal you can attach to from any device, anytime.

What next

Explore what else AgentsDock can do in Key features, or speed things up with Keyboard shortcuts.