📝 devnote

A lightweight CLI tool to save and retrieve developer notes & code snippets — right from your terminal.

No browser. No app. Just type and go.

---

✨ Features

• 💾 Save notes instantly from the terminal
• 🏷️ Tag notes by category (--tag js, --tag setup, etc.)
• 🔍 Search through your notes by keyword
• 🗑️ Delete individual notes or clear everything
• 📋 List all notes or filter by tag
• 🚀 Zero dependencies — pure Node.js

---

📦 Installation

# Clone the repo
git clone https://github.com/YOUR_USERNAME/devnote.git
cd devnote

# Make it executable
chmod +x index.js

# Link globally (so you can use it anywhere)
npm link

---

🚀 Usage

# Add a note
devnote add "fix the navbar on mobile"

# Add a note with a tag
devnote add "npm run dev to start the server" --tag setup

# List all notes
devnote list

# List notes by tag
devnote list --tag setup

# Search notes by keyword
devnote search navbar

# Delete a note (use the ID shown in list)
devnote delete lx4k2a

# Clear all notes
devnote clear

# Help
devnote help

---

🖥️ Example Output

$ devnote add "remember to push to main before deployment" --tag git
✅  Note saved! [lx4k2b]
    Tagged as: #git

$ devnote list
📋  All notes (2 total):

  [lx4k2a] fix the navbar on mobile
        🏷  #css
        🕐  25/4/2026, 7:00:00 AM

  [lx4k2b] remember to push to main before deployment
        🏷  #git
        🕐  25/4/2026, 7:01:00 AM

$ devnote search navbar
🔍  Search results for "navbar" (1 found):

  [lx4k2a] fix the navbar on mobile
        🏷  #css
        🕐  25/4/2026, 7:00:00 AM

---

🗂️ How It Works

Notes are stored locally in your home directory as .devnotes.json. No cloud, no account — just a simple JSON file on your machine.

---

🛣️ Roadmap

• Claude AI integration — auto-summarize notes using Claude API
• Export notes to Markdown file
• Pin important notes
• Color-coded tags

---

🤝 Contributing

Pull requests are welcome! Feel free to open an issue for bugs or feature requests.

---

📄 License

MIT © Garvit