Quickstart

Get up and running with PuzldAI in minutes

Install

npm install -g puzldai

Or try without installing:

npx puzldai

Prerequisites

PuzldAI orchestrates existing CLI tools. Install the ones you want to use:

Agent	CLI	Install
Claude	Claude CLI	Follow Anthropic docs
Gemini	Gemini CLI	Follow Google docs
Codex	Codex CLI	Follow OpenAI docs
Ollama	Ollama	curl -fsSL https://ollama.ai/install.sh | sh
Mistral	Vibe CLI	Follow Mistral docs

You only need ONE CLI installed to start. Claude and Ollama have the best agentic mode support.

Check Available Agents

puzldai check

This shows which CLIs are installed and ready.

First Run

Interactive TUI

puzldai

On first launch in a new directory, you’ll see a trust prompt. This is a security gate (like Claude Code) asking if you trust PuzldAI to read, edit, and execute files in that workspace.

Single Task

puzldai run "explain recursion"

Compare Agents

puzldai compare "best error handling practices" -a claude,gemini

Basic Commands

Chat

Just type your message in the TUI. Auto-routing picks the best agent.

Compare

/compare claude,gemini "your task"

Switch Agent

/agent claude

Help

/help

Keyboard Shortcuts

Shortcut	Action
Enter	Send message
Escape	Go back / Hide view
Ctrl+E	Expand last result
Ctrl+C	Cancel operation
Tab	Autocomplete command
↑/↓	Navigate history

Next Steps

Workflows & Automation

Pipeline & Workflows, Autopilot mode

Multi-Agent Modes

Compare, Debate, Correction, Consensus

Agentic Mode

LLMs explore your codebase and propose edits

Configuration

Models, routing, and settings