# Luminy

## Docs

- [Agent Modes: Build, Plan, and Explore Your Codebase](https://docs.luminy.tech/concepts/agents.md): Luminy's three agent modes control how the AI approaches your tasks — making changes, creating a plan first, or exploring your codebase read-only.
- [Projects: Index and Connect Your Codebase to Luminy](https://docs.luminy.tech/concepts/projects.md): Luminy projects link a local folder to the AI agent, enabling code search, file editing, and codebase-aware conversations with automatic local indexing.
- [Sessions: Persistent AI Coding Conversations in Luminy](https://docs.luminy.tech/concepts/sessions.md): Sessions are persistent AI conversations in Luminy. Learn how to create, organize, fork, and manage sessions — both project-scoped and global.
- [Skills: Specialized Agent Behaviors for Coding Tasks](https://docs.luminy.tech/concepts/skills.md): Luminy skills auto-activate to give the agent structured guidance for specialized tasks — debugging, refactoring, design, and UI verification.
- [Customize Luminy's Appearance: Themes, Colors, and Layout](https://docs.luminy.tech/configuration/appearance.md): Personalize Luminy with dark or light mode, accent colors, font size, and chat bubble style. All appearance settings apply instantly without restarting.
- [Context Window Management and Compaction in Luminy](https://docs.luminy.tech/configuration/context-compaction.md): Luminy automatically manages your context window with a 4-zone compaction system, summarizing old conversation turns to keep sessions running indefinitely.
- [Agent Permission Controls and Approval Settings in Luminy](https://docs.luminy.tech/configuration/permissions.md): Luminy's permission system lets you approve or deny sensitive agent actions before they run, giving you full control over what the agent does.
- [Luminy Installation Guide: macOS, Windows, and Linux](https://docs.luminy.tech/installation.md): Download and install Luminy on macOS, Windows, or Linux. Luminy updates automatically in the background when new versions are available.
- [What is Luminy? Local-First Agentic AI for Developers](https://docs.luminy.tech/introduction.md): Luminy is a local-first AI coding assistant giving LLMs direct access to your codebase and tools, supporting 20+ providers and private offline models.
- [Cloud AI Providers: Anthropic, OpenAI, Gemini, and More](https://docs.luminy.tech/providers/cloud-providers.md): Connect Luminy to Anthropic, OpenAI, Google Gemini, GitHub Copilot, OpenRouter, and 15+ other cloud AI providers using your own API keys or OAuth.
- [Custom API Endpoints and Self-Hosted Models in Luminy](https://docs.luminy.tech/providers/custom-endpoints.md): Connect Luminy to any OpenAI-compatible or Anthropic-compatible API endpoint, including self-hosted models, LM Studio, and private deployments.
- [Local AI with Ollama: Private Model Inference in Luminy](https://docs.luminy.tech/providers/local-models.md): Use Ollama to run AI models locally in Luminy. All inference stays on your machine — no API keys, no data sent to the cloud, full privacy.
- [Luminy AI Providers: Connect 20+ Models and Services](https://docs.luminy.tech/providers/overview.md): Luminy supports 20+ AI providers including local Ollama models, Anthropic, OpenAI, Gemini, GitHub Copilot, and more. Configure any provider in Settings.
- [Luminy Quickstart: Install, Connect, and Start Coding](https://docs.luminy.tech/quickstart.md): Download Luminy, connect your first AI provider, add a project folder, and start an agentic chat with your codebase in under 5 minutes.
- [File System Tools: Reading and Editing Code With Luminy](https://docs.luminy.tech/tools/file-system.md): Luminy's file system tools let the agent read, write, and search your project files with precision — including glob search, grep, and symbol lookup.
- [MCP Servers: Give Luminy Access to External Services](https://docs.luminy.tech/tools/mcp-servers.md): Connect Model Context Protocol (MCP) servers to Luminy to add external tools like web search, databases, cloud APIs, and custom integrations.
- [Agent Tools: What Luminy Can Do With Your Codebase](https://docs.luminy.tech/tools/overview.md): Luminy's agent uses built-in tools to read, write, and execute code in your project — covering file editing, shell commands, git, and MCP integrations.
- [Shell and Git Tools: Run Commands With the Luminy Agent](https://docs.luminy.tech/tools/shell-git.md): Luminy's agent runs terminal commands and git operations in your project, streaming live output into the chat with per-command permission controls.
- [Fixing Common Luminy Issues: Providers, Indexing, and More](https://docs.luminy.tech/troubleshooting/common-issues.md): Step-by-step fixes for the most common Luminy problems including Ollama connection issues, failed indexing, API key errors, and slow responses.
- [Luminy FAQ: Pricing, Privacy, and Common Questions](https://docs.luminy.tech/troubleshooting/faq.md): Frequently asked questions about Luminy, covering providers, privacy, data storage, context limits, tool permissions, and how the agent loop works.