Shell Memory CLI

A CLI tool that learns from your terminal command patterns to automate repetitive workflows. It records command sequences, detects patterns, suggests time-saving shortcuts, and can generate shell scripts from natural language descriptions.

Features

• Command Recording: Save frequently used commands with descriptions and tags
• Pattern Detection: Automatically detect repeated command sequences and workflows
• Command Library: Personal searchable command library with tagging system
• Session Recording: Record terminal sessions for replay
• Script Generation: Generate shell scripts from natural language descriptions

Installation

# Clone the repository
cd shell-memory-cli

# Install dependencies
pip install -r requirements.txt

# Install the package
pip install -e .

Quick Start

Record a Command

# Add a command to your library
shell-memory cmd add "git status" -d "Check repository status" -t git -t vcs

# List all commands
shell-memory cmd list

# Search for commands
shell-memory cmd search git

Detect Patterns

# Detect patterns in your command history
shell-memory pattern detect

# View workflow statistics
shell-memory pattern stats

# Get suggestions for shortcuts
shell-memory pattern suggestions

Record Sessions

# Start recording a session
shell-memory session start my-workflow

# Record commands during the session
shell-memory session record "cd /path/to/project"
shell-memory session record "npm install"
shell-memory session record "npm test"

# Stop recording
shell-memory session stop

# List all sessions
shell-memory session list

# Replay a session
shell-memory session replay 1

# Export session as shell script
shell-memory session export 1 -o workflow.sh

Generate Scripts

# Generate a shell script from natural language
shell-memory script generate "deploy application to production"

# List available templates
shell-memory script templates

# Add a custom template
shell-memory script add-template deploy production "#!/bin/bash\necho deploying..."

Configuration

Set environment variables to customize behavior:

Variable	Description	Default
SHELL_MEMORY_DB	Path to SQLite database file	~/.shell_memory/shell_memory.db
SHELL_MEMORY_HOME	Base directory for data	~/.shell_memory
SHELL_MEMORY_VERBOSE	Enable verbose output	false
SHELL_MEMORY_FORMAT	Output format (table, json, plain)	table

Commands Reference

Command Management (cmd)

• shell-memory cmd add <command> - Add a command to library
• shell-memory cmd list - List all commands
• shell-memory cmd search <query> - Search commands
• shell-memory cmd delete <id> - Delete a command
• shell-memory cmd similar <command> - Find similar commands

Pattern Detection (pattern)

• shell-memory pattern detect - Detect patterns in command history
• shell-memory pattern suggestions - Get workflow shortcuts
• shell-memory pattern stats - View workflow statistics

Session Recording (session)

• shell-memory session start [name] - Start recording
• shell-memory session record <command> - Record a command
• shell-memory session stop - Stop and save session
• shell-memory session list - List all sessions
• shell-memory session replay <id> - Replay a session
• shell-memory session export <id> - Export as script

Script Generation (script)

• shell-memory script generate <description> - Generate script
• shell-memory script templates - List templates
• shell-memory script add-template <keywords> <description> <template> - Add template

License

MIT