doum-cli 0.2.0

AI-powered terminal assistant that helps you with command-line tasks.
Documentation

doum-cli

🤖 AI-Powered Terminal Assistant - Natural language interface for OS commands

Rust License: MIT

Features

  • 💬 Ask Mode: Get answers to technical questions
  • 🔍 Suggest Mode: Command suggestions with copy/execute options
  • 🎯 Auto Mode: LLM automatically selects the appropriate mode
  • 🔐 Secret Management: Secure API key storage with OS keyring
  • ⚙️ Config Management: Simple config commands (set/get/unset/show/reset)
  • 🌍 Multi-Provider: Support for OpenAI (GPT) and Anthropic (Claude)

Quick Start

Installation

Using Installation Script (Recommended)

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/junhyungL/doum-cli/main/scripts/install.sh | sh

Windows (PowerShell):

iwr -useb https://raw.githubusercontent.com/junhyungL/doum-cli/main/scripts/install.ps1 | iex

From GitHub Releases

Download the latest binary for your platform from Releases:

  • Linux (x86_64): doum-linux-x86_64.tar.gz
  • macOS (Intel): doum-macos-x86_64.tar.gz
  • macOS (Apple Silicon): doum-macos-aarch64.tar.gz
  • Windows (x86_64): doum-windows-x86_64.zip

Extract and add to your PATH.

Using Cargo

cargo install doum-cli

Setup API Key

# Configure OpenAI secret (interactive)
doum secret openai

# Or set via environment variable (if keyring doesn't work)
# PowerShell:
$env:OPENAI_SECRET='{"api_key":"sk-..."}'

# Bash/Zsh:
export OPENAI_SECRET='{"api_key":"sk-..."}'

Usage Examples

# Ask questions
doum ask "What is Docker?"

# Get command suggestions
doum suggest "find large files"
→ Select option → Choose Copy/Execute

# Auto mode
doum "check disk usage"

Commands

Command Description
doum ask <question> Ask questions and get answers
doum suggest <task> Get command suggestions and execute
doum secret <provider> Configure API keys (openai/anthropic)
doum switch Switch LLM provider or model
doum config <subcommand> Manage configuration (show/set/get/unset/reset)
doum <input> Auto mode (LLM selects mode)

Documentation

Tech Stack

  • Language: Rust 2024
  • Terminal UI: dialoguer
  • Secret Storage: keyring (OS-level credential store)
  • LLM: OpenAI GPT, Anthropic Claude

Development

# Build
cargo build --release

# Run tests
cargo test

# Run
./target/release/doum-cli

License

MIT License - see LICENSE for details

Acknowledgments