DeepSeek Rust CLI Agent 🚀

An autonomous AI software engineer and CLI assistant powered by DeepSeek. This project was developed with the assistance of Gemini CLI.

⚠️ Note: This project is currently in a Testing & Development phase. Use it at your own risk.

✨ Features

• 🧠 Advanced Reasoning: Real-time display of the model's thinking process (DeepSeek Reasoning).
• 🛠️ Extensible Toolset: 35+ tools managed by a trait-based registry system for reliable and fast execution.
• 🐚 Stateful Shell: Persistent working directory (CWD) support — cd commands update the agent's environment state.
• 🎨 Rich TUI Engine:
  • 4-Line Dynamic Footer: Real-time status, folder info, token usage, and command queue.
  • Horizontal Queue: Visualize pending and executing tasks at a glance.
  • Syntax Highlighting: Instant coloring for tool results (JSON, Rust, Python, etc.) and streaming code blocks.
• ⌨️ Advanced Input: Full cursor control (Home, End, Left, Right), Bracketed Paste support, and persistent history.
• 🛑 Robust Control: Instant abort via Esc with automatic message cleanup to keep conversation context valid.
• 🔄 Optimized CI/CD: Parallelized matrix builds with mold linker and sccache for lightning-fast automation.
• 🔐 Security: Mandatory tool approvals and strict path validation to prevent unauthorized operations.

📖 Documentation

Comprehensive documentation is available in the docs/ directory and can be viewed as an mdBook:

• Architecture: Core component breakdown and execution flow.
• Tools: Detailed list of available tools and their capabilities.
• Contributing: Guidelines for setting up the development environment.

🚀 Quick Install

Linux & macOS

curl -fsSL https://raw.githubusercontent.com/mahirgul/deepseek-rust-cli/main/install.sh | bash

Windows (PowerShell)

iwr https://raw.githubusercontent.com/mahirgul/deepseek-rust-cli/main/install.ps1 -useb | iex

Cargo

cargo install --git https://github.com/mahirgul/deepseek-rust-cli

🛠️ Configuration

The tool requires a DeepSeek API Key. Create a .env file in your project or set it as an environment variable:

export DEEPSEEK_API_KEY="your_api_key_here"

Optional settings are stored in .deep/config.json and can be managed via the /config slash command.

GitHub Integration (Optional)

export GITHUB_TOKEN="ghp_xxxxxxxx"

📖 Usage

Run the agent:

deepseek-rust-cli

Slash Commands:

• /help - Show help menu
• /model <name> - Show or switch current AI model
• /sessions - List all chat sessions
• /resume <id> - Switch to/resume a session
• /undo - Undo last file/shell action
• /tokens - Show current token usage
• /savemem <msg> - Save critical info to .deep/memory.md
• /export - Export session to Markdown
• /update - Check for and install the latest version
• /clear - Clear terminal screen
• /forget - Wipe current history from disk
• /auto - Toggle auto-approve mode
• /info - Show detailed session info
• /config <key> [value] - View or modify configuration
• /temperature <value> - Set model temperature
• /retry - Regenerate last assistant response
• /exit, /quit - Close the application

Example Interactions:

> Create a PR merging feature-branch into main with title "Add login system"
> Search for TODO comments in the codebase
> Find all functions that use the deprecated API
> List open issues in rust-lang/rust

🏗️ Building from Source

Ensure you have Rust installed.

git clone https://github.com/mahirgul/deepseek-rust-cli.git
cd deepseek-rust-cli
cargo build --release

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.