v1.0 · macOS 15+ · free · source-available

One floating window for the whole Mac.

TheBar is a native command bar. Search apps, run slash commands, ask AI with your own provider key, translate and draw on device, find places, recall anything you copied. One key combo. Always there.

0 commands
built in, written in Swift
0 AI providers
Anthropic, OpenAI, Gemini, Ollama, Groq
0 languages
translate, on-device
0 clipboard slots
SQLite, SHA256-deduped
0 telemetry
off by default; toggle in Settings
launcher
Three keystrokes to any app, file, bookmark.1 / 7
Ask anything or type / for commands…
§ 01 · The shape

Three intents.
One window.

The bar classifies what you typed before you finish typing. Apps, AI, web. The window reflows in place. No tabs. No second screen. Same key combo.

Mode 01

Launcher

Three keystrokes to any app, file, bookmark, or recent. The mnemonic ranker learns from what you actually pick over time, not just what was indexed last. Drag-and-drop on the bar accepts files and selected text directly.

  • ·Mnemonic ranker
  • ·Calculator inline
  • ·Drop targets accepted
fina
1
Finder
App
2
Final Cut Pro
App
⌥2
3📝
finance.md
~/Notes
⌥3
4📂
finalists/
~/Documents
⌥4
Mode 02

Chat

Press Return on a question and the bar streams a response. Conversation history persists. The active app, your current selection, and clipboard are passed in as context (privacy toggle in Settings). Bring your own key for any of five providers, or run Ollama locally.

  • ·5 providers · BYOK
  • ·Local Ollama supported
  • ·Active-app context
rewrite this commit message tighter
AI

fix(action-executor): drain pipes via readabilityHandler drops noun-clause filler, keeps the why.

● anthropic / claude-opus-4-7·streaming·342 tokens
Mode 03

Search

DuckDuckGo Instant Answers inline. Capped at eight hits so the window fits a 13-inch laptop. ⌥1 through ⌥8 opens a hit in the browser. Space toggles a WKWebView preview pane that loads the page right inside the bar.

  • ·8-hit cap, ⌥1-8
  • ·Inline preview · Space
  • ·Esc to collapse
swift programming language
1
Swift (programming language)
en.wikipedia.org
Swift is a general-purpose, multi-paradigm, compiled programming language developed by Apple.
1
2
Swift.org
swift.org
The Swift programming language. Open source, fast, modern, and safe.
Space2
3
Objective-C
en.wikipedia.org
An object-oriented programming language adding Smalltalk-style messaging to C.
3
§ 02 · Native to the Mac

On device by default.
No keys, no calls, no leaks.

We use Apple frameworks for what Apple does well. Translate, draw, find a place. Nothing leaves your machine. No third-party API key to fetch, no rate limit to hit, no provider to lose money on a Tuesday.

/translate

Translate

Apple's Translation framework, fully on-device. Twenty languages plus Simplified and Traditional Chinese, with friendly aliases ("chinese" maps to zh-Hans). The first run of a pair triggers Apple's native download sheet. After that, offline forever.

EnglishSpanishFrenchGermanJapaneseChineseKoreanArabicHindi...20+
/translate Chinese where is the nearest cafe
💬where is the nearest cafe
🌐
最近的咖啡馆在哪里
→ Chinese (Simplified) · zh-Hans · on-device
⌘C
/map

Maps & directions

MKLocalSearch results render as a real MKMapView with numbered orange pins. Click a row to drop the place into Maps.app, or tap the Directions pill to open turn-by-turn from your current location. Region-biased to your last-known coordinate when CoreLocation is authorised.

coffeeramen near megasLAXparkpharmacy
/map ramen near me
123
1
Ippudo Ramen
123 Stuyvesant St · 0.4 mi
Directions⌥1
/draw

Draw

Apple Image Playground. Four images per prompt, generated on device. ⌥1 through ⌥4 copies a tile to the clipboard. Space goes fullscreen, Esc collapses. macOS 15.4 or later, Apple Intelligence eligible Mac required.

a fox in a snowy forestlow-poly mountainwatercolor cat
/draw a fox in a snowy forest at dusk
1
2
3
4
⌥1-4 to copy · Space to fullscreen · on-device · Apple Image Playground
The slash menu, in motion

Type / and the menu writes itself.

Every shipped command in the registry. Hover to pause. Each is a single keystroke.

/ask/translate/draw/map/clipboard/screen/define/calendar/find/tile/3pane/google/youtube/github/ssh/wifi/dnd/darkmode/volume/brightness/screenshot/lock/sleep/restart/shutdown/quit/kill/mute/remind/act/context/model/provider/settings/backup/restore/reload/update/ask/translate/draw/map/clipboard/screen/define/calendar/find/tile/3pane/google/youtube/github/ssh/wifi/dnd/darkmode/volume/brightness/screenshot/lock/sleep/restart/shutdown/quit/kill/mute/remind/act/context/model/provider/settings/backup/restore/reload/update
/update/reload/restore/backup/settings/provider/model/context/act/remind/mute/kill/quit/shutdown/restart/sleep/lock/screenshot/brightness/volume/darkmode/dnd/wifi/ssh/github/youtube/google/3pane/tile/find/calendar/define/screen/clipboard/map/draw/translate/ask/update/reload/restore/backup/settings/provider/model/context/act/remind/mute/kill/quit/shutdown/restart/sleep/lock/screenshot/brightness/volume/darkmode/dnd/wifi/ssh/github/youtube/google/3pane/tile/find/calendar/define/screen/clipboard/map/draw/translate/ask
§ 03 · Among launchers

