> ## Documentation Index
> Fetch the complete documentation index at: https://docs.artil.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Pi

> Give Pi tools to check your agent's email and SMS and reply from its identity.

The Artil extension lets Pi list, read, and reply to email and SMS using
your agent's CLI login.

Before starting, install [Pi](https://pi.dev) and the [Artil CLI](/installation).
The Pi package is not published on npm yet. You need a local copy of the
Artil Pi package, unpacked into a folder.

## Connect your inbox

<Steps>
  <Step title="Install the extension">
    Replace the path with your extracted package folder, the one containing
    `package.json` and `extensions`:

    ```bash theme={null}
    pi install /path/to/package
    ```

    Pi saves the package in its configuration and loads it in new sessions.
  </Step>

  <Step title="Sign in and start Pi">
    ```bash theme={null}
    artil auth login
    artil auth status
    pi
    ```

    Select your agent in the browser and check its identity in status before
    starting Pi. For a remote machine, use
    [headless authentication](/authentication#use-a-headless-machine).
  </Step>

  <Step title="Read a message and reply">
    Send a test email to your agent's address. Then ask Pi:

    ```text theme={null}
    Check my email, read my test message, and reply saying "Connected."
    ```

    Check your inbox for Pi's reply.
  </Step>
</Steps>

## Available tools

| Tool | What it does |
| - | - |
| `artil_email_list` | List incoming emails. |
| `artil_email_read` | Read an email by its message ID. |
| `artil_email_reply` | Reply from the agent's email address. |
| `artil_sms_list` | List incoming texts. |
| `artil_sms_read` | Read a text by its message ID. |
| `artil_sms_reply` | Reply from the agent's phone number. |

Ask Pi to “Check both inboxes for anything I need to answer” or “Read the
message from Alice.” Pi chooses the tools needed for the task. Lists default
to ten messages and can return up to 25. A reply uses the original message to
choose its recipient. SMS needs [Personal SMS setup](/sms).

The extension works within a running Pi conversation. It does not start a
session when a message arrives or link the agent's stored secrets. The
[CLI](/email#send-a-new-email) can also compose new messages.

## Having trouble?

Check `artil auth status` in the terminal that starts Pi. If the tools are
missing, check `pi list` and start a new session. For channel or access errors,
follow [message troubleshooting](/troubleshooting#email-or-sms-is-unavailable).

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

Use the same package path you installed:

```bash theme={null}
pi remove /path/to/package
```

Start a new Pi session to continue without the extension.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.