Overview

The ADK-TS CLI (@iqai/adk-cli) is a comprehensive command-line toolkit designed for professional AI agent development. Built with TypeScript and NestJS, it provides a complete development environment from project scaffolding to production deployment.

Installation

Install globally with:

npm install -g @iqai/adk-cli

yarn global add @iqai/adk-cli

pnpm add -g @iqai/adk-cli

bun add -g @iqai/adk-cli

Key Features

Development & Testing

• Project Scaffolding – Generate projects from professional templates (Discord bots, web servers, MCP servers, etc.)
• Interactive Chat Interface – Terminal-based chat with markdown rendering for rapid agent testing
• Web UI – React-based visual interface for agent management and testing
• Hot Reload – Live code reloading during development with customizable watch paths
• Smart Agent Discovery – Automatic scanning with .gitignore awareness and path filtering

Production & Deployment

• RESTful API Server – Full-featured HTTP server for agent management and messaging
• OpenAPI Documentation – Auto-generated Swagger docs for ADK server API endpoints
• Health Monitoring – Built-in health checks and status endpoints
• Session Management – Persistent conversation sessions with state management
• Event Streaming – Real-time events via Server-Sent Events (SSE)

Developer Experience

• Multi-Package Manager Support – Auto-detection and support for npm, pnpm, yarn, and bun
• Intelligent CLI UX – Interactive prompts, spinners, and progress indicators
• Debug Mode – Comprehensive logging and diagnostics
• Cross-Platform – Full support for Windows, macOS, and Linux

Requirements

• Node.js v22.0 or higher
• Package Manager: npm, yarn, pnpm, or bun
• TypeScript support (handled automatically)

Commands Overview

• adk new – Create new ADK projects from maintained templates
• adk run – Run agents with interactive chat, server mode, or hot reload
• adk web – Launch web interface for visual agent development and testing
• adk serve – Start standalone API server for production deployment

Quick Start Example

# Create a new agent project
adk new my-ai-assistant --template simple-agent
cd my-ai-assistant

adk run

Next Steps