doum-cli

🤖 AI-Powered Terminal Assistant Terminal command helper powered by Large Language Models (LLMs) like OpenAI GPT and Anthropic Claude.

Features

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

System Requirements

Linux users:

• GLIBC 2.38 or higher is required (e.g., Ubuntu 24.04+)
• Older distributions (Ubuntu 22.04, Debian 11, etc.) are not supported due to GLIBC version requirements

macOS/iOS users: Service and user names cannot be empty (treated as wildcards)

Windows users: Multi-threaded access may not be serialized - access credentials from one thread at a time

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

Using Cargo

if you have Rust and Cargo installed, you can install via Cargo:

cargo install doum-cli

From GitHub Releases

• Download the latest binary for your platform from Releases
• Choose the appropriate version for your OS.
• Extract and add to your PATH.

Setup Secret

Before using doum-cli, you need to configure your LLM API keys.

# Configure OpenAI secret
doum secret openai

Storage Location by Platform

• Linux/FreeBSD/OpenBSD: DBus Secret Service (GNOME Keyring, KWallet)
• macOS/iOS: Local Keychain
• Windows: Windows Credential Manager

Switch Provider/Model

# Interactive provider/model selection
doum switch

Usage Examples

# Ask questions
doum ask "What is Docker?"

# Get command suggestions (auto-copied to clipboard)
doum suggest "find large files"

# Auto mode (LLM decides ask/suggest)
doum "check disk usage"

# Configure API keys (with verification)
doum secret

# Switch provider/model
doum switch

Commands

Documentation

• Quick Start - Installation and getting started
• Architecture - Architecture and module structure
• Commands - Detailed command reference

License

MIT License - see LICENSE for details