# Installation
Limitless CLI is a single Rust binary called `limit`. Choose whichever method
fits your platform.
## Via Cargo (Rust — all platforms)
```bash
cargo install limitless-cli
```
Requires a Rust toolchain (https://rustup.rs). The `limit` binary is installed
to `~/.cargo/bin`; make sure that directory is on your `PATH`.
## Build from source (all platforms)
```bash
git clone https://github.com/limitless-cli/limitless.git
cd limitless
cargo build --release
# binary at target/release/limit
```
## Via Homebrew (macOS)
Once a `limitless-cli` tap is published:
```bash
brew install limitless-cli
```
Until the tap is live, use the Cargo method above.
## Via apt (Ubuntu / Debian)
Once a `limitless-cli` .deb is published to a PPA:
```bash
sudo add-apt-repository ppa:limitless-cli/ppa
sudo apt-get update
sudo apt-get install limitless-cli
```
Until the PPA is live, use the Cargo method above.
## Via Chocolatey (Windows)
Once a `limitless-cli` chocolatey package is published:
```bash
choco install limitless-cli
```
Until the package is live, use one of:
```bash
cargo install limitless-cli
# or download the release .zip and add the extracted folder to PATH
```
## Via npm (Node.js)
Binaries are also shipped as an npm package so Node developers can install
with their existing tooling:
```bash
npm install -g limitless-cli
```
## Verifying the install
```bash
limit --version # → limit 1.0.0
limit --help # full command guide
limit # first environment audit
```
`limit` writes its preferences to `~/.limitless/config.json` on first run and
never requires elevated privileges for its read-only scans.