🚀 A visual, AI-ready warehouse for storing & reusing code like inventory.
🧠 Built to be modular, collaborative, and addictively useful for devs.
🔖 Tags:#opensource·#snippets·#ai-ready·#modular-tools·#python
A futuristic, open-source warehouse system for storing, retrieving, and managing reusable code snippets and components like digital inventory.
🧠 Imagine a forklift for functions.
🧾 A barcode scanner for scripts.
🤖 Your AI-integrated stockroom for Python, JavaScript, configs, and more.
- ⏱️ Reuse, don’t rewrite — save time and mental overhead
- 📦 Organize code like products in a smart logistics system
- 🌐 Search, scan, and serve snippets visually and programmatically
- 🧠 Future-ready: AI-enhanced lookup and integrations planned
- 🧠 Categorized snippet storage by language, tags, purpose
- 🔍 Searchable & filterable CLI interface (Web UI coming)
- 📁 JSON-backed storage engine
- 🧩 Modular design for plug-in extensions
- 📡 Future: API endpoints, AI code retrieval, VS Code integration
- 📝 Add, update, delete, and list snippets interactively
- 🔁 Full undo system for all actions (add/edit/delete)
- 📦 Global index builder for fast tag-based search
- 📂 CLI menu with 7 streamlined options
🚀 Phase 1 complete:
✅ Core snippet storage
✅ Undo system
✅ Tag-based search via global index
✅ CLI interface (7 interactive options)
✅ Synced and clean GitHub repo with full documentation
🔭 Phase 2: Unit tests, smarter search, and GUI
Whether you're a seasoned dev or just starting out — we’d love your help!
- 🧠 Explore modular thinking
- 🛠️ Shape the future of developer tools
- 🎨 Help design the UX of code organization
- 🌍 Get your name on the contributor wall
📌 Fork it. Clone it. Build a snippet. Commit.
🟢good first issuetags will guide you.
See CONTRIBUTING.md to get started.
python3 -m warehouse.cli
1. List snippets by language
2. Add a new snippet
3. Delete a snippet
4. Update a snippet
5. Rebuild global index
6. Search snippets by tag
7. Undo last action
---
## 🕹️ Additional CLI Tools
### 🔎 `index_browser.py` – Interactive Snippet Explorer
```bash
python3 warehouse/index_browser.py
- **`[s] Search`** – Search snippets by filename, description, or tags
- **`[v] View All`** – Display all snippets grouped by language
- **`Enter number`** – Preview full snippet details and source code
- **`[q] Quit`** – Exit the browser
---
## ✅ Tests
We use **pytest** to validate the functionality of key components in the project.
### 🧪 Running Tests
To run all tests, simply execute:
pytest
---
## 📜 License
Licensed under **GNU AGPL-3.0** to encourage collaboration and prevent closed forks.
See [`LICENSE`](./LICENSE) for full legal terms.
---
## 🧭 Vision & Roadmap
See [`VISION.md`](./VISION.md) for the project goals, phases, and AI-integration plans.