Skip to content
This repository was archived by the owner on Jul 13, 2026. It is now read-only.

DeepShell Version 1.3.1!

Choose a tag to compare

@ashes00 ashes00 released this 03 Sep 23:28
· 13 commits to main since this release

🎯 Overview

We're excited to announce DeepShell v1.3.1, a focused release that significantly improves the user experience through enhanced interactive mode capabilities, streamlined interface design, and comprehensive API key management features. This release transforms DeepShell into an even more professional and user-friendly LLM command-line interface.

✨ New Features & Enhancements

πŸ–₯️ Interactive Mode Line Editing Revolution

Complete terminal editing experience with GNU Readline integration

  • Arrow Key Navigation: Use ←/β†’ arrow keys to move the cursor within your input line
  • Command History: Use ↑/↓ arrow keys to recall and edit previous commands
  • Standard Terminal Shortcuts: Full support for Home, End, Ctrl+A, Ctrl+E, and other standard editing shortcuts
  • In-Place Editing: Edit your commands without having to retype entire lines
  • Backspace/Delete Support: Proper character deletion that works as expected

Before: Arrow keys produced strange characters, had to delete entire lines to make corrections
After: Professional terminal editing experience with full cursor control and command history

πŸ”§ Streamlined Settings Menu Architecture

Cleaner, more organized configuration interface

  • Unified API Key Management: Consolidated separate Gemini and OpenRouter API key options into a single "Manage API Keys" menu
  • Service Selection Flow: Choose your LLM service first, then manage its API keys
  • Reduced Menu Clutter: Streamlined from 10 to 9 main options for better navigation
  • Scalable Design: Easy to add new LLM services without menu bloat

New Menu Flow: Main Menu β†’ "Manage API Keys" β†’ Service Selection β†’ Existing Management Interface

πŸ”‘ Enhanced API Key Visibility & Management

Comprehensive API key administration capabilities

Immediate Active Key Display

  • Prominent Active Key Section: See your current API key details immediately upon entering API key management
  • Complete Information: Displays both nickname and full API key value for the active key
  • Smart Organization: Active Key Details β†’ All Keys Summary β†’ Management Options

Comprehensive Key Viewing

  • New Option 4: "Show all API keys & nicknames" in both Gemini and OpenRouter menus
  • Complete Key Information: View nickname, full API key value, and active status for all configured keys
  • Professional Formatting: Clean presentation with separators between multiple keys
  • Enhanced Troubleshooting: Easy verification of API key values and configuration

🎨 Interface & Documentation Improvements

Professional presentation and user guidance

  • Help Menu Formatting: Fixed alignment issues with longer command flags for consistent, readable help output
  • Code Documentation Cleanup: Removed all references to the original Python implementation for clarity
  • Language-Neutral Examples: Updated documentation to focus on the C implementation
  • Professional Codebase: Clean, maintainable documentation throughout

πŸ› οΈ Technical Improvements

Dependencies & Build System

  • GNU Readline Integration: Added libreadline-dev dependency for advanced terminal editing
  • Enhanced Makefile: Updated build system with readline linking and installation instructions
  • Cross-Platform Compatibility: Maintained support for both Linux and Windows (MSYS2/Mingw64)

Code Quality & Architecture

  • Unified API Management: New manage_api_keys_unified() function for scalable service management
  • Enhanced Error Handling: Improved user feedback and validation throughout
  • Memory Management: Enhanced cleanup and resource handling
  • Consistent Implementation: Standardized API key management across all LLM services

πŸ“Š What's Included

Complete Interactive Experience

  • Full terminal editing capabilities with cursor movement
  • Command history with up/down arrow navigation
  • Standard terminal shortcuts (Home, End, Ctrl+A, Ctrl+E, etc.)
  • Professional line editing without character corruption

Streamlined Configuration Management

  • Unified API key management interface
  • Immediate visibility of active API key details
  • Comprehensive key viewing and verification
  • Clean, organized menu structure

Enhanced User Interface

  • Professional help menu formatting
  • Consistent visual presentation
  • Clear, focused documentation
  • Improved navigation flow

πŸš€ Getting Started with New Features

Experience Enhanced Interactive Mode

# Start interactive mode with full editing capabilities
./deepshell -i

# Now you can:
# - Use arrow keys to move cursor
# - Use up/down arrows for command history
# - Use standard terminal shortcuts
# - Edit commands in-place

Streamlined API Key Management

# Access unified API key management
./deepshell -s
# Select "3. Manage API Keys"
# Choose your service (Gemini/OpenRouter)
# See active key details immediately
# Use option 4 to view all keys comprehensively

Professional Help Interface

# View the improved help menu
./deepshell -h
# Notice the clean alignment and formatting

πŸ”§ Installation & Dependencies

Updated Prerequisites

# Install dependencies (now includes readline)
sudo apt-get update
sudo apt-get install -y build-essential libcurl4-openssl-dev libjson-c-dev libreadline-dev

Build Instructions

# Clone and build
git clone https://github.com/ashes00/deepshell.git
cd deepshell
make clean && make

πŸ”„ Migration Guide

From v1.3.0

  • No Breaking Changes: All existing configurations and functionality preserved
  • Automatic Enhancement: Interactive mode improvements work immediately
  • New Dependencies: Install libreadline-dev for full functionality
  • Menu Changes: API key management now under unified "Manage API Keys" option

Recommended Actions

  1. Update Dependencies: Install libreadline-dev for enhanced interactive mode
  2. Explore New Features: Try the improved interactive mode and streamlined menus
  3. Test API Key Management: Experience the enhanced visibility and organization

🎯 What's Next

DeepShell v1.3.1 establishes a solid foundation for professional terminal interaction and streamlined configuration management. Future releases will focus on:

  • Additional LLM service integrations
  • Advanced conversation management features
  • Enhanced interactive mode capabilities
  • Performance optimizations and additional terminal features

πŸ“š Documentation

Full documentation with examples and tutorials is available in our README.md.

πŸ™ Acknowledgments

Special thanks to the community for feature requests, bug reports, and testing that made this release possible. Your feedback continues to drive DeepShell's evolution as the premier LLM command-line interface.


Download DeepShell v1.3.1 from the releases page or build from source.

Need Help? Check our README.md or open an issue on GitHub.

Happy Querying! πŸ€–βœ¨


πŸ” Technical Details

Files Modified

  • main.c - Help menu formatting improvements
  • settings.c - Unified API key management and enhanced displays
  • utils.c - GNU Readline integration for read_line() function
  • deepshell.h - Added readline headers and new function declarations
  • Makefile - Updated dependencies and build configuration
  • README.md - Updated installation instructions

New Dependencies

  • libreadline-dev - Required for advanced terminal editing capabilities

Performance Impact

  • Positive: Enhanced user experience with professional terminal editing
  • Neutral: No performance impact on LLM queries or API interactions
  • Improved: Faster configuration management with streamlined menus