# Slash Commands

These commands are used inside the LogiCoal chat interface. Type them at the input prompt.

All commands support autocomplete — start typing and use **Up/Down** arrows to navigate suggestions, **Tab** or **Enter** to select, and **Escape** to close the menu.

## General

| Command | Description |
| --- | --- |
| `/help` | Show all available commands and the current operation mode |
| `/clear` | Clear conversation history and start a fresh session |
| `/mode` | Show the current operation mode |
| `/mode normal` | Switch to Normal mode (approval required for writes) |
| `/mode auto` | Switch to Auto mode (full autonomy) |
| `/mode plan` | Switch to Plan mode (read-only) |
| `/init` | Analyze the codebase and generate `.COAL.md` project documentation |
| `/init --force` | Regenerate `.COAL.md`, overwriting the existing one |
| `/commands` | List all custom slash commands |
| `/dismiss` | Dismiss the current system alert (also Ctrl+D) |
| `/logout` | Log out of LogiCoal |
| `/exit` | Exit the application |
| `/quit` | Exit the application (alias for `/exit`) |

## Agent Commands

| Command | Description |
| --- | --- |
| `/agent <role> <objective>` | Spawn an agent with the given role and objective |
| `/agents` | List all active agents with status, tool counts, and token usage |
| `/agents kill <id>` | Cancel a specific agent by its ID prefix |
| `/agents kill all` | Cancel all running agents |
| `/focus <role or id>` | Focus the detail view on a specific agent |
| `/focus main` | Return focus to the main chat view |
| `/roles` | List all available agent roles (built-in and custom) |
| `/team <preset> <target>` | Run a multi-agent team pipeline |
| `/execute` | Execute the most recent plan using the odyssey |
| `/execute <instructions>` | Execute with additional instructions |
| `/history` | Show the last 15 agent runs |
| `/history <role>` | Filter agent history by role name |
| `/memory` | List all roles that have stored memories |
| `/memory <role>` | View memory entries for a specific role |
| `/memory clear <role>` | Clear all stored memory for a role |
| `/role` | Show role management help |
| `/role create <name>` | Create a new custom agent role |
| `/role edit <name>` | Show the file path to edit an existing role |
| `/role delete <name>` | Delete a custom role |

### @Mention Shorthand

Instead of `/agent`, you can use `@` followed by a role name:

```
@researcher explore the authentication system
@coder add input validation to the signup form
@planner design a caching layer for the API
```

This is identical to `/agent <role> <objective>`.

## MCP Commands

| Command | Description |
| --- | --- |
| `/mcp` | Show MCP server connection status |
| `/mcp servers` | Same as `/mcp` |
| `/mcp catalog` | Browse the curated MCP server catalog interactively |
| `/mcp add` | Launch the interactive MCP server setup wizard |
| `/mcp add <name>` | Add a specific server from the catalog by name |
| `/mcp add --custom` | Add a custom MCP server manually |
| `/mcp search <query>` | Search the npm registry for MCP server packages |
| `/mcp tools` | List all tools from all connected MCP servers |
| `/mcp tools <server>` | List tools from a specific server |
| `/mcp connect <server>` | Connect to a configured server |
| `/mcp disconnect <server>` | Disconnect from a server |
| `/mcp remove <server>` | Remove a server from config and disconnect it |
| `/mcp reload` | Reload MCP configuration and reconnect all servers |

## Custom Commands

Any `.md` file in `~/.coalcode/commands/` becomes a slash command. The filename (without extension) is the command name.

```
/mycommand              ← runs ~/.coalcode/commands/mycommand.md
/review src/auth/       ← runs the review command with arguments
```

See [Custom Commands](/content/docs/custom-commands/index.html) for how to create your own.