# Lomi > Lomi is a desktop workspace for projects, workspaces, terminals, files and browser previews. Extend it with plugins, color themes, file icons and interface icons. This index links to the English documentation as clean Markdown. Read the relevant guides before using an API or creating a package. Each document includes a Canonical address for citing the human-readable page. Resolve relative paths against the address of this index. For plugins, start with the first-plugin, manifest and API guides. Check SDK and tooling versions in your project; local candidate archives and published packages have separate installation paths. Lomi themes use JSONC v2, with independent color, file-icon and interface-icon selections. Skills are under construction. ## Get started - [Lomi Documentation](https://docs.lomi.dev/index.md): Documentation for Lomi, a desktop workspace for projects, terminals, files, browser previews, coding agents, plugins, and themes. - [What you can do with Lomi](https://docs.lomi.dev/features.md): Explore Lomi workspaces, terminals, files, browser previews, Git, coding agents, Chat AI, and customization, with platform requirements. - [Installation](https://docs.lomi.dev/overview/installation.md): Download Lomi installers from the Lomi repository or build the desktop application. ## Plugins - [Install and manage plugins](https://docs.lomi.dev/plugins.md): Import a local plugin package, approve its code and manage installed revisions. - [Your first plugin](https://docs.lomi.dev/plugins/quick-start.md): Create a panel, build its package and run it in Lomi step by step. - [SDK and lifecycle](https://docs.lomi.dev/plugins/api.md): The complete public PluginContext API and the lifecycle of an executable plugin. - [Commands and interface slots](https://docs.lomi.dev/plugins/commands-and-ui.md): Declare commands, keyboard shortcuts, slot controls and local plugin styles. - [Desktop qualification](https://docs.lomi.dev/plugins/desktop-qualification.md): Record plugin behavior in the installed Lomi application before making compatibility claims. - [Plugin manifest](https://docs.lomi.dev/plugins/manifest.md): The fields, identifiers and validation rules accepted by plugin.json. - [Manual SDK example](https://docs.lomi.dev/plugins/manual-sdk.md): Build and install a complete React plugin using the standalone SDK. - [Packaging and recovery](https://docs.lomi.dev/plugins/packaging-and-recovery.md): Distribute prebuilt plugins, replace revisions and recover from plugin failures. - [Styles and assets](https://docs.lomi.dev/plugins/styling-and-assets.md): Include CSS, images, modules and themes in a self-contained plugin package. - [Templates and project structure](https://docs.lomi.dev/plugins/templates.md): Choose a panel, sidebar, command or theme and understand how the files fit together. - [Tools and diagnostics](https://docs.lomi.dev/plugins/tooling-alpha.md): Complete CLI configuration, local archives, diagnostics and CI workflow. - [Views and saved state](https://docs.lomi.dev/plugins/views-and-state.md): Choose view placement, persist small JSON state and protect unsaved documents. ## Themes - [Use and manage themes](https://docs.lomi.dev/themes.md): Select color and icon themes, import packages and edit local copies. - [Create a color theme](https://docs.lomi.dev/themes/create-a-theme.md): Create an adaptive JSONC theme and package it for local installation. - [Resources and CSS](https://docs.lomi.dev/themes/assets-and-css.md): Add local images, stylesheets, fonts and plugin tokens to a theme package. - [Editor and terminal](https://docs.lomi.dev/themes/editor-and-terminal.md): A complete editor and terminal theme with syntax categories, fonts and palette precedence. - [File and folder icons](https://docs.lomi.dev/themes/icons.md): Create file icon packages and understand how VS Code icon themes map to the application. - [Interface icons](https://docs.lomi.dev/themes/interface-icons.md): A working font package, every control identifier and product icon rules. - [Theme format reference](https://docs.lomi.dev/themes/reference.md): Version 2 fields for tokens, layouts, backgrounds, editor syntax and terminal colors. - [Testing and sharing](https://docs.lomi.dev/themes/testing-and-sharing.md): Test in the desktop app, include all resources and distribute a complete package. - [Token catalogue](https://docs.lomi.dev/themes/tokens.md): All 226 DeepMono token values, grouped by purpose, with override rules. - [Theme troubleshooting](https://docs.lomi.dev/themes/troubleshooting.md): Resolve validation errors, missing assets, appearance conflicts and older theme formats. - [VS Code import and export](https://docs.lomi.dev/themes/vscode.md): Import color themes and export local VSIX packages with clearly defined compatibility limits. ## MCP - [Lomi MCP server](https://docs.lomi.dev/mcp.md): Connect an AI agent to Lomi and work with terminals, files, browsers, Android, Git and Chat. - [MCP architecture](https://docs.lomi.dev/mcp/architecture.md): The headless helper, authenticated broker, native adapters, UI bridge and built-in Chat integration. - [Connect an MCP client](https://docs.lomi.dev/mcp/clients.md): Automatic CLI registration, configuration locations, custom profiles and manual stdio setup. - [Operations, revisions and retries](https://docs.lomi.dev/mcp/operations.md): Interpret structured results, poll durable operations and retry without repeating effects. - [Permissions and session control](https://docs.lomi.dev/mcp/permissions.md): Workspace grants, operation approvals, ownership, human takeover and YOLO mode. - [MCP tool reference](https://docs.lomi.dev/mcp/tools.md): All 74 Lomi MCP tools, their arguments and complete input/output schemas. - [MCP troubleshooting](https://docs.lomi.dev/mcp/troubleshooting.md): Connection failures, denied access, stale targets, uncertain effects and local recovery. - [MCP workflows](https://docs.lomi.dev/mcp/workflows.md): Tool sequences for terminals, file edits, browser tests, Android, Git, Chat and settings. ## AI Resources - [Skills](https://docs.lomi.dev/ai-resources/skills.md): Skills for AI assistants working with Lomi. ## Optional - [Polska dokumentacja](https://docs.lomi.dev/pl/llms.txt): The same guides in Polish. - [Lomi](https://github.com/lomi-dev/lomi): Desktop application source. - [Plugin SDK](https://github.com/lomi-dev/plugin-sdk): Plugin API and build helper source. - [Plugin tools](https://github.com/lomi-dev/plugin-tools): Author CLI and test tooling source. - [Create Lomi plugin](https://github.com/lomi-dev/create-lomi-plugin): Project generator and templates. - [Documentation examples](https://github.com/lomi-dev/docs-app/tree/main/examples): Complete plugin and theme examples.