ESC
Type to search across all documentation
Documentation

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, 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 Install via macOS/Windows/Linux installer, npm, or Homebrew
Getting Started Your first 15 minutes — interface, first conversation
Operation Modes Normal, Auto, and Plan modes — how tool approval works
CLI Commands Shell commands you run outside the app
Slash Commands Full reference for every in-app /command
Keyboard Shortcuts All keybindings and navigation shortcuts
Tools File operations, shell, web search, image generation, and content moderation
Agents Agent roles, automatic routing, teams, and multi-agent workflows
Custom Commands Create your own reusable slash commands
Custom Roles Define custom agent roles with specific tools and permissions
MCP Integration Extend capabilities with Model Context Protocol servers
Project Initialization Generate project documentation with /init
Configuration All config files and where they live
File Attachments Drag-and-drop files and images into the chat
Troubleshooting Common problems and how to fix them

Reading Paths

New to LogiCoal? Start with Installation, then Getting Started and Operation Modes. These cover everything you need for daily use.

Power user? Jump straight to Agents, Custom Roles, and MCP Integration to unlock the full agent system and extend LogiCoal with external tools.