Skip to main content

​
CLI Client

The @igentai/dim-cli package provides a command-line interface for non-interactive workflows, scripting, and CI/CD integration with Diminuendo.

​
When to Use

  • Automating session management in scripts or CI/CD pipelines
  • Triggering agent runs from cron jobs or webhooks
  • Batch operations across multiple sessions or projects
  • Integration with other command-line tools

​
Quick Start

cd clients
npm install
npm run dev:cli

​
Architecture

The CLI uses the TypeScript SDK directly for gateway communication: 
CLI Commands → TypeScript SDK → WebSocket + REST → Diminuendo Gateway

​
Features

  • Session management (create, list, join, archive, delete)
  • Turn execution with streaming output
  • Project and automation management
  • File operations (list, read, download)
  • JSON output mode for programmatic consumption
  • Configuration via environment variables or config file