Kobar-Project/KoBar has 97 GitHub stars and 8 forks. GitHot measured 0 stars in 24 hours, 0 in 7 days, and 0 in 15 days. Last checked 2026-11-17 03:21 UTC. Last push 2026-11-06.
What you can do
- Bar: vertical or horizontal, always on top. Mini mode collapses it to a small floating icon. The header at the top (or left) end of the bar drags it; a click opens the bar menu.
- Notes: a note list with a rich-text editor.
- Workspaces: save a layout (theme, sizes, enabled plugins) and switch between layouts. A workspace can keep its own notes and plugin data. This is for organising your work, not a privacy boundary: installed plugins can still read other workspaces.
- Settings window: General, Appearance, Sidebar, Plugins, Workspaces, Backup and Updates (the update centre is not in the Store build), Integrations and About.
Measured star growth
- in 24h
- 0
- in 7 days
- 0
- in 15 days
- 0
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Your modular, always-on-top desktop utility sidebar.
ProductivityREADME.md
OriginalA modular, always-on-top desktop sidebar for notes and plugins.
What is KoBar
KoBar is a frameless, transparent, always-on-top bar that docks to the edge of your screen. It has a built-in notes panel, and everything else (clipboard manager, media controls, screenshots, calculator and more) is added as plugins, so you install only the tools you want. It is built with Electron and React. Website: kobar.org.
Screenshots
![]() |
![]() |
![]() |
![]() |
![]() |
Features
- Bar: vertical or horizontal, always on top. Mini mode collapses it to a small floating icon. The header at the top (or left) end of the bar drags it; a click opens the bar menu.
- Notes: a note list with a rich-text editor.
- Workspaces: save a layout (theme, sizes, enabled plugins) and switch between layouts. A workspace can keep its own notes and plugin data. This is for organising your work, not a privacy boundary: installed plugins can still read other workspaces.
- Settings window: General, Appearance, Sidebar, Plugins, Workspaces, Backup and Updates (the update centre is not in the Store build), Integrations and About.
- Appearance: light, dark or follow the system; eight accent colours plus a custom colour.
- Languages: 10 (English, Turkish, German, French, Spanish, Russian, Japanese, Chinese, Arabic, Hindi).
- Backup and restore: export notes, settings, workspaces and plugin data to one file, and restore it from Settings. KoBox files are not included.
- Plugin safety: installing, updating and uninstalling a plugin asks for confirmation. Plugins that do not come from the official Kobar-Project organisation get an "unverified" warning.
- KoBox (official plugin): files dropped into KoBox are moved there, not copied; cleanup sends them to the Recycle Bin instead of deleting them permanently.
Official plugins
Plugins are installed from the plugin store in Settings. These 13 are maintained by the KoBar project.
| Plugin | What it does |
|---|---|
| AI Hub | AI assistant for several providers, including local models |
| Clipboard Manager | Multi-slot sequential clipboard with image support |
| Snippet Vault | Saved text templates, code snippets and prompts |
| Screenshot Studio | Region and full-screen capture with an annotation editor |
| KoPlayer | System media controls with album art |
| KoCalendar | Calendar and event alerts |
| Focus Mode | Timer with ambient melodies |
| Calculator | Floating scientific calculator with history |
| Color Picker | Pick a colour from the screen (HEX, RGB, HSL) |
| KoBox | Drag-and-drop file staging area |
| PinWindowToTop | Keep another application's window on top |
| Shortcuts | Application launcher and shortcut manager |
| ToDo List | Small task list with priorities |
Experimental
Google Calendar (Settings > Integrations) is a read-only integration and is off by default. It currently works only in the development environment: it needs a local Google OAuth client file that is not part of the packaged app.
Install
- Windows 10/11: Microsoft Store, or download the installer from GitHub Releases.
- macOS: experimental. Some features may be limited or unavailable. Builds, when published, are on GitHub Releases.
For developers
Requirements: Node.js ^24.21.0 (engines in package.json; .nvmrc pins 24.21.0, the Node bundled in Electron 44.7) and npm.
git clone https://github.com/Kobar-Project/KoBar.git
cd KoBar
npm install
npm run dev
| Script | Purpose |
|---|---|
npm run dev |
Vite and Electron in development mode |
npm test |
Unit tests (Vitest) |
npm run test:e2e |
End-to-end tests (Playwright) |
npm run lint |
ESLint |
npm run build |
Type-check and build (no packaging) |
npm run kobar-build |
Build manager for packaging |
npm run dist:store / dist:direct:win / dist:mac |
Package the Store, direct Windows or macOS build |
Project map:
electron/ Main process, preload scripts, workers
src/ Renderer: App, sidebar, notes, settings, backup, store, i18n, theme
shared/ Types and helpers shared by main and renderer
tests/ Unit and end-to-end tests
tools/ Build and packaging scripts
for-agents/ Guides for AI coding agents
build/ App icons and packaging resources
Assets/ Images, melodies and note templates
See CONTRIBUTING.md before opening a pull request and SECURITY.md to report a vulnerability.
Plugin development
Plugins are plain JavaScript that run in the app's renderer. The current (v1) API is five globals:
window.Reactandwindow.ReactDOMwindow.useAppStore: the app's Zustand storewindow.api: the preload bridge to the main processwindow.KoBarExtensions: registers buttons, panels and settings
Start with for-agents/kobar-plugin-developer/SKILL.md: the rules the host enforces and a complete working plugin. Its references/ folder has the full window.api reference, host behaviour (panels, theme, storage, permissions), manifest and publishing rules, and platform notes.
Plugins have full access to the app window. Installed plugins are not sandboxed, so install only plugins you trust.
The kobar and kobox prefixes are reserved for KoBar and its official plugins. Backup restore treats localStorage keys (and plugin ids) that start with them, case-insensitively, as belonging to KoBar, so a third-party plugin cannot claim them. Prefix your keys with your own plugin id.
A new plugin API (v2) is planned for KoBar 2.0. The v1 API will be removed then.
To list a plugin in the store: add a manifest.json (or kobar.json) to the repository root, publish a GitHub Release with the plugin .zip, then open a pull request that adds Username/RepositoryName to plugins.json in kobar-plugins-registry. Listing is not a security review.
Developing with AI agents
for-agents/ holds guides for coding agents: the plugin API (kobar-plugin-developer) and the current design rules (kobar-ui-ux-designer). To test a plugin from source, create a git-ignored pluginsPlayground/ folder at the repository root; an unpackaged build (npm run dev) loads plugins from it. See section 6 of manifest-and-publishing.md.
Sponsors
No sponsors at the moment. Would you like to sponsor KoBar? Write to [email protected].
Author and contact
Made by Ekrem EDALI. Contact: [email protected].
License
MIT. See LICENSE.md.




