AgentsDock
Home Docs FAQ Discord
  • English
  • 简体中文

Support

Frequently asked questions

Common questions about AgentsDock — click a question to expand the answer. Can't find yours? Ask us and we'll add it here.

Why can't I see the latest Codex or Claude models in AgentsDock?

AgentsDock talks to the agent runtimes installed on the machine that runs your AgentsServer. The model list in the app comes from the Codex and Claude Code CLIs on that machine, so updating the AgentsDock app on your phone or laptop does not add new models.

How to get the latest models

  1. On the machine that runs AgentsServer (not the device you're connecting from), update the provider CLI:
    # Codex
    codex update
    codex --version
    
    # Claude Code
    claude update
    claude --version
  2. Back in AgentsDock, open Settings and click Recheck CLIs to refresh the model list. No server restart is needed.
  3. Still missing? Check that you're connected to the server you just updated, then check the provider side: your account or plan, your workspace's admin settings, and whether the model has rolled out to you yet. Updating the CLI makes a model visible; it doesn't grant access to it.

If you run more than one server, repeat the update on each — every server keeps its own CLIs.

Which platforms does AgentsDock run on?

The client runs on macOS, Windows, Linux, iPhone, iPad, and Android. The server side, AgentsServer, runs on macOS (Apple silicon) or Linux. See the client install guide for each platform.

Does AgentsDock see my code, prompts, or model requests?

No. AgentsDock runs provider CLIs such as Claude Code, Codex, OpenCode, and Cursor on your own machine. It never proxies your model requests. Limited usage analytics are on by default on desktop and Android; iOS and iPadOS do not send custom usage analytics. The current desktop Settings UI has no analytics switch, but a previously saved opt-out is still honored. See the privacy policy for what is collected and platform-specific controls.

Do I need Tailscale?

Tailscale is highly recommended. Outside your server's Wi-Fi or local network, you need it unless you already have a VPN or private network that lets your devices reach the server. On the same local network, you can use the server's local IP address. With Tailscale connected on both devices, use the server's private 100.x.x.x address without exposing its port to the internet. See the setup guide.

Can I connect to more than one server?

Yes. Add each server from the server menu at the top of the sidebar with Add Server, then switch between them any time. Each server keeps its own chats.

Do I need to restart AgentsServer after the server machine reboots?

Usually no. The installer registers AgentsServer as a user-level service, so it starts again when that service session comes back. On macOS that happens when the server user logs in; on Linux the user systemd service is enabled for the default target.

After the machine is back online, open AgentsDock and reconnect. If it does not come back, check the service status from Manage your server.

Where do I find my access token?

Run this on the server machine:

agentsdock token

Paste it into the Access token field when adding the server in the app.

Can I resume a chat I started outside AgentsDock?

Yes. Open Import chat from the / menu to pick from every Claude Code or Codex session on that machine, or choose Resume by session ID and paste the ID. Either way the full history comes with it. See Resume other chats.

How do I update AgentsDock and the server?

Both update from the app's Settings: click Check now, use Restart to update for the app, and use Update server or Retry server update when the server prompt appears. See Updates.

Is AgentsDock open source?

Yes. AgentsDock is open source in our GitHub repo. Stars are welcome.

No matching questions. Try another keyword, or ask us directly.

AgentsDock

An IDE designed for agentic AI research.© 2026 AgentsDock

Docs Support Report an issue Privacy Discord ↗