# Documentation

Everything you need to use LogiCoal effectively.

LogiCoal is a terminal-based AI coding assistant. Chat with an AI that can read and write files, run commands, search the web, and coordinate teams of specialized agents — all from your terminal.

## Quick Start

1. **Install** — Download from [logicoal.ai](/content/site-root.html), or run `npm install -g logicoal`, or `brew install coals-ai/tap/logicoal`
2. **Launch** — Run `logicoal` — you'll be prompted to sign up or log in on first run
3. **Chat** — Type naturally. Ask it to read files, write code, run tests, or explain your codebase.
4. **Explore** — Try `/help` to see all commands, or `/init` to generate project documentation

## Table of Contents

| Doc | Description |
| --- | --- |
| [Installation](/content/docs/installation/index.html) | Install via macOS/Windows/Linux installer, npm, or Homebrew |
| [Getting Started](/content/docs/getting-started/index.html) | Your first 15 minutes — interface, first conversation |
| [Operation Modes](/content/docs/operation-modes/index.html) | Normal, Auto, and Plan modes — how tool approval works |
| [CLI Commands](/content/docs/cli-commands/index.html) | Shell commands you run outside the app |
| [Slash Commands](/content/docs/slash-commands/index.html) | Full reference for every in-app `/command` |
| [Keyboard Shortcuts](/content/docs/keyboard-shortcuts/index.html) | All keybindings and navigation shortcuts |
| [Tools](/content/docs/tools/index.html) | File operations, shell, web search, image generation, and content moderation |
| [Agents](/content/docs/agents/index.html) | Agent roles, automatic routing, teams, and multi-agent workflows |
| [Custom Commands](/content/docs/custom-commands/index.html) | Create your own reusable slash commands |
| [Custom Roles](/content/docs/custom-roles/index.html) | Define custom agent roles with specific tools and permissions |
| [MCP Integration](/content/docs/mcp/index.html) | Extend capabilities with Model Context Protocol servers |
| [Project Initialization](/content/docs/project-init/index.html) | Generate project documentation with `/init` |
| [Configuration](/content/docs/configuration/index.html) | All config files and where they live |
| [File Attachments](/content/docs/file-attachments/index.html) | Drag-and-drop files and images into the chat |
| [Troubleshooting](/content/docs/troubleshooting/index.html) | Common problems and how to fix them |

## Reading Paths

**New to LogiCoal?** Start with [Installation](/content/docs/installation/index.html), then [Getting Started](/content/docs/getting-started/index.html) and [Operation Modes](/content/docs/operation-modes/index.html). These cover everything you need for daily use.

**Power user?** Jump straight to [Agents](/content/docs/agents/index.html), [Custom Roles](/content/docs/custom-roles/index.html), and [MCP Integration](/content/docs/mcp/index.html) to unlock the full agent system and extend LogiCoal with external tools.