LoopCLI
Back to docsFeaturesPricingContact
Login / Sign Up
Back to docs
Guides / Installation

Installation

Set up LoopCLI on macOS, Linux, or Windows in a few minutes.

1. Prerequisites

  • Node.js 18 or later
  • npm 9+
  • Access to your LoopCLI dashboard account

2. Install the CLI

Install LoopCLI globally via npm:

npm install -g loopcli
loopcli --version

If the version prints successfully, you are ready to authenticate.

📦 NPM Package: View the latest version and release notes on npmjs.com/package/loopcli

3. Authenticate the CLI

loopcli auth login

Approve the device login request in your browser (we open https://app.loopcli.com/auth/device automatically). Once approved, the CLI stores the short-lived token in ~/.loopcli/config.json.

4. Initialize your first project

mkdir my-automation
cd my-automation
loopcli project init my-automation

This creates .loopcli/ in the current directory and links it to your workspace.

5. Next steps

  • Create your first loop with loopcli loop create hello --interactive
  • Explore the quick start guide for a guided walkthrough
  • Visit the CLI command reference for every available flag

Related Documentation

Continue learning with these related topics

Managing Projects

Projects keep your loops, secrets, and environments organized. This guide covers the full workflow—from creating a project to fixing stale IDs when your CLI and dashboard fall out of sync.

Execution History & Log Schema

LoopCLI records every loop run so you can audit results, spot failures, and measure usage. Each execution is stored with a rich payload that ties the run back to the project, user, connectors, and action counts.

Background Workflows

Keep servers, watchers, or queue workers running while LoopCLI continues to the next step.

Creating Workflows

LoopCLI workflows ("loops") combine HTTP calls and CLI commands. This guide walks you through drafting, testing, and deploying your first automation.