CLI Reference

Complete reference for all intu CLI commands

Installation

npm install -g intu-dev

Or build from source:

go build -o intu .

Global Flags

Commands

intu init <project-name>

Bootstrap a new intu project with all scaffolding, including YAML configuration files, TypeScript boilerplate, and a sample channel.

intu init my-project --dir /tmp

intu c <channel-name>

Quick alias to add a new channel to the current project. Creates the channel directory, channel.yaml, transformer.ts, and validator.ts.

intu c adt-inbound --dir .

intu channel add <channel-name>

Add a new channel to the project. Functionally identical to intu c.

intu channel add lab-results --dir .

intu channel list

List all configured channels in the project. Supports filtering by profile, tag, and group.

intu channel list --dir . --profile prod

intu channel describe <channel-id>

Show detailed configuration for a specific channel, including its source, transformers, validators, and destinations.

intu channel describe sample-channel --dir .

intu validate

Validate all YAML configuration and TypeScript files in the project. Returns a non-zero exit code if errors are found.

intu validate --dir .

intu build

Compile TypeScript transformers and validators. Runs npm run build (which invokes tsc) inside the project directory.

intu build --dir .

intu serve

Start the runtime engine to process messages through configured channels. Loads configuration, boots all enabled channels (respecting dependency order), initializes message storage, alerting, and metrics, then processes messages until interrupted.

intu stats [channel-id]

Show channel statistics. When a channel ID is provided, displays stats for that specific channel; otherwise shows aggregate stats for all channels.

intu deploy [channel-id]

Mark channels as enabled and deployed. Without a channel ID, use --all or --tag to target multiple channels.

intu undeploy <channel-id>

Remove a channel from deployed state.

intu enable <channel-id>

Enable a channel so it processes messages at runtime.

intu disable <channel-id>

Disable a channel to stop it from processing messages.

intu prune

Prune old message data from storage. Supports filtering by channel, date, and dry-run mode for previewing what would be removed.

intu dashboard

Launch the web-based dashboard for monitoring channels, viewing statistics, and managing configuration.

intu channel clone <source> <new-name>

Clone an existing channel to create a new one. Copies all files from the source channel directory and updates the channel ID in channel.yaml.

intu channel clone sample-channel hl7-inbound --dir .

intu channel export <channel-id>

Export a channel as a portable .tar.gz archive for sharing or backup.

intu channel export adt-inbound --dir . -o adt-inbound.tar.gz

intu channel import <archive-path>

Import a channel from a .tar.gz archive into the channels directory.

intu channel import adt-inbound.tar.gz --dir .

intu message list

List messages from the message store. Supports filtering by channel, status, and time range.

intu message list --channel adt-inbound --status ERROR --limit 20

intu message get <message-id>

Retrieve a specific message by its ID, including full content and metadata.

intu message count

Count messages in the store, optionally filtered by channel and status.