DoiT Cloud Intelligence CLI

dci is the command-line interface for the DoiT Cloud Intelligence API. Manage budgets, reports, alerts, and run analytics queries directly from your terminal.

Installation

# macOS (Homebrew)
brew install doitintl/dci-cli/dci

# Windows (WinGet)
winget install DoiT.dci

# Windows (Scoop)
scoop bucket add doitintl https://github.com/doitintl/dci-cli
scoop install dci

# Linux (.deb)
sudo dpkg -i dci_*_linux_amd64.deb

# Linux (.rpm)
sudo rpm -i dci_*_linux_amd64.rpm

Prebuilt binaries for all platforms are available on the Releases page.

Getting Started

On first run, dci automatically configures itself and opens a browser window for authentication via the DoiT Console. You can also sign in explicitly:

# Sign in to the DoiT Console
dci login

# Check your CLI configuration
dci status

# List your budgets
dci list-budgets

# List reports as a table
dci list-reports

# Run an analytics query
dci query body.query:"SELECT * FROM aws_cur_2_0 LIMIT 10"

Usage

# See all available commands
dci --help

# Get help for a specific command
dci list-budgets --help

Output Formats

The default output format is table. Override it with the --output flag:

dci list-budgets --output json
dci list-budgets --output yaml
dci list-budgets --output table

Table Options

# Wrap long cell values instead of truncating
dci list-budgets --table-mode wrap

# Show only specific columns
dci list-budgets --table-columns id,name,amount

Updating

# macOS (Homebrew)
brew update && brew upgrade dci

# Windows (WinGet)
winget upgrade DoiT.dci

# Windows (Scoop)
scoop update dci

Authentication

By default, dci authenticates interactively via the DoiT Console (OAuth). For CI pipelines and non-interactive environments, set the DCI_API_KEY environment variable:

export DCI_API_KEY=<your-api-key>
dci list-budgets --output json

When DCI_API_KEY is set, the CLI skips the browser-based login and authenticates using the API key directly. Run dci status to verify the active auth method.

Configuration

Configuration is stored in your OS user config directory:

OS	Path
macOS	~/Library/Application Support/dci/apis.json
Linux	~/.config/dci/apis.json
Windows	%APPDATA%\dci\apis.json

The config file is created automatically on first run. Delete it to reset to defaults.

AI Agent Skill

This repo ships a reusable agent skill at skills/dci-cli that teaches AI coding agents how to operate the dci CLI safely and effectively.

Install it with the built-in subcommand:

dci skill claude   # installs to ~/.claude/skills/dci-cli/
dci skill codex    # installs to ~/.codex/skills/dci-cli/
dci skill kiro     # installs to ~/.kiro/skills/dci-cli/
dci skill gemini   # installs to ~/.gemini/skills/dci-cli/

Run dci skill --help for the full list of supported agents.

Alternatively, for Codex you can use the skill-installer helper:

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  --repo doitintl/dci-cli \
  --path skills/dci-cli

License

See LICENSE for details.