# Habibi

> Use and build Habibi, a local-first command center for macOS.

This site publishes its MDX source. Fetch the .mdx links below for individual pages, or https://clidey.github.io/habibi/llms-full.txt for one combined text file. Start from this URL to discover documentation without guessing repository paths.

If this site is served by Dory's Node preview server, a read-only MCP endpoint is available at https://clidey.github.io/habibi/mcp. MCP clients require a one-time connection to that endpoint; the page URL alone is sufficient for clients that can browse these links.

## Guide

- [Habibi](https://clidey.github.io/habibi/introduction.mdx): A keyboard-first command center for your Mac, your notes, and your connected apps.
- [Install Habibi](https://clidey.github.io/habibi/getting-started/installation.mdx): Install the macOS app or build it from the repository.
- [Your first session](https://clidey.github.io/habibi/getting-started/first-run.mdx): Learn the launcher and connect only the capabilities you need.
- [Search and files](https://clidey.github.io/habibi/guides/search-and-files.mdx): Find local items, revisit recent files, and drag files into drafts or other apps.
- [Notes](https://clidey.github.io/habibi/guides/notes.mdx): Write rich pages, organize them by dragging, and connect them to your work.
- [Ask Habibi](https://clidey.github.io/habibi/guides/ask-habibi.mdx): Configure a model and ask questions with deliberate context and reviewed actions.
- [Files, with Habibi](https://clidey.github.io/habibi/guides/ai-file-tools.mdx): Mention a folder, describe an outcome, and review AI file plans before applying them.
- [Emoji picker](https://clidey.github.io/habibi/guides/emoji.mdx): Find, browse, choose variants, and copy emoji from the launcher.
- [Clipboard history](https://clidey.github.io/habibi/guides/clipboard.mdx): Enable, pause, search, and clear clipboard items stored on your Mac.
- [Reminders](https://clidey.github.io/habibi/guides/reminders.mdx): Review and create Apple Reminders tasks through Ask Habibi.
- [Focus timer](https://clidey.github.io/habibi/guides/focus.mdx): Start a focus session that continues while the launcher is closed.
- [Teleprompter](https://clidey.github.io/habibi/guides/teleprompter.mdx): Read a local script with on-device voice following or automatic scrolling.
- [Mail](https://clidey.github.io/habibi/guides/mail.mdx): Connect Gmail or Zoho Mail and work with threads and reviewed drafts.
- [Calendar](https://clidey.github.io/habibi/guides/calendar.mdx): See upcoming events and review changes before writing to Apple Calendar.
- [WhatsApp](https://clidey.github.io/habibi/guides/whatsapp.mdx): Connect the optional local WhatsApp runtime and review messages before sending.
- [WhoDB](https://clidey.github.io/habibi/guides/whodb.mdx): Connect a WhoDB workspace and ask bounded, read-only data questions.
- [Agent workflows](https://clidey.github.io/habibi/guides/agents.mdx): Discover local Codex and Claude Code sessions and inspect available integrations.
- [Kubernetes](https://clidey.github.io/habibi/guides/kubernetes.mdx): Inspect cluster context and resources through constrained, read-only integrations.
- [Settings](https://clidey.github.io/habibi/settings.mdx): Customize appearance, the shortcut, web search, Home, and menu bar visibility.
- [Keyboard shortcuts](https://clidey.github.io/habibi/shortcuts.mdx): Use the launcher, notes editor, chat, and teleprompter from the keyboard.
- [Privacy and data](https://clidey.github.io/habibi/privacy.mdx): Understand local storage, provider requests, permissions, and analytics.
- [Troubleshooting](https://clidey.github.io/habibi/troubleshooting.mdx): Resolve launcher, permission, connection, and editing problems without discarding your data.

## Developers

- [Development](https://clidey.github.io/habibi/developers/development.mdx): Build the local service and native macOS launcher with the repository toolchain.
- [Architecture](https://clidey.github.io/habibi/developers/architecture.mdx): Keep native adapters, local security, providers, domain behavior, and UI in clear boundaries.
- [Add a skill](https://clidey.github.io/habibi/developers/skills.mdx): Add a bounded capability with typed contracts, provider separation, and explicit execution.
- [Testing](https://clidey.github.io/habibi/developers/testing.mdx): Verify behavior, permissions, packaging, and UI using isolated fictional data.
- [Maintain the docs](https://clidey.github.io/habibi/developers/documentation.mdx): Write, check, preview, and build this Dory documentation site.