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

README.md

Shell Memory CLI