AgentsDock: an IDE designed for agentic AI research

What you can do

• Work with your agents: start and resume chats, follow live activity, and
  queue the next task.
• Review the results: view images and videos inline, browse files, inspect
  code changes, and download artifacts.
• Keep long-running work organized: group chats, search history, create
  digests, and schedule recurring jobs.
• Open a real terminal: use a persistent tmux terminal attached to each
  chat's workspace.
• Move between devices and servers: connect multiple clients to the same
  server, or manage several servers from one app.

How it works

AgentsDock is the client. AgentsServer
is the backend. Install the server on the machine that has your projects and
agent CLIs. That can be the same computer as the desktop app or a remote
machine you control. The desktop and mobile apps connect to it to send tasks
and display results.

The agent CLIs must be installed and authenticated on the server, not on
your phone. Self-hosting gives you control of the server and stored history;
it does not make the models local. Your selected provider still processes
model requests, and clients may cache content on your devices.

Get started

1. Install the app. Get a desktop build from
   public GitHub Releases
   (current stable),
   or find the current iPhone/iPad distribution link on
   the website.
2. Set up AgentsServer. Direct macOS and Linux builds provide
   Set up AgentsServer. For other clients or manual installation, follow
   the server's installation instructions.
   Install and sign in to the agent CLI you want to use on that machine.
3. Connect and start a chat. Add the server connection in AgentsDock,
   choose an agent and a working directory on the server, and send a task.

For remote access, use a private network such as Tailscale rather than exposing
the server directly to the internet. The server needs tmux for persistent
terminals; see its documentation for the full prerequisites. Connection help
is in the setup guide.

Develop from source

Use Git, Node.js 24, and pnpm 11.9.0 (the version pinned by the project).
Desktop and mobile are separate packages; install dependencies in the package
you are working on. You also need a running AgentsServer to use the app.

git clone https://github.com/ZhengyiLuo/AgentsDock.git
cd AgentsDock

Desktop

The current desktop app is built with Electron, React, and TypeScript. From
the repository root:

cd electron
pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm dev

pnpm build compiles the app without packaging or publishing it. For desktop
architecture and platform-specific packaging, see
electron/README.md.

Mobile: iPhone, iPad, and Android source

The current iPhone/iPad app lives in mobile-react/, using React Native
and Expo. Android source and native modules live in that same package. From
the repository root:

cd mobile-react
pnpm install --frozen-lockfile
pnpm typecheck
pnpm test:history
pnpm test:server-setup

For local iOS development on macOS with Xcode, continue in mobile-react/:

pnpm exec expo prebuild --platform ios
pnpm exec expo run:ios

Use a simulator or your own signing configuration. Read the
mobile development guide before installing on a
device: using the existing bundle identifier can replace your installed app.
Android development requires the Android toolchain.

Website

The product site is plain HTML, CSS, and JavaScript. With Python 3 installed,
run this from the repository root:

cd website
npm run dev

Open http://localhost:4175. No website dependency installation is needed.

Where things live

The maintained backend is in the separate
AgentsServer repository. Do not
deploy the server/ directory from this repository.

Contributing

See CONTRIBUTING.md for checks and contribution guidelines.
Keep changes scoped and add regression tests where appropriate. Use synthetic
test data; do not commit credentials, private infrastructure details, chat
transcripts, or screenshots containing user data.

The repository's CI verifies source. It does not publish desktop releases,
upload mobile builds, or deploy servers. Official binaries and update feeds
are managed separately; see release channels.

License

AgentsDock's original code is licensed under the Apache License 2.0,
except where a component explicitly states another license. See NOTICE
for attribution and separately licensed components. Existing third-party
copyrights, licenses, and notices remain in effect.