Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 24 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,15 +17,16 @@ repository), pinned to a commit, with a checksum of its files and the list of wh
```toml
id = "github"
title = "GitHub"
description = "Search repositories and follow your pull requests"
description = "Pull requests with their checks and reviews, your issues, and repository search"
author = "Backslash"
version = "1.0.0"
icon = "bs-repo"
version = "1.1.0"
repository = "https://github.com/backslash-app/plugins"
path = "extensions/github"
commit = "a64f60074557298bf4cabf235c6e91e1f4e54082"
checksum = "sha256:37f89a1e…"
permissions = ["Access api.github.com"]
commands = ["Search GitHub Repositories", "My Pull Requests"]
permissions = ["Access api.github.com", "Access avatars.githubusercontent.com", "Run gh"]
commands = ["Search GitHub Repositories", "My Pull Requests", "My GitHub Issues"]
```

Backslash installs exactly that commit and refuses anything whose files, version or permissions differ from the entry.
Expand Down Expand Up @@ -62,25 +63,28 @@ Anyone can also install straight from a repository, without the registry:

## First-party extensions

| Extension | Commands | Permissions |
| --------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| [GitHub](extensions/github) | Search repositories, my pull requests | `api.github.com` |
| [Packages](extensions/packages) | Search apt/dnf/pacman/zypper and Flathub | runs the package tools (search only) |
| [Services](extensions/systemd) | Start, stop, restart, logs of systemd services | `systemctl`, `journalctl` |
| [Containers](extensions/docker) | Docker/Podman: start, stop, logs, remove | `docker`, `podman` |
| [Emoji & Symbols](extensions/emoji) | Search and copy | none |
| [Browser](extensions/browser) | History and bookmarks of Firefox, Chrome, Brave, Chromium, Edge, Vivaldi; Firefox tabs | reads the browsers' profiles |
| [Media Controls](extensions/media) | Now playing, play/pause, next, volume of any MPRIS player | `busctl`, Spotify covers |
| [Code Projects](extensions/projects) | Recent projects of VS Code, Cursor, Zed, JetBrains, git folders; open in editor or terminal | reads editor history, runs editors and terminals |
| [Timers](extensions/timers) | Timers and Pomodoro that ring even with Backslash closed | `systemd-run`, `systemctl` |
| [Ports](extensions/ports) | What listens on each port, with its process and project; stop it | `ss`, `ps`, `readlink`, `kill` |
| [Network & Devices](extensions/network) | Wi-Fi, Bluetooth, audio outputs, VPN and Tailscale | `nmcli`, `bluetoothctl`, `pactl`, `tailscale` |
| [AI](extensions/ai) | Ask AI, fix, improve, summarize, translate, explain copied text | Claude, OpenAI, Mistral, Groq, OpenRouter, Ollama |
| [Linear](extensions/linear) | My issues by status, change status, search, create an issue | `api.linear.app` |
| [Todoist](extensions/todoist) | Today and overdue tasks, complete them, search, quick add | `api.todoist.com` |
| Extension | Commands | Permissions |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- |
| [AI](extensions/ai) | Ask AI with saved conversations; fix, improve, summarize, translate, explain copied text | Claude, OpenAI, Mistral, Groq, OpenRouter, Ollama |
| [Browser](extensions/browser) | History and bookmarks of Firefox, Chrome, Brave, Chromium, Edge, Vivaldi; Firefox tabs | reads the browsers' profiles |
| [Code Projects](extensions/projects) | Recent projects of VS Code, Cursor, Zed, JetBrains and git folders, with language and git status; open with… | reads editor history, runs editors and terminals |
| [Containers](extensions/docker) | Docker/Podman grouped by Compose project: start, stop, logs, remove | `docker`, `podman` |
| [Emoji & Symbols](extensions/emoji) | Search and copy, recently used first | none |
| [GitHub](extensions/github) | Pull requests with checks and reviews, issues, repositories | `api.github.com`, avatars, `gh` for the token |
| [Linear](extensions/linear) | My issues by status with labels, cycle and sub-issues; change status, priority, assignee; search, create | `api.linear.app` |
| [Media Controls](extensions/media) | Now playing with cover and progress, play/pause, next, volume, shuffle, repeat of any MPRIS player | `busctl`, covers |
| [Network & Devices](extensions/network) | Wi-Fi, Bluetooth (with battery), audio outputs, VPN and Tailscale | `nmcli`, `bluetoothctl`, `pactl`, `tailscale` |
| [Packages](extensions/packages) | Search apt/dnf/pacman/zypper and Flathub | runs the package tools (search only) |
| [Ports](extensions/ports) | What listens on each port, with its process and project; stop it | `ss`, `ps`, `readlink`, `kill` |
| [Services](extensions/systemd) | systemd services, running or failed: start, stop, restart, logs | `systemctl`, `journalctl` |
| [Timers](extensions/timers) | Timers and Pomodoro that ring even with Backslash closed | `systemd-run`, `systemctl` |
| [Todoist](extensions/todoist) | Today, next 7 days, no date; complete, reschedule, prioritize; search, quick add | `api.todoist.com` |

Their registry entries are regenerated with `scripts/update-entries.sh` after a change is merged.

Extension icons can be emoji, theme icon names, or Backslash's own glyphs (`bs-repo`, `bs-sparkle`…, see `Icons` in the
SDK), which look the same on every desktop.

## Developing here

```sh
Expand Down
Loading