Introduction

The Suzi CLI is the foundational layer of the entire Suzi platform. Every interface — the web dashboard, Telegram bot (Suzi Claw), and AI-assisted workflows — is built on top of the same CLI primitives. When Suzi Claw executes a command in a cloud sandbox, it's running the CLI. When the web dashboard deploys an agent, it's calling the same APIs the CLI uses.

This means anything you can do through the CLI, you can also automate, script, or build custom tooling around. The CLI is not just a developer convenience — it's the primary harness that powers the platform.

The current CLI surface is intentionally tighter than older releases. The main public entry points are start, resume, agents, run, portfolio, transactions, accounts, list-actions, list-triggers, skills, debug, share, import, preferences, and feedback.

If you want the power-user Telegram surface on top of the same primitives, read the Suzi Claw docs.

What You Can Do

• Create or resume AI-assisted agent sessions — use suzi start and suzi resume with Claude Code or Codex
• Deploy, inspect, and version agents — manage the full agent lifecycle from deploy to fork and pull
• Execute protocol actions directly — use suzi run for one-off reads and writes without deploying an agent
• Discover live schemas — inspect actions and triggers with suzi list-actions and suzi list-triggers
• Script the CLI cleanly — use suzi --help --json and suzi <command> --json --no-input
• Monitor and debug — inspect portfolio, transactions, logs, runs, and database-backed execution records

Getting Started

# Install the CLI
npm install -g suzi-cli

# Sign in
suzi login

# See the current command surface
suzi

# Start building an agent with AI assistance
suzi start

For automation and LLM workflows, start with:

suzi --help --json
suzi run polymarket.deposit --help

From here, explore the CLI Reference for the full command documentation, check out Suzi Claw for the Telegram interface, or read the Agent SDK if you are writing agent code directly.