Installation

Install script

On macOS, Linux (glibc), and WSL, install the latest release with the script hosted at loop.soket.ai:

curl -fsSL https://loop.soket.ai/install | bash

The script detects the OS and CPU, downloads the matching archive from soketlabs/loop releases, verifies the published .sha256, and installs loop to ~/.loop/bin. It skips the download when that version is already installed. It appends that directory to the current shell’s config (~/.zshrc, ~/.bashrc, fish, and the same family of files) when the directory is not already on PATH. Pin v0.3.4, or leave the shell config alone:

curl -fsSL https://loop.soket.ai/install | bash -s -- --version 0.3.4
curl -fsSL https://loop.soket.ai/install | bash -s -- --no-modify-path

--version accepts 0.3.4 or v0.3.4. --no-modify-path leaves the shell config alone. --force reinstalls even when that version is already present. Set LOOP_INSTALL_DIR to choose another directory. A release with no checksum is refused unless LOOP_ALLOW_UNVERIFIED=1. From a clone of this repository, ./install.sh runs the same download. ./install.sh --binary /path/to/loop copies a local binary into the install directory. ./install.sh --help prints the flags. If the new directory is not on PATH yet, start a new shell or run:

export PATH="$HOME/.loop/bin:$PATH"

Supported platforms

OS	Architecture	Status
macOS (Apple Silicon)	arm64	Supported
macOS (Intel)	x86_64	Supported
Linux (glibc)	x86_64, arm64	Supported. Release binaries are built on Ubuntu 22.04
Linux via WSL	x86_64, arm64	Supported. Uses the Linux build
Windows (native)	x86_64	In testing. The zip is published; the installer is not officially supported
Linux (musl, for example Alpine)	any	Not supported. Build from source

Running the script under Git Bash on Windows is experimental and only updates PATH inside Git Bash. For PowerShell or cmd, download the zip below and add loop.exe to PATH.

Release archives

You can also download an archive yourself from the v0.3.4 release.

Asset	Platform
`loop-x86_64-unknown-linux-gnu.tar.gz`	Linux x86_64
`loop-aarch64-unknown-linux-gnu.tar.gz`	Linux ARM64
`loop-x86_64-apple-darwin.tar.gz`	macOS Intel
`loop-aarch64-apple-darwin.tar.gz`	macOS Apple Silicon
`loop-x86_64-pc-windows-msvc.zip`	Windows x64

Verify the installation:

loop version

Release binaries are the default build: one agent, sessions, tools, compaction, sandboxing, and MCP. Tracing and /workflow are compile-time features and are not in that binary. Build from source to enable them.

Build from source

Loop requires Rust 1.85+. SQLite is bundled.

git clone https://github.com/soketlabs/loop.git
cd loop
cargo build --release -p loop-cli

The binary is at target/release/loop.

sudo cp target/release/loop /usr/local/bin/

Optional features

Each feature pulls in its crate. Combine them when you want more than one.

Feature	Enables
`telemetry`	`/tracing` and `--trace-*` on `--print`
`orchestration`	`/workflow`

cargo build --release -p loop-cli --features telemetry
cargo build --release -p loop-cli --features orchestration

Optional: desktop app

loop-desktop needs Rust nightly. It shares config and the harness with the CLI. Live /workflow cards are CLI-only.

export RUSTUP_TOOLCHAIN=nightly
cargo run -p loop-desktop -- /path/to/project

Authentication

Sign up at console.soket.ai and create an API key to use Soket in Loop. On first launch, Loop asks you to connect a provider unless a key is already in the environment. Inside the TUI, run /login soket and paste the key:

/login
/login soket
/login openrouter
/login openai
/login custom

Or set a key before starting:

export SOKET_API_KEY="your-api-key"
# also accepted, in this order: TENSORSTUDIO_API_KEY, then LOOP_API_KEY
export OPENROUTER_API_KEY="sk-or-…"
export OPENAI_API_KEY="sk-…"

Keys typed in /login are stored in ~/.loop/agent/auth.json (mode 0600). Custom endpoints from /login custom are saved in settings.json, not in the shell. Loop does not pick a model for you. After a provider is connected, choose one with /model or pass --model provider/id.

Directory structure

Path	Purpose
`~/.loop/agent/settings.json`	Global settings, including custom providers and tracing
`~/.loop/agent/auth.json`	API keys (mode 0600)
`~/.loop/agent/models.json`	Hand-written OpenAI-compatible providers
`~/.loop/agent/models-store.json`	Cached `/v1/models` catalogs
`~/.loop/agent/sessions.db`	SQLite sessions
`~/.loop/agent/themes/`	Custom themes
`~/.loop/agent/skills/`	Agent skills (`SKILL.md`)
`~/.loop/agent/mcp-auth/`	OAuth tokens for remote MCP servers (mode `0600`)
`~/.loop/agent/prompts/`	Prompt templates
`~/.loop/agent/extensions/`	Rhai extensions
`~/.loop/agent/hooks/`	Declarative hooks
`~/.loop/agent/keybindings.json`	Keybinding overrides

Override the config root with LOOP_CODING_AGENT_DIR.

Print the resolved paths:

loop config

Optional: container sandbox

Sandboxed execution needs Podman. The default sandbox mode is off.

macOS
Linux

brew install podman
podman machine init
podman machine start

# Ubuntu/Debian
sudo apt install podman

# Fedora
sudo dnf install podman

See the Sandbox guide.

Next steps

Quick Start

Your first session with Loop.

Providers

Soket, OpenRouter, OpenAI, and custom endpoints.

Getting Started

Guides

Features

Installation

Install script

Supported platforms

Release archives

Build from source

Optional features

Optional: desktop app

Authentication

Directory structure

Optional: container sandbox

Next steps

Quick Start

Providers

​Install script

​Supported platforms

​Release archives

​Build from source

​Optional features

​Optional: desktop app

​Authentication

​Directory structure

​Optional: container sandbox

​Next steps

Quick Start

Providers

Install script

Supported platforms

Release archives

Build from source

Optional features

Optional: desktop app

Authentication

Directory structure

Optional: container sandbox

Next steps