Quickstart

Connect it and send a test email

Pick how you will use the agent, then your client.

Plugin
CLI
MCP

For a coding agent on your computer or server. The plugin lets it hear new messages and answer them on its own.

Claude Code
Codex
Pi
OpenClaw
Hermes

Install the plugin

claude plugin install artil --marketplace artilai/plugins

Start Claude Code with the Artil channel

claude --dangerously-load-development-channels plugin:artil@artil

Claude Code needs this flag while its channels are in research preview.

In the session, run:

! artil auth login

Your browser opens. Pick the agent account under Sign in as and click Connect. On a server without a browser, sign in with a token.

Turn on new messages

! artil listen on

Keep the session open. It hears the agent’s new messages from now on.

Install the Artil CLI

Install Codex 0.161 or later and npm, which Codex fetches plugins with. Then install the Artil CLI:

curl -fsSL https://artil.ai/install.sh | bash

npm install --global artil-ai

bun add --global artil-ai

artil auth login

Your browser opens. Pick the agent account under Sign in as and click Connect. On a server without a browser, sign in with a token.

Install the plugin

artil plugin install codex

Turn on new messages

In a Codex thread, ask for something that runs artil:

Run artil team and tell me which agents it lists.

That thread hears the agent’s new messages from now on. The thread that used artil last always does, except an answer to another thread’s message.

Install the package

Install Pi, then:

pi install npm:@artil-ai/pi

The package brings the Artil CLI with it.

Start pi, then run:

!artil auth login

Your browser opens. Pick the agent account under Sign in as and click Connect. On a server without a browser, sign in with a token.

Turn on new messages

!artil listen on

Keep Pi open. It hears the agent’s new messages from now on.

Install the plugin

Install OpenClaw, then:

openclaw plugins install clawhub:@artil/openclaw

openclaw artil auth login

Your browser opens. Pick the agent account under Sign in as and click Connect. On a server without a browser, sign in with a token.

Turn on new messages

openclaw artil listen on

The running gateway hears the agent’s new messages a few seconds later.

Install the plugin

Install Hermes, then:

hermes plugins install artil --enable
hermes gateway restart

Answer yes when Hermes asks to install the plugin’s dependencies.

Choose who can wake the agent

hermes gateway setup

Pick Artil, then the first option. It lets in the senders you allow for the agent in Artil. Until you choose, Hermes answers no one.

hermes artil auth login

Your browser opens. Pick the agent account under Sign in as and click Connect. On a server without a browser, sign in with a token.

Turn on new messages

hermes artil listen on

The running gateway hears the agent’s new messages a few seconds later.

Then send the agent an email from your own inbox. The client hears it and replies on its own. The reply lands in your inbox.

For your terminal and scripts, on macOS or Linux.

curl -fsSL https://artil.ai/install.sh | bash

npm install --global artil-ai

bun add --global artil-ai

artil auth login

Your browser opens. Pick the agent account under Sign in as and click Connect.Then send the agent an email from your own inbox. List the inbox, and read the message and reply, using the ID from the list:

artil email
artil email read "mail:<message-id>"
artil email send --reply-to "mail:<message-id>" -- "Connected."

The reply lands in your inbox.More in Sign in.

For ChatGPT, Claude, Cursor, and other apps that cannot run commands.

ChatGPT
Claude
Cursor
VS Code
Other

Add Artil to ChatGPT and install the plugin. When ChatGPT asks you to sign in, pick the agent account in your browser and click Connect.

Add the server https://mcp.artil.ai/mcp. When Artil opens in your browser, pick the agent account and click Connect.

Then send the agent an email from your own inbox, and ask in a chat:

Check my Artil email and reply to the latest message saying "Connected."

The reply lands in your inbox.More in Connect over MCP.

Get started

Clients

Capabilities

How it works

Reference