📚 TUT-Manager

The ultimate sidekick for self-taught developers. Link your project folders to their learning sources.

Stop hunting through browser bookmarks or YouTube history. TUT keeps your tutorials right where your code is.

🚀 Quick Start

1. Installation

npm install -g tut-manager

2. Basic Usage

Navigate to a project and link your first resource:

tut add "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -n "Project Foundations"

3. Open & Continue

tut go

✨ Advanced Features & "Extra" Magic

🔗 1. Multi-Resource Management

Don't limit yourself to one link. Add a video tutorial, the official documentation, and a helpful blog post all to the same folder.

• Selective Opening: Use tut go and use the Spacebar to check off only the specific tabs you want to open today.
• Open All: Select the "🚀 Open ALL" option to launch your entire learning environment in one click.

📝 2. Per-Tutorial Notes

Keep track of your thoughts or specific timestamps for each link.

• Run tut add --notes "Check out the part at 12:30 about Context API" to store context with your link.
• View your notes anytime with tut info.

🕵️ 3. Automatic URL Detection

TUT is smart. It detects the source of your link and tags it with custom icons:

• 🎬 YouTube: Auto-detected from youtube.com or youtu.be.
• 📖 Documentation: Detected from URLs containing docs, documentation, or gitbook.
• 🌐 Websites: Default for everything else.

📜 4. Activity & Progress Tracking

Ever wondered how much you've been learning lately?

• Run tut history to see a detailed log of every tutorial you've opened, sorted by time.
• TUT tells you exactly how long ago you last opened a resource (e.g., "Opened 2 days ago").

📋 5. Global Project Registry

Lost track of which projects have tutorials?

• Run tut list (or tut ls) from anywhere on your computer.
• It shows a master list of every folder you've ever linked, even if they are buried deep in your file system.

🐚 Automatic Shell Hints & Shortcuts

Make your terminal smarter with one command! TUT can show you a list of tutorials automatically when you cd into a folder.

Enable Integration:

tut shell --install

This works for both CMD and PowerShell automatically.

What you get:

1. Welcome Message: A friendly notification when you open your terminal.
2. Auto-Hints: Every time you cd into a linked folder, you'll see a quiet list of tutorials.
3. Shortcuts:
   • tg -> tut go
   • ti -> tut info
   • tl -> tut list
   • ta -> tut add
   • ts -> tut shell

Disable Integration: If you ever want to remove these shortcuts and hints:

tut shell --uninstall

🛠 Command Deep Dive

| Command | Power-User Tip | |---------|----------------| | tut | Just run tut for the Interactive Mode - a menu-driven way to use the tool. | | tut add | Use tut add (no URL) to get an interactive multi-step prompt. | | tut go | Use the Spacebar to multi-select in the menu! | | tut shell | Use tut shell --status to check your current integration level. | | tut edit | Change a typo in a Name or update a URL without losing your History. | | tut rm | Use tut rm -a to completely clean a folder's tutorial config. | | tut info | Shows the Creation Date and Notes for every link. |

📂 Technical Architecture (For the Curious)

• Local Storage: Data is saved in a hidden .tutorial.json file inside your project. It's safe to commit to Git if you want to share links with teammates!
• Global Config: Global data is kept in ~/.tut/ to ensure your settings persist across updates.
• TypeScript Core: Built with strict typing for maximum reliability and speed.

📄 License

MIT

Build. Learn. Repeat. 🚀