Configuration

All LogiCoal configuration files and their locations.

User Configuration

These files live in your home directory and apply globally.

~/.coalcode/config.json

Main configuration file. Managed automatically — you rarely need to edit this directly.

Contains:

• Auth tokens — Access token, refresh token, expiry
• User info — Name, email (cached from server)
• Team info — Team ID and name
• API URL — Defaults to https://coals.ai
• Device ID — Unique device identifier, generated on first run
• Usage — Plan name and remaining token balance
• Dismissed alerts — IDs of dismissed server alerts

To change the API URL:

logicoal config --api-url https://my-instance.example.com

~/.coalcode/commands/

Custom slash command files. Each .md file becomes a /command.

See Custom Commands.

~/.coalcode/agents/roles/

Custom agent role definitions. Each .md file defines a role.

See Custom Roles.

~/.coalcode/agents/memory/

Persisted agent memories. JSON files, one per role. Managed automatically by the agent system.

View with /memory <role>. Clear with /memory clear <role>.

~/.coalcode/agents/history/

Agent run history. JSON files named by date, ID, and role. Managed automatically.

View with /history.

~/.logicoal/mcp.json

Global MCP server configuration. Applies to all projects.

See MCP Integration.

Project Configuration

These files live in your project directory and are project-specific.

.COAL.md

AI-generated project documentation. Read automatically at the start of every session. Generated by /init.

See Project Initialization.

.coals/mcp.json

Project-local MCP server configuration. Servers defined here override global servers with the same name.

See MCP Integration.

.coals/agents/

Project-local custom agent roles. Override user-global roles of the same name.

See Custom Roles.

.coals/ (workspace)

Workspace directory for plans, research, artifacts, prompts, and progress tracking. Created by /init.

See Project Initialization.

Summary Table