{"id":25423337,"url":"https://github.com/wajeht/bang","last_synced_at":"2025-10-30T11:17:05.843Z","repository":{"id":179755662,"uuid":"664087656","full_name":"wajeht/bang","owner":"wajeht","description":"your personal command center for blazingly fast web navigation","archived":false,"fork":false,"pushed_at":"2025-10-24T12:08:51.000Z","size":49916,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-24T14:14:33.997Z","etag":null,"topics":["bang","bookmarks","cross-platform","duckduckgo","golang","kagi","notes","search","shortcut","sync","tabs"],"latest_commit_sha":null,"homepage":"https://bang.jaw.dev/","language":"TypeScript","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/wajeht.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":".github/CODEOWNERS","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":"2023-07-08T22:00:32.000Z","updated_at":"2025-10-24T12:08:55.000Z","dependencies_parsed_at":"2024-12-06T02:24:55.858Z","dependency_job_id":"64edea57-1963-40a2-9eaf-8ea7dcc02ad8","html_url":"https://github.com/wajeht/bang","commit_stats":null,"previous_names":["wajeht/bang"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/wajeht/bang","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wajeht%2Fbang","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wajeht%2Fbang/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wajeht%2Fbang/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wajeht%2Fbang/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wajeht","download_url":"https://codeload.github.com/wajeht/bang/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wajeht%2Fbang/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281794056,"owners_count":26562635,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-30T02:00:06.501Z","response_time":61,"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":["bang","bookmarks","cross-platform","duckduckgo","golang","kagi","notes","search","shortcut","sync","tabs"],"created_at":"2025-02-16T22:38:22.150Z","updated_at":"2025-10-30T11:17:05.836Z","avatar_url":"https://github.com/wajeht.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"https://github.com/user-attachments/assets/5f033de3-afa1-44a7-b55b-dc45fc203d10\n\n# ⚡️ Bang\n\n[![Node.js CI](https://github.com/wajeht/bang/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/wajeht/bang/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![Open Source Love svg1](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/wajeht/bang)\n\nyour personal command center for blazingly fast web navigation\n\n## 📖 Usage\n\n\u003c!-- starts --\u003e\n\n### 🔍 Setup Custom Search Engine in Your Browser\n\nBefore 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:\n\n1. In your browser settings, add a new search engine:\n    - **Name**: Whatever you prefer (e.g., \"Bang\")\n    - **Shortcut**: `bd` (or any keyword you prefer)\n    - **URL**: `http://bang.jaw.dev/?q=%s`\n\n2. Now you can use Bang directly from your browser's address bar:\n   `!bm https://bang.jaw.dev`\n\n### ⚙️ How to Add Custom Search Engine\n\n- **Chrome**: Settings → Search Engines → Manage Search Engines → Add\n- **Firefox**: Bookmarks → Manage Bookmarks → Right-click → New Bookmark → Add %s in URL\n- **Edge**: Settings → Privacy, search, and services → Address bar and search → Manage search engines → Add\n\n### 🎯 Default Commands\n\n- `@data` - Access data\n- `@admin` - Access admin\n- `@api` - Access API docs\n- `@b`, `@bangs` - Go to home page\n- `@s`, `@settings` - Access settings\n- `@t`, `@tab`, `@tabs` - Access your tabs\n- `@n`, `@note`, `@notes` - Access your notes\n- `@a`, `@action`, `@actions` - Access your actions\n- `@bm`, `@bookmark`, `@bookmarks` - Access your bookmarks\n- `@r`, `@reminders` - Access your reminders\n\n### 🎨 Special Commands\n\n- `@bm [search term]` - Search your bookmarks\n- `@a [search term]` - Search your actions\n- `@n [search term]` - Search your notes\n- `@r [search term]` - Search your reminders\n- `!find [search term]` - Global search across all resources (bookmarks, actions, notes, tabs, reminders)\n- `!bm [url]` - Add a bookmark\n- `!bm [title] [url]` - Add a bookmark\n    - `[title]` is optional, if not provided, we will auto fetch the title\n    - `[url]` is required\n    - eg: `!bm this title can be super long https://bang.jaw.dev`\n- `!bm --hide [url]` - Add a hidden bookmark (requires global password)\n- `!bm --hide [title] [url]` - Add a hidden bookmark with title\n    - `--hide` flag makes the bookmark hidden (only visible after password verification)\n    - Requires global password to be set in settings\n    - eg: `!bm --hide https://private-site.com`\n    - eg: `!bm --hide Private Site https://private-site.com`\n- `!add [trigger] [url]` - Create a custom bang\n    - `[trigger]` is required\n    - `[url]` is required\n    - eg: `!add jaw https://bang.jaw.dev`\n- `!add --hide [trigger] [url]` - Create a hidden custom bang (requires global password)\n    - `--hide` flag makes the action hidden (only visible after password verification)\n    - Only redirect-type actions can be hidden\n    - Requires global password to be set in settings\n    - eg: `!add --hide private https://private-service.com`\n- `!del [trigger]` - Delete a custom bang or tab\n    - `[trigger]` is required (the bang/tab trigger to delete)\n    - Works with both bangs and tabs - will delete from both if they exist\n    - eg: `!del jaw` or `!del !jaw`\n- `!edit [trigger] [new-trigger]` - Change a bang's or tab's trigger\n    - `[trigger]` is required (the current bang/tab trigger)\n    - `[new-trigger]` is required (the new trigger name)\n    - Works with both bangs and tabs - will update whichever exists\n    - eg: `!edit jaw !newjaw`\n- `!edit [trigger] [url]` - Change a bang's URL\n    - `[trigger]` is required (the bang trigger to edit)\n    - `[url]` is required (the new URL)\n    - Note: URL editing only applies to bangs, not tabs\n    - eg: `!edit jaw https://new-url.com`\n- `!edit [trigger] [new-trigger] [url]` - Change both trigger and URL\n    - `[trigger]` is required (the current bang trigger)\n    - `[new-trigger]` is required (the new trigger name)\n    - `[url]` is required (the new URL)\n    - Note: URL editing only applies to bangs, not tabs\n    - eg: `!edit jaw !newjaw https://new-url.com`\n- `!note [title] | [content]` - Create a note\n    - `[title]` is optional, if not provided, we will use it as `Untitled`\n    - `[content]` is required\n    - eg: `!note some title | this is a note https://bang.jaw.dev`\n    - eg: `!note this is a content without any title`\n- `!note --hide [title] | [content]` - Create a hidden note (requires global password)\n    - `--hide` flag makes the note hidden (only visible after password verification)\n    - Requires global password to be set in settings\n    - eg: `!note --hide Private Note | sensitive information here`\n    - eg: `!note --hide this is hidden content without title`\n- `!remind [description]` - Create a reminder with your default timing\n    - `[description]` is required (what you want to be reminded about)\n    - Uses your default reminder timing preference (set in /reminders settings)\n    - eg: `!remind take out trash`\n    - eg: `!remind check email`\n- `!remind [when] [description]` - Create a reminder with timing keyword\n    - `[when]` is required (daily, weekly, biweekly, monthly, or YYYY-MM-DD)\n    - `[description]` is required (what you want to be reminded about)\n    - eg: `!remind daily google.com`\n    - eg: `!remind weekly water plants`\n- `!remind [when] | [description] [| [content]]` - Create a reminder with specific timing\n    - `[when]` is required (daily, weekly, biweekly, monthly, or YYYY-MM-DD)\n    - `[description]` is required (what you want to be reminded about)\n    - `[content]` is optional (URL or any additional text/notes)\n    - eg: `!remind daily | take vitamins`\n    - eg: `!remind weekly | water plants`\n    - eg: `!remind 2025-02-15 | valentine's day`\n    - eg: `!remind monthly | pay bills | https://bank.com`\n\n\u003c!-- ends --\u003e\n\n## 📑 Docs\n\n- See [RECIPE](./docs/recipe.md) for `recipe` guide.\n- See [DEVELOPMENT](./docs/development.md) for `development` guide.\n- See [CONTRIBUTION](./docs/contribution.md) for `contribution` guide.\n- See [SEARCH ARCHITECTURE](./docs/search-architecture.md) for `search architecture` guide.\n\n## 📜 License\n\nDistributed under the MIT License © [wajeht](https://github.com/wajeht). See [LICENSE](./LICENSE) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwajeht%2Fbang","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwajeht%2Fbang","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwajeht%2Fbang/lists"}