Skip to content

Repository files navigation

dx — CLI for Deductive AI

Ask questions about your infrastructure from the terminal. Get AI-powered insights, investigate incidents, and debug issues — all without leaving your shell.

Install

Homebrew (macOS / Linux)

brew tap deductive-ai/dx
brew install dx

One-line install

curl -fsSL https://raw.githubusercontent.com/deductive-ai/dx/main/install.sh | bash

GitHub Releases

Download the latest binary for your platform from Releases.

Build from source

go install github.com/deductive-ai/dx@latest

Quick start

# Just ask — setup runs automatically on first use
dx ask "what services are unhealthy right now?"# Pipe data for analysis
kubectl get pods -A | dx ask "which pods are in trouble?"# Interactive session (multi-turn)
dx

Investigating incidents

# Deep root cause analysis
dx investigate "why is the payments service returning 500s?"# Pipe logs for thorough analysis
kubectl logs deploy/api --tail=200 | dx investigate "root cause this error spike"# Interactive investigation
dx investigate

When to use ask vs investigate

  • dx ask — quick answers where you expect follow-ups. Good for iterative exploration: ask a question, get a response, refine with follow-ups. Sessions auto-resume so conversation flows naturally.
  • dx investigate — detailed root cause analysis that goes deep. Use when the first answer needs to be comprehensive. The AI explores more paths, uses more tools, and produces a thorough analysis upfront.

Need a quick answer you'll build on? dx ask. Need the full picture in one shot? dx investigate.

Example session

$ dx
Creating session...
Endpoint: https://app.deductive.ai | Session: a1b2c3d4
Type your questions. Use /help for commands. Press Ctrl+D to exit.
dx> what pods are failing in production?
Based on the current cluster state, I found 3 pods in CrashLoopBackOff...
dx> /new
Creating session...
Endpoint: https://app.deductive.ai | Session: e5f6g7h8
dx> what's the p99 latency on the payments service?

Commands

CommandDescription
dxStart an interactive session (same as dx ask)
dx askAsk Deductive a question (setup on first use)
dx investigateDeep root cause analysis
dx setupConfigure endpoint, auth, and skills
dx infoShow status, version, and diagnostics
dx upgradeUpgrade to the latest version
dx teamList and switch teams

Run dx --help for full details.

Setup & Configuration

Configuration is stored in ~/.dx/ and managed via dx setup.

# Run setup wizard (endpoint + auth)
dx setup init
# Re-authenticate
dx setup auth
# Install agent skill (Cursor, Claude Code, Copilot, Codex)
dx setup skill install
# Reset all configuration
dx setup reset
# View current config
dx setup config

Team Management

# List teams
dx team
# Switch to a different team
dx team switch <name-or-id>

License

Apache License 2.0 -- see LICENSE for details.

About

CLI for Deductive AI

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages