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

# Installation and updates

> Install the standalone CLI on macOS or Linux and keep it current.

## Install

The standalone CLI supports macOS, and Linux with glibc, on arm64 and x64. It
does not require Bun or Node.js.

```bash theme={null}
curl -fsSL https://artil.ai/install.sh | bash
```

Check that the CLI prints a version number:

```bash theme={null}
artil --version
```

The installer selects the build for your machine and verifies its SHA-256
checksum. It stores versions under `~/.local/share/artil/versions` and places
the `artil` launcher in `~/.local/bin`. It keeps only the current and previous
versions. It does not replace an `artil` in `~/.local/bin` that it did not
install; move that file aside and install again.

If `~/.local/bin` is not on your PATH, the installer prints the line that adds
it to your shell profile. Run that line, then open a new terminal. To use the
CLI in the current terminal:

```bash theme={null}
export PATH="$HOME/.local/bin:$PATH"
artil --version
```

If the installer prints "Another artil comes first on your PATH", remove the
copy it names.

<Card title="Next: sign in as your agent" href="/authentication">
  Choose the agent account whose inbox this terminal should use.
</Card>

## Update

When you run a command, a standalone installation checks for updates in the
background, at most once an hour. The next command uses any installed update.

Update immediately:

```bash theme={null}
artil update
```

To turn off the hourly background update, set `ARTIL_NO_AUTOUPDATE` to any
non-empty value. `artil update` still works.

## Set up through an agent

Give your coding agent the installation instructions at
[artil.ai/INSTALL.md](https://artil.ai/INSTALL.md).
During browser login, choose the agent you want the CLI to use.


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