demo.mov

⚡️ Bang

your personal command center for blazingly fast web navigation

📖 Usage

🔍 Setup Custom Search Engine in Your Browser

Before you can use the Bang command from your browser's search bar, you need to add the Bang URL as a custom search engine. Follow these steps:

1. In your browser settings, add a new search engine:

   • Name: Whatever you prefer (e.g., "Bang")
   • Shortcut: bd (or any keyword you prefer)
   • URL: http://bang.jaw.dev/?q=%s

2. Now you can use Bang directly from your browser's address bar: !bm https://bang.jaw.dev

⚙️ How to Add Custom Search Engine

• Chrome: Settings → Search Engines → Manage Search Engines → Add
• Firefox: Bookmarks → Manage Bookmarks → Right-click → New Bookmark → Add %s in URL
• Edge: Settings → Privacy, search, and services → Address bar and search → Manage search engines → Add

🎯 Default Commands

• @data - Access data
• @admin - Access admin
• @api - Access API docs
• @b, @bangs - Go to home page
• @s, @settings - Access settings
• @t, @tab, @tabs - Access your tabs
• @n, @note, @notes - Access your notes
• @a, @action, @actions - Access your actions
• @bm, @bookmark, @bookmarks - Access your bookmarks
• @r, @reminders - Access your reminders

🎨 Special Commands

• @bm [search term] - Search your bookmarks
• @a [search term] - Search your actions
• @n [search term] - Search your notes
• @r [search term] - Search your reminders
• !find [search term] - Global search across all resources (bookmarks, actions, notes, tabs, reminders)
• !bm [url] - Add a bookmark
• !bm [title] [url] - Add a bookmark
  • [title] is optional, if not provided, we will auto fetch the title
  • [url] is required
  • eg: !bm this title can be super long https://bang.jaw.dev
• !bm --hide [url] - Add a hidden bookmark (requires global password)
• !bm --hide [title] [url] - Add a hidden bookmark with title
  • --hide flag makes the bookmark hidden (only visible after password verification)
  • Requires global password to be set in settings
  • eg: !bm --hide https://private-site.com
  • eg: !bm --hide Private Site https://private-site.com
• !add [trigger] [url] - Create a custom bang
  • [trigger] is required
  • [url] is required
  • eg: !add jaw https://bang.jaw.dev
• !add --hide [trigger] [url] - Create a hidden custom bang (requires global password)
  • --hide flag makes the action hidden (only visible after password verification)
  • Only redirect-type actions can be hidden
  • Requires global password to be set in settings
  • eg: !add --hide private https://private-service.com
• !del [trigger] - Delete a custom bang or tab
  • [trigger] is required (the bang/tab trigger to delete)
  • Works with both bangs and tabs - will delete from both if they exist
  • eg: !del jaw or !del !jaw
• !edit [trigger] [new-trigger] - Change a bang's or tab's trigger
  • [trigger] is required (the current bang/tab trigger)
  • [new-trigger] is required (the new trigger name)
  • Works with both bangs and tabs - will update whichever exists
  • eg: !edit jaw !newjaw
• !edit [trigger] [url] - Change a bang's URL
  • [trigger] is required (the bang trigger to edit)
  • [url] is required (the new URL)
  • Note: URL editing only applies to bangs, not tabs
  • eg: !edit jaw https://new-url.com
• !edit [trigger] [new-trigger] [url] - Change both trigger and URL
  • [trigger] is required (the current bang trigger)
  • [new-trigger] is required (the new trigger name)
  • [url] is required (the new URL)
  • Note: URL editing only applies to bangs, not tabs
  • eg: !edit jaw !newjaw https://new-url.com
• !note [title] | [content] - Create a note
  • [title] is optional, if not provided, we will use it as Untitled
  • [content] is required
  • eg: !note some title | this is a note https://bang.jaw.dev
  • eg: !note this is a content without any title
• !note --hide [title] | [content] - Create a hidden note (requires global password)
  • --hide flag makes the note hidden (only visible after password verification)
  • Requires global password to be set in settings
  • eg: !note --hide Private Note | sensitive information here
  • eg: !note --hide this is hidden content without title
• !remind [description] - Create a reminder with your default timing
  • [description] is required (what you want to be reminded about)
  • Uses your default reminder timing preference (set in /reminders settings)
  • eg: !remind take out trash
  • eg: !remind check email
• !remind [when] [description] - Create a reminder with timing keyword
  • [when] is required (daily, weekly, biweekly, monthly, or YYYY-MM-DD)
  • [description] is required (what you want to be reminded about)
  • eg: !remind daily google.com
  • eg: !remind weekly water plants
• !remind [when] | [description] [| [content]] - Create a reminder with specific timing
  • [when] is required (daily, weekly, biweekly, monthly, or YYYY-MM-DD)
  • [description] is required (what you want to be reminded about)
  • [content] is optional (URL or any additional text/notes)
  • eg: !remind daily | take vitamins
  • eg: !remind weekly | water plants
  • eg: !remind 2025-02-15 | valentine's day
  • eg: !remind monthly | pay bills | https://bank.com

📑 Docs

• See RECIPE for recipe guide.
• See DEVELOPMENT for development guide.
• See CONTRIBUTION for contribution guide.
• See SEARCH ARCHITECTURE for search architecture guide.

📜 License

Distributed under the MIT License © wajeht. See LICENSE for more information.