🚀 T-Store

Terminal Command Store - Save frequently used terminal commands with easy-to-remember aliases.

✨ Features

• 🎯 Command Aliases - Save long commands as short, memorable names
• 📦 Interactive Dashboard - Beautiful TUI to manage all commands
• 🔧 PATH Integration - Run aliases directly without tstore prefix
• 📝 Full CRUD - Add, edit, delete, and view stored commands
• 🚀 Zero Config - Works out of the box
• 💻 Cross Platform - Works on Linux, macOS, and Windows

📦 Installation

Via npm (Recommended)

npm install -g @vp21/t-store
# or
bun install -g @vp21/t-store

Via GitHub Releases (Standalone Binary)

Download the latest binary for your platform from GitHub Releases.

# Linux/macOS
chmod +x tstore-linux
cp tstore-linux /usr/local/bin/tstore

# Windows
# Add tstore-windows.exe to your PATH

🚀 Quick Start

1. Setup PATH (One-time)

Add this to your ~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish:

export PATH="$HOME/.tstore/bin:$PATH"

Then reload your shell:

source ~/.zshrc  # or source ~/.bashrc

2. Open Dashboard

tstore

3. Add Your First Command

tstore add

Or use the dashboard to add commands interactively!

📖 Usage

Dashboard

tstore

Opens an interactive TUI to manage all commands.

Add Command

tstore add
# Follow the prompts to enter name, command, and description

Example:

• Name: tqnpm
• Command: clear; export AWS_PROFILE=tq; npm run dev
• Description: Run dev with tq AWS profile

List Commands

tstore list

Run Command

# Via tstore
tstore tqnpm

# Or directly (after PATH setup)
tqnpm

Edit Command

tstore edit

Delete Command

tstore delete

Setup Help

tstore setup

💡 Use Cases

• Environment Switching: dev, staging, prod profiles
• Project Commands: start, build, deploy with project-specific settings
• Complex Commands: Multi-step commands with environment variables
• Workflow Automation: Repeated terminal workflows

📁 Storage

Commands are stored in:

• JSON Database: ~/.tstore/commands.json
• Executable Scripts: ~/.tstore/bin/

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📝 License

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

⭐ Show Your Support

If you find T-Store helpful, please give it a star on GitHub!

Made with ❤️ for the terminal-loving developer