{"id":51026681,"url":"https://github.com/gitstq/terminal-snippet-manager","last_synced_at":"2026-06-21T20:02:13.077Z","repository":{"id":361560634,"uuid":"1254930241","full_name":"gitstq/terminal-snippet-manager","owner":"gitstq","description":"⚡ Terminal Snippet Manager - A blazing fast CLI tool for managing code snippets. Built with Python and Rich.","archived":false,"fork":false,"pushed_at":"2026-05-31T07:15:24.000Z","size":31,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-31T09:10:36.308Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitstq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-31T07:11:05.000Z","updated_at":"2026-05-31T07:15:27.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitstq/terminal-snippet-manager","commit_stats":null,"previous_names":["gitstq/terminal-snippet-manager"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/terminal-snippet-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fterminal-snippet-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fterminal-snippet-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fterminal-snippet-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fterminal-snippet-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/terminal-snippet-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fterminal-snippet-manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34623906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-21T20:02:12.315Z","updated_at":"2026-06-21T20:02:13.070Z","avatar_url":"https://github.com/gitstq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 Terminal Snippet Manager\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Python-3.8+-blue.svg\" alt=\"Python 3.8+\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/License-MIT-green.svg\" alt=\"MIT License\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg\" alt=\"Platform\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003eEnglish\u003c/b\u003e | \u003ca href=\"README.zh-CN.md\"\u003e简体中文\u003c/a\u003e | \u003ca href=\"README.zh-TW.md\"\u003e繁體中文\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## 🎉 Introduction\n\n**Terminal Snippet Manager** is a blazing fast, terminal-native code snippet manager designed for developers who live in the command line. It helps you store, organize, search, and execute code snippets without ever leaving your terminal.\n\n### Why Terminal Snippet Manager?\n\nAs developers, we constantly reuse code patterns, commands, and configurations. Switching between browsers, GUI apps, and editors breaks our flow. Terminal Snippet Manager brings snippet management directly to where you work — the terminal — with a beautiful TUI interface powered by [Rich](https://github.com/Textualize/rich).\n\n### ✨ Key Features\n\n- ⚡ **Lightning Fast** — Written in Python with optimized fuzzy search\n- 🔍 **Smart Search** — Fuzzy matching with relevance scoring\n- 🏷️ **Tag System** — Organize snippets with custom tags\n- 🎨 **Syntax Highlighting** — Beautiful code display for 15+ languages\n- 📋 **Clipboard Integration** — Copy snippets with one command\n- ▶️ **Execute Snippets** — Run bash/python snippets directly\n- 🌐 **Auto Language Detection** — Automatically identifies programming languages\n- 📤 **Import/Export** — JSON backup and restore functionality\n- 🔒 **Local Storage** — Your snippets stay on your machine\n\n---\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\n# Install from PyPI\npip install terminal-snippet-manager\n\n# Or install with pipx (recommended)\npipx install terminal-snippet-manager\n```\n\n### Basic Usage\n\n```bash\n# Add a new snippet\ntsm add --title \"Python Hello World\" --code \"print('Hello, World!')\" --language python\n\n# Search snippets\ntsm search \"hello\"\n\n# List all snippets\ntsm list\n\n# Show snippet with syntax highlighting\ntsm show \u003csnippet-id\u003e\n\n# Copy to clipboard\ntsm copy \u003csnippet-id\u003e\n\n# Execute a snippet (bash/python only)\ntsm run \u003csnippet-id\u003e\n```\n\n---\n\n## 📖 Detailed Usage Guide\n\n### Adding Snippets\n\n```bash\n# Basic addition\ntsm add --title \"Docker PS\" --code \"docker ps -a\" --language bash\n\n# With description and tags\ntsm add \\\n  --title \"Python List Comprehension\" \\\n  --code \"squares = [x**2 for x in range(10)]\" \\\n  --language python \\\n  --description \"Create a list of squares\" \\\n  --tags \"python,list,comprehension\"\n\n# From file\ntsm add --title \"Config\" --file ./config.yaml --language yaml\n\n# From stdin\ncat script.py | tsm add --title \"My Script\" --stdin\n\n# Using editor\ntsm add --title \"Complex Code\" --editor\n```\n\n### Searching Snippets\n\n```bash\n# Fuzzy search\ntsm search \"docker compose\"\n\n# Filter by language\ntsm search \"hello\" --language python\n\n# Filter by tags\ntsm search \"config\" --tag docker --tag yaml\n\n# List with filters\ntsm list --language python --tag utility\n```\n\n### Managing Snippets\n\n```bash\n# Edit snippet\ntsm edit \u003cid\u003e --title \"New Title\"\ntsm edit \u003cid\u003e --editor\n\n# Delete snippet\ntsm delete \u003cid\u003e\n\n# Show statistics\ntsm stats\n\n# List all languages\ntsm languages\n\n# List all tags\ntsm tags\n```\n\n### Import/Export\n\n```bash\n# Export all snippets\ntsm export ./my-snippets.json\n\n# Import snippets\ntsm import ./my-snippets.json\n\n# Import with merge (default)\ntsm import ./snippets.json --merge\n\n# Import with replace\ntsm import ./snippets.json --replace\n```\n\n---\n\n## 💡 Design Philosophy\n\n### Terminal-Native Experience\n\nWe believe the best tools are those that fit seamlessly into your existing workflow. Terminal Snippet Manager is designed for developers who spend most of their time in the terminal.\n\n### Speed First\n\nEvery operation is optimized for speed:\n- Sub-second fuzzy search across thousands of snippets\n- Lazy loading with intelligent caching\n- Minimal dependencies for fast startup\n\n### Privacy by Design\n\nYour code snippets are stored locally in `~/.terminal-snippet-manager/`. No cloud, no tracking, no data leaves your machine unless you explicitly export it.\n\n---\n\n## 📦 Supported Languages\n\nTerminal Snippet Manager auto-detects the following languages:\n\n- **Python** (.py)\n- **JavaScript/TypeScript** (.js, .ts)\n- **Bash/Shell** (.sh, .bash)\n- **Go** (.go)\n- **Rust** (.rs)\n- **Java** (.java)\n- **C/C++** (.c, .cpp, .h)\n- **Ruby** (.rb)\n- **PHP** (.php)\n- **SQL** (.sql)\n- **HTML/CSS** (.html, .css)\n- **JSON/YAML** (.json, .yaml, .yml)\n\n---\n\n## 🔧 Development\n\n```bash\n# Clone repository\ngit clone https://github.com/gitstq/terminal-snippet-manager.git\ncd terminal-snippet-manager\n\n# Install development dependencies\npip install -e \".[dev]\"\n\n# Run tests\nmake test\n\n# Format code\nmake format\n\n# Run linter\nmake lint\n```\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'feat: Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and development process.\n\n---\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🙏 Acknowledgments\n\n- [Click](https://click.palletsprojects.com/) — For the beautiful CLI framework\n- [Rich](https://github.com/Textualize/rich) — For stunning terminal output\n- [fuzzywuzzy](https://github.com/seatgeek/fuzzywuzzy) — For fuzzy string matching\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made with ❤️ for terminal lovers\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fterminal-snippet-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Fterminal-snippet-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fterminal-snippet-manager/lists"}