> ## Documentation Index
> Fetch the complete documentation index at: https://mako-docs.devinagiffy.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Bot Commands

> Complete reference for Hitler bot commands

## Overview

Interact with Hitler by mentioning the bot in a channel or sending a direct message.

```
@Hitler <command>
```

Or in DMs, simply type the command without the mention.

## Display IDs

Every task is assigned a short display ID (e.g. `#1`, `#12`) scoped to your organization. Display IDs appear in task lists, slash command output, and bot responses. Use them with `/done`, `/blocked`, and `/unblocked` to reference tasks quickly.

## Task Commands

### Create Task

Create a new task using natural language. Tasks are auto-confirmed immediately — no confirmation buttons needed.

<CodeGroup>
  ```text Simple theme={null}
  @Hitler remind me to review the budget
  ```

  ```text With deadline theme={null}
  @Hitler submit expense report by Friday
  ```

  ```text With priority theme={null}
  @Hitler urgent: call the client about the contract
  ```
</CodeGroup>

The bot will parse your request and create the task:

```
got it, adding:
⏳ #7 review the budget
```

### List Tasks

View your current tasks.

```
@Hitler tasks
```

Options:

* `@Hitler tasks open` - Only open tasks
* `@Hitler tasks today` - Tasks due today
* `@Hitler tasks overdue` - Overdue tasks

### Complete Task

Mark a task as complete.

```
@Hitler done #7
```

Or use the status dropdown on task list messages.

### Update Task

Modify an existing task.

```
@Hitler update #7 due tomorrow
@Hitler update #7 priority high
```

## Mood Commands

### Log Mood

Record your daily mood check-in.

```
@Hitler mood
```

The bot will present an interactive prompt:

```
How are you feeling today?

😢 1  |  😕 2  |  😐 3  |  🙂 4  |  😊 5
```

You can also log directly:

```
@Hitler mood 4
@Hitler mood 4 "Feeling good after the team meeting"
```

### View Mood History

See your recent mood entries.

```
@Hitler mood history
```

### Mood Stats

View your mood statistics.

```
@Hitler mood stats
```

Shows:

* Average mood (7 days, 30 days)
* Mood trend
* Streak information

## Journal Commands

### Create Journal Entry

Write a private journal entry.

```
@Hitler journal <your thoughts>
```

<Note>
  Journal entries are completely private. They are never shared with managers or included in any
  reports.
</Note>

### View Journals

See your recent journal entries.

```
@Hitler journals
```

## Help & Info

### Help

List available commands.

```
@Hitler help
```

For help on a specific command:

```
@Hitler help task
@Hitler help mood
```

### Status

Check your current status.

```
@Hitler status
```

Shows:

* Open tasks count
* Today's mood (if logged)
* Any pending drafts

### Stats

View your productivity statistics.

```
@Hitler stats
```

Shows:

* Tasks completed (7 days, 30 days)
* Completion rate
* Average mood

## Inquiry Commands

### Start Inquiry

Create a private inquiry with HR/management.

```
@Hitler inquiry <topic>
```

Example:

```
@Hitler inquiry Question about remote work policy
```

### View Inquiries

List your open inquiries.

```
@Hitler inquiries
```

## Quick Actions

### Snooze

Snooze a reminder or notification.

```
@Hitler snooze
@Hitler snooze 1h
@Hitler snooze tomorrow
```

### Skip

Skip today's mood check-in.

```
@Hitler skip mood
```

<Warning>Skipping check-ins too often may be flagged by the system.</Warning>

## Natural Language

Hitler understands natural language in any supported language. You don't need to memorize exact syntax — the AI figures out what you want and uses the right tools to help.

<CodeGroup>
  ```text English theme={null}
  @Hitler remind me to call John tomorrow
  @Hitler how many tasks do I have?
  @Hitler mark the budget review as done
  ```

  ```text Hinglish theme={null}
  @Hitler kal mujhe report submit karna hai
  @Hitler kya tasks hai mere pending?
  @Hitler meri tasks batao
  ```

  ```text Spanish theme={null}
  @Hitler añade una tarea: revisar el presupuesto
  @Hitler cuántas tareas tengo?
  ```
</CodeGroup>

The AI uses tool calling to access real data (tasks, moods, stats) and auto-confirms task creation.

## Conversational AI

Hitler goes beyond commands - it's a conversational assistant that understands context.

### Casual Conversations

You can chat naturally with Hitler:

```text theme={null}
User: hey, how's it going?
Hitler: hey! doing good, what's up?

User: feeling a bit overwhelmed today
Hitler: hang in there. want to talk about what's on your plate?
```

<Note>
  Hitler detects mood signals in your messages and may silently log mood inferences to help track
  wellbeing over time.
</Note>

### Casual Task Mentions

Hitler picks up tasks even when you mention them casually. Tasks are auto-confirmed:

```text theme={null}
User: tomorrow I need to finish the report and send invoices

Hitler: got it, adding 2 tasks:
1. ⏳ #14 finish the report
2. ⏳ #15 send invoices
```

You don't need explicit task syntax - Hitler detects plans from natural conversation.

### Multiple Tasks at Once

Mention several tasks in one message:

```text theme={null}
User: my tasks for the week: review budget, call client, and update docs

Hitler: got it, adding 3 tasks:
1. ⏳ #16 review budget
2. ⏳ #17 call client
3. ⏳ #18 update docs
```

### Context Awareness

Hitler remembers your recent conversation:

```text theme={null}
User: I have a meeting with Sarah at 3
Hitler: noted, adding that as a task

User: actually make it 4
Hitler: updated: meeting with Sarah at 4
```

### Thread Replies

After Hitler first responds in a thread, you don't need to @mention it again - just reply directly.

```text theme={null}
User: @Hitler what's on my list?
Hitler: you have 3 pending tasks...

User: mark the first one done    <- no @mention needed
Hitler: done: #7 review the budget
```

### Language Support

Hitler understands English and Hinglish (Hindi-English mix):

```text theme={null}
User: kal mujhe report submit karna hai
Hitler: got it, adding "submit report" for tomorrow
```

## Interactive Messages

Task list messages include interactive controls for quick actions:

### Status Dropdown

Each task in the `/tasks` list has a status dropdown menu. Select a new status to update the task inline:

| Status      | Meaning                 |
| ----------- | ----------------------- |
| Pending     | Not started yet         |
| In Progress | Currently working on it |
| Completed   | Done                    |
| Blocked     | Cannot proceed          |

The task list refreshes automatically after you change a status.

### Blocked Button

Each task has a **Blocked** button. Clicking it opens a modal where you enter the blocker reason. The task status is updated and the blocker is tracked for escalation.

### Extend Button

Each task has an **Extend** button. Clicking it opens a modal where you type a new due date in natural language (e.g. "tomorrow 5pm", "in 3 hours", "next friday"). The due date is updated and you receive a DM confirmation.

### Mood Buttons

When the bot sends a mood check-in prompt, click one of the 5 emoji buttons (1-5) to log your mood instantly.

## Error Messages

| Error                      | Meaning                  | Solution                             |
| -------------------------- | ------------------------ | ------------------------------------ |
| "I didn't understand that" | AI couldn't parse intent | Rephrase or use explicit command     |
| "Task not found"           | Invalid task ID          | Check `/tasks` for valid display IDs |
| "Not authorized"           | Permission denied        | Contact your admin                   |
| "Already logged today"     | Mood already recorded    | Wait until tomorrow or use `update`  |

## Rate Limits

To prevent spam, commands are rate-limited:

| Action           | Limit     |
| ---------------- | --------- |
| Task creation    | 20/hour   |
| Mood logging     | 5/day     |
| Journal entries  | 10/day    |
| General commands | 60/minute |

## Slash Commands

Hitler provides dedicated slash commands for common actions. Direct commands respond instantly without going through the LLM.

### Direct Commands (No LLM)

| Command             | Short Description                    | Usage Hint                         |
| ------------------- | ------------------------------------ | ---------------------------------- |
| `/tasks`            | List your current tasks              | `[open\|today\|overdue]`           |
| `/done`             | Mark a task as completed             | `<#id or title>`                   |
| `/blocked`          | Report a blocker on a task           | `#<id> <reason>`                   |
| `/unblocked`        | Resolve a blocker on a task          | `#<id> [note]`                     |
| `/status`           | Show your task completion summary    |                                    |
| `/mood`             | Log your mood or view trends         | `[1-5] [note] \| history \| stats` |
| `/journal`          | Create or list journal entries       | `[text to journal]`                |
| `/help`             | Show available commands and help     | `[topic]`                          |
| `/log-intervention` | Log work you picked up for someone   | `@user <description>`              |
| `/clear-dms`        | Clear all bot messages from your DMs |                                    |

### Admin/Manager Commands (No LLM)

| Command     | Short Description                 | Usage Hint       |
| ----------- | --------------------------------- | ---------------- |
| `/red-card` | Manually issue an escalation card | `@user <reason>` |

### LLM-Powered Commands

| Command   | Short Description                      | Usage Hint                   |
| --------- | -------------------------------------- | ---------------------------- |
| `/hitler` | Talk to the bot using natural language | `<anything you want to say>` |

<Info>
  The `/hitler` command routes through Claude which has access to 30+ tools including: create/update/complete tasks, set reminders, log mood, check KPI, manage checklists, move pipeline stages, reassign tasks, browse URLs, and more.
</Info>

<Note>
  **Total: 12 slash commands** — 10 direct (no LLM), 1 admin-only, 1 LLM-powered.
  Direct commands respond ephemerally (only visible to you), making them perfect for quick checks during meetings.
</Note>

## AI App Features

Hitler supports Slack's AI App (Assistant) framework, enabling a split-pane experience alongside any Slack channel.

### Split-Pane Assistant View

Click the Hitler app icon in any channel header to open the assistant in a side panel. This gives you a dedicated 1:1 conversation thread without leaving the channel you're working in.

### Suggested Prompts

When you open the assistant, context-aware prompt suggestions appear:

* **Default prompts**: "My Tasks", "New Task", "My Status", "Help"
* **Client channel prompts**: When viewing a client channel, prompts automatically adjust to show client-specific actions like "Show \[Client] Tasks" and "Create task for \[Client]"
* **General channel prompts**: Shows "Channel Tasks" to query tasks related to the current channel

Prompts update automatically when you switch channels.

### Loading States

While the bot processes your message, it displays an "is thinking..." status indicator in the assistant thread.

### Streaming Responses

In the assistant view, longer responses stream progressively — you see the response build up sentence by sentence rather than waiting for the full reply. This provides faster perceived response times. Short responses and structured content (task lists, blocks) are delivered instantly.

### Context-Aware Prompts

The assistant detects which channel you're viewing and customizes its suggestions. If you're in a client's Slack channel (matched by the client's configured `slackChannelId`), the prompts shift to client-specific actions. This makes it faster to create and query tasks for the client you're currently focused on.

## App Home Tab

The Hitler bot provides an App Home tab in Slack with information about available features:

* Tasks — create and manage tasks with natural language
* Mood Tracking — log daily mood on a 1-5 scale
* Private Journal — keep notes only you can see
* Inquiries — start private conversations with HR/management

Click on the Hitler app in your Slack sidebar to access the Home tab.
