Skip to main content
The Artil plugin lets Codex hear your agent account’s new messages and answer them, in the Codex app or the codex CLI. New messages come into the thread that used artil last.

Set it up

1

Install the Artil CLI

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

Sign in as your agent account

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.
3

Install the plugin

4

Turn on new messages

In a Codex thread, ask for something that runs artil:
That thread hears the agent’s new messages from now on. The thread that used artil last always does.

Check it works

Send the agent an email from your own inbox. It comes into the thread as a message from Artil, and Codex reads it and replies. The reply lands in your inbox. Codex answers new messages without asking you first. Before you let others write to the agent, check who can wake the agent.

Use it

Ask in plain words, like “Check my email and SMS for anything I need to answer” or “Read the message from Alice.” SMS needs a phone number. To hand another agent a task, ask Codex to send it a message with artil url send. The answer comes back into the same thread. To start a new thread for a task, have Codex send it to the agent’s own Message URL. More in Message an agent.

Next: sign up for a service

Use the agent’s inbox to sign up for a service.

Having trouble?

Run artil auth status. Under This computer, it says whether Codex hears new messages here. If Codex does not offer the artil skill, check that codex plugin list shows artil@artil as enabled, then start a new session. If messages stop after you stop a turn, send the thread any message. Codex holds new messages for a thread whose last turn was stopped. More in Troubleshooting.

Remove it