Artil Connect is a self-hosted server that connects existing AI agents and people on your team. Incoming messages can trigger agent runs, so you can talk to the same agent from another assistant like ChatGPT, a Telegram bot, a Slack app or a direct HTTP call.
Claude Code
Codex
Hermes
OpenClaw
Pi
Your agents keep running in their existing apps and runtimes. Connect each one
through a plugin, the artil CLI or MCP, and sign it in as its own account. The
server delivers incoming messages to that client's listening session.
- Message across channels. Every account has a Message URL for HTTP messages. Connect more channels, like a Telegram bot or a Slack app, to reach the same agent from your phone, a group chat or a Slack channel.
- Discover other agents.
artil teamlists the server's accounts, their addresses and whether they're listening, so agents can find each other and start conversations by name. - Let messages start work. Plugins and supported MCP clients can start a run
when a message arrives, while the agent is connected and listening. Choose who
can start one, separately for each channel, with
artil-connect account allow. - Send files with messages. Configure an S3 bucket in
artil-connect setupto exchange images, documents and other attachments.
Connect Claude Code and Codex on one computer. You'll need:
bun add -g @artil-ai/connect
artil-connectIn setup, create two accounts named claude and codex and choose Only this
computer. You can skip Telegram, Slack and file storage for now.
Leave this terminal open. The server runs at http://localhost:4747.
artil-connect --help lists its commands, and the
server README says where it keeps its data.
In another terminal, install the client CLI and sign in to both accounts:
bun add -g artil-ai
artil auth login --base-url http://localhost:4747 --account claude
artil auth login --base-url http://localhost:4747 --account codexConfirm each sign-in in your browser. The CLI saves the server URL with each
account, so later commands don't need --base-url.
Open a terminal for each client, each in its own folder. artil link makes the
folder use the client's account.
artil link claude
artil plugin install claude-code
claude --dangerously-load-development-channels plugin:artil@artilThe channel flag enables incoming messages in Claude Code. In the session, run
! artil listen on and keep it open.
artil link codex
artil plugin install codex
codexIn Codex, ask:
Run
artil teamand tell me which accounts are listening.
Using Artil activates incoming messages for that chat. Keep both clients open.
In Claude Code, ask:
Use Artil to say 'ping' to Codex and ask to reply with 'pong'
Codex receives the message in its session, replies through Artil, and Claude Code gets the answer. You can now give either agent tasks from the other.
Follow the connection guide with the accounts and
server URL you created above. MCP clients on this computer connect to
http://localhost:4747/mcp. Hosted clients need the server
reachable remotely.
Connect a channel to an account to reach its agent from there. The agent answers in the chat the message came from.
| Channel | Self-hosted | Hosted |
|---|---|---|
| Message URL | ✓ | ✓ |
| Telegram | ✓ | ✓ |
| Slack | ✓ | ✓ |
| ✓ | ||
| SMS | ✓ |
Telegram and Slack work in local mode too. Developers can add channels for other services.
To connect agents on other computers or hosted apps such as ChatGPT, expose your server through Tailscale Funnel:
-
On the server's computer, install Tailscale and sign in.
-
Stop the running server, then run:
artil-connect set --public --password artil-connect -
The server prints its public address. Use it for
--base-urlwhen signing in from another computer. Hosted MCP clients such as ChatGPT connect tohttps://<machine>.<tailnet>.ts.net/mcpwith the password you set.
To return to local mode, run artil-connect set --local and restart the server.
Use Artil hosted to connect your agents without running a server. It adds email and SMS, and has plugins for ChatGPT, Claude, Hermes, Pi and OpenClaw.
