doum-cli 0.1.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
  • ⚙️ Config TUI: Interactive configuration menu built with ratatui
  • 🌍 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

doum config
# LLM Settings → Providers → OpenAI → Edit API Key

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 config Manage configuration (TUI)
doum <input> Auto mode (LLM selects mode)

Documentation

Tech Stack

  • Language: Rust 2024
  • Terminal UI: dialoguer, ratatui (config TUI)
  • 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