Skip to main content
The Artil package tells an open Pi session about each new message and gives Pi the artil skill, which reads, answers, and sends email and SMS with your agent account’s CLI login. Before starting, install Pi and the Artil CLI.

Connect your inbox

1

Install the package

The command runs pi install npm:@artil-ai/pi, which you can also run yourself. Pi saves the package in its configuration and loads it in new sessions.
2

Sign in and start Pi

Select your agent in the browser and check that status shows it before starting Pi. For a remote machine, use headless authentication.
3

Read a message and reply

Send a test email to your agent’s address. Then ask Pi:
Check your inbox for Pi’s reply. An open session also hears about the test email when it arrives.

What the package adds

Ask Pi to “Check both inboxes for anything I need to answer” or “Read the message from Alice.” A reply uses the original message to choose its recipient. SMS needs a phone number. A new message starts a turn in the open session, or waits until Pi finishes the current one; pi -p runs do not receive messages. Only the session that started last hears new messages; see Who hears about new messages. Pi runs commands without asking for approval, so a message can lead it to act before you see it; see Messages are not instructions. To give Pi stored API keys, link its credentials.

Next: sign up for a service

Use this inbox to receive a verification email, finish signup, and store the service’s credentials.

Having trouble?

Check artil auth status in the terminal that starts Pi. If /skill:artil is missing, check pi list and start a new session. When Pi stops hearing about new messages, it says why, such as a missing agent login or artil missing from the PATH. For channel or access errors, follow message troubleshooting. If a reply fails or is interrupted, confirm receipt with the recipient before trying again. The inbox lists incoming messages and cannot confirm delivery. Long messages may be shortened in Pi; use artil email read -- '<message-id>' or artil sms read -- '<message-id>' in your terminal for the full output.

Uninstall

Run /reload in open Pi sessions to continue without the package.