Get started

This walkthrough gets you from zero to a completed pipeline on your laptop: install the CLI, start the daemon, assemble a team, run it, and inspect the result. For the product story, see What is Cliq?. For building blocks (phases, gates), see Concepts.

Before you begin

Need	Notes
Node.js	26+ if you build from source; installer handles the released CLI
Network	To install the CLI and pull teams from CliqHub
An agent (optional for first demo)	`@cliq/hello-world` needs no API keys; Cursor/Claude/etc. for AI teams

1. Install

curl -fsSL https://getcliq.io/cliq/install | bash
cliq --version

Optional guided setup (agents & integrations):

cliq setup

cliq login
cliq daemon start
cliq daemon status

The daemon executes pipelines. The CLI is a client. Start the daemon once per session.

3. Create a project and run a team

mkdir hello && cd hello
cliq init
cliq assemble @cliq/hello-world
cliq run

When it finishes:

cliq status
cliq logs

You should see phases complete and a gate pass.

4. Try an AI team (optional)

cliq settings agents.cursor.api_key <your-cursor-api-key>
cliq assemble @cliq/hello-world-cursor-gate
cliq run -i task="Write a haiku about programming to haiku.txt"
cat haiku.txt
cliq logs

What just happened

You did not “chat with an agent.” You ran a team:

Phases ran in dependency order
Each phase left a recorded result for later steps
A gate had to pass before the run was done

That loop is the product. Concepts names every piece. More on assemble / inputs / resume: Running teams. Agents and params: Agents.

When you outgrow one laptop

Goal	What to do
CI / scripts calling Hub	`cliq auth token <name>` — Auth
Publish a team	`cliq team publish scope/slug`
Enroll another machine	Realm token on the realm page or `cliq realm token …` → `CLIQ_DAEMON_TOKEN`
Push work to a remote daemon	Hub dispatch — Hub API tab

Full command inventory: CLI and in-repo QUICKSTART.md.

​Before you begin

​1. Install

​2. Sign in and start the daemon

​3. Create a project and run a team

​4. Try an AI team (optional)

​What just happened

​When you outgrow one laptop