Where we differ.
And where we don't.

Honest table. Spotlight, Alfred, Raycast, TheBar. Each cell reflects what each tool actually ships today (free tiers where applicable; paid additions noted as partial). If we say yes, the code is in the repository.

Capability
Spotlight
macOS built-in
Alfred
paid Powerpack
Raycast
freemium, Pro tier
TheBar
v1 free
AI
AI chat, BYOK across providers
TheBar: 5 providers (Anthropic, OpenAI, Gemini, Ollama, Groq).
nonopartialyes
Run AI locally (Ollama)
nonopartialyes
Plan-based agent + safety guards
/act runs PlanGenerator → ActionExecutor with explicit guards.
nononoyes
On-device
Translate (Apple Translation framework)
Spotlight has inline translate but not as a callable command flow.
partialnonoyes
Image generation (Image Playground)
macOS 15.4+ on Apple Intelligence eligible Macs.
nononoyes
Map search + driving directions
partialnonoyes
Productivity
Clipboard history, built-in
200-item ring buffer, SHA256-deduped, SQLite-backed, free.
nopartialpartialyes
Snippets / text expander
nopartialpartialyes
Window tiling
nonoyesyes
Inline web preview (WKWebView)
Press Space on a focused web hit. Esc collapses.
nononoyes
Extensibility
Extension SDK
TheBar: JavaScript today. Deno + Python next.
nopartialyesyes
Sandboxed extension runtime
Subprocess + per-manifest heap cap.
nonoyesyes
Cost & openness
Free, no Pro tier
yesnonoyes
Source-available
nononoyes
No telemetry by default
partialyesnoyes

Data point sources: each competitor's public website + free-tier release notes as of 2026. "Partial" means the capability exists only in a paid tier, or only as a system feature outside the launcher window. We update this table when the competitive surface moves.

§ 04 · The surface area

One bar.
The surface area of the OS.

Each cell below is a real, shipped feature. Hover the cell to see the violet hairline trace itself. Nothing here is roadmap or marketing language.

/clipboard

200 clips, deduped, local.

SQLite ring buffer. SHA256 dedup. ⌥1 to ⌥9 instantly recopies. Persists across restart, clears on demand from Settings.

  • · 200-item ring buffer
  • · SHA256 deduplication
  • · Application Support / SQLite
/
1
/translateOn-device translation
2
/drawGenerate four images
3
/mapApple Maps + directions
4
/clipboardCopy history
5
/screenCapture and ask AI
6
/tileWindow tiling
Inline web preview

Read the page.
Keep the bar.

Space toggles a WKWebView pane on the focused hit. Esc collapses. Up to 8 hits cap so the bar never grows past the screen.

swift programming language
1
Swift (programming language)
en.wikipedia.org
Swift is a general-purpose, multi-paradigm, compiled programming language developed by Apple.
1
2
Swift.org
swift.org
The Swift programming language. Open source, fast, modern, and safe.
Space2
3
Objective-C
en.wikipedia.org
An object-oriented programming language adding Smalltalk-style messaging to C.
3
extensions · sandboxed

Drop a manifest. Reload in place.

JavaScript today. Subprocess + per-manifest heap cap + structured IPC. Deno and Python next.

/snippets

Trigger words → text.

Type the trigger anywhere; the bar expands it. Clipboard isn't touched.

Mnemonic ranker

Learns from what you pick.

Recency + frequency + per-query memory. Right answer faster, fewer keystrokes.

RPC server

Drive the bar from anywhere.

thebar:// URL scheme + RPC actor for programmatic control. Shortcuts integration shipped.

/clipboard
1
https://github.com/laxman-sharma/thebar
2 min ago
1
2
TODO: ship clipboard history before May 8
3 min ago
2
3
ssh laxman@thebar.dev
4 min ago
3
4
git rebase -i HEAD~3
5 min ago
4
5
Final paragraph from the design doc.
6 min ago
5
200-item ring buffer · SHA256 dedup · SQLite, local
/backup · /restore

Snapshots, on demand.

Settings, snippets, clipboard, history — to a single file. Restore on a fresh machine in one command.

Built in Swift

Native AppKit + SwiftUI. ~9 MB binary. Hardware-accel everywhere.

Source-available

Read every line. File issues. Send patches.

Tested

~80 test files across TheBarKit and TheBar surfaces.

Local-first

Every store is on disk. Network is opt-in.

§ 05 · The slash menu

38 built-in commands.
Plus everything you write yourself.

Type / to see the menu. Tab autocompletes. Each command is a single keystroke from your current task. Extensions add more.

AI
6 commands
/askStream AI answer with active app + selection context
/screenCapture a region; ask AI about what's on screen
/actPlan-based agent: PlanGenerator + ActionExecutor
/contextInspect the current context snapshot
/modelSwitch model on the fly
/providerSwitch provider (Anthropic, OpenAI, Gemini, ...)
Native
6 commands
/translateOn-device translation, 22 languages
/drawGenerate four images on-device (macOS 15.4+)
/mapApple Maps + turn-by-turn directions
/defineNative dictionary lookup
/calendarSearch and create events via EventKit
/findSpotlight-style file search
Productivity
5 commands
/clipboard200-item history with ⌥N quick-copy
/tileWindow tiling: halves, quadrants, thirds
/3paneSplit focused window across three panes
/remindCreate a reminder via EventKit
/screenshotCapture region, window, or full screen
Web
3 commands
/googleOpen a Google search in the browser
/youtubeOpen a YouTube search
/githubOpen a GitHub search
System
13 commands
/wifiShow current network details
/dndToggle Do Not Disturb
/darkmodeToggle macOS appearance
/volumeSet system volume
/brightnessSet display brightness
/muteToggle system mute
/lockLock the screen
/sleepPut the Mac to sleep
/restartRestart with confirmation
/shutdownShut down with confirmation
/quitQuit a running application
/killForce-quit a misbehaving process
/sshConnect to a saved SSH host
Meta
5 commands
/settingsOpen the settings window
/backupSnapshot user data to a single file
/restoreRestore from a backup snapshot
/reloadReload extensions in place
/updateCheck for application updates
§ 06 · The principle

Your machine, your data. That is the product.

Stays local
  • Clipboard history (SQLite, 200-row ring buffer in Application Support)ClipboardStore.swift
  • Language packs and translation runs (Apple, on-device)Translation framework
  • Image generation (Apple Intelligence, on-device)ImagePlayground
  • App + file index, learned ranks, query historySearchIndex
  • Conversation transcripts, settings, snippetsHistoryStore
  • Extension subprocesses; stdio IPC; per-manifest heap capRPCServer
Opt-in network
  • AI chat — only when you press Return on a promptAIEngine
  • Web search via DDG Instant Answer (no API key)WebSearchProvider
  • Update check — manual via /update, never silentlyUpdateService
  • Off by default (telemetryOptIn = false in AppSettings)Telemetry
  • Provider sign-in flows when you choose to use themOAuthService

App sandbox is intentionally disabled in entitlements. The bar needs full Mac access to tile windows, type for you, and read the active selection. We ship the binary directly so the bar can keep doing those things without going through the App Store sandbox.

§ 07 · Roadmap

Released every fortnight. Not a wishlist.

v1.0
Shipped
  • ·Launcher · Chat · Search modes
  • ·/translate (Apple Translation, 22 languages)
  • ·/draw (Apple Image Playground, macOS 15.4+)
  • ·/map with MKMapView and turn-by-turn
  • ·/clipboard 200-item ring buffer
  • ·Inline web preview (Space)
  • ·JavaScript extensions, sandboxed runtime
  • ·Snippets / text expander
  • ·Window tiling · /3pane
  • ·Backup / Restore
  • ·URL scheme + RPC server (programmatic control)
  • ·5 AI providers, BYOK + Ollama local
  • ·Plan-based agent (/act)
  • ·Spotlight-style file search
v1.1
In flight
  • ·/weather — WeatherKit rich card (after Apple Dev provisioning)
  • ·Voice input — Apple Speech, on-device
  • ·Bookmarks sync via iCloud Drive
  • ·Deno + Python extension runtimes
  • ·Per-command custom hotkey
  • ·Inline result selection across modes
  • ·Action panel (⌘K) refinements
v1.2 +
Planned
  • ·/news — RSS + Hacker News aggregator
  • ·/define expanded (etymology, IPA, related)
  • ·Per-app context profiles
  • ·Image-to-image edit (Apple Intelligence)
  • ·Markdown notes with bidirectional links
  • ·Bar widgets (timer, battery, calendar at a glance)
  • ·Workflow recorder (chain commands into macros)
Out of scope
Won't ship
  • ·Cloud sync of clipboard or history (privacy boundary)
  • ·Mobile companion (would dilute focus)
  • ·AI 'agents that book your flights' style claims (not real)
  • ·Subscription tier for v1.x (free, source-available)
§ 08 · Get TheBar

Free.
No login. No telemetry.

macOS 15 (Sequoia) or later. Apple Silicon or Intel. About 9 MB on disk. For /draw you additionally need macOS 15.4+ and an Apple Intelligence eligible Mac.

Binary size
~9 MB
release build
Architecture
Universal
Apple Silicon · Intel
Distribution
Direct .app
outside the App Store
Sandbox
Disabled
by design (full Mac access)