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

# CLI Overview

> All Grind CLI commands: quick reference and usage notes.

```bash theme={null}
grindxp <command> [subcommand]
```

All commands open the vault at `~/.grind/vault.db` on startup. Run `grindxp init` first if the vault doesn't exist yet.

***

## Quick Commands

### `status`

```bash theme={null}
grindxp status
```

Snapshot of your current state: character level, XP bar, active quests, best streak, and top skills.

### `dashboard`

```bash theme={null}
grindxp dashboard
```

Time-aware overview. Output adapts to time of day: morning shows today's quests and streak status, evening shows what you completed and XP earned.

For a persistent real-time view, use `grindxp` (the TUI) instead.

### `log`

```bash theme={null}
grindxp log
```

Record a quick activity without creating a full quest. Prompts for description, optional skill tags, and optional duration. XP flows to tagged skills. Use this for one-offs; create a proper quest for recurring behaviors to get streak bonuses.

***

## Command Reference

| Command                             | Description                                                     |
| ----------------------------------- | --------------------------------------------------------------- |
| [`init`](/docs/cli/init)                 | First-time setup: creates vault, encryption key, user profile   |
| [`setup`](/docs/cli/setup)               | Configure AI provider and model                                 |
| [`quest`](/docs/cli/quest)               | Create, list, and abandon quests                                |
| [`start`](/docs/cli/start)               | Start a timer on a quest (earns duration proof bonus)           |
| [`stop`](/docs/cli/stop)                 | Stop the running timer, optionally complete the quest           |
| [`complete`](/docs/cli/complete)         | Mark a quest complete via self-report                           |
| [`forge`](/docs/cli/forge)               | Create/list/toggle automation rules; run daemon                 |
| [`gateway`](/docs/cli/gateway)           | Start/stop/restart the webhook gateway server                   |
| [`companion`](/docs/cli/companion)       | View and configure your AI companion                            |
| [`integrations`](/docs/cli/integrations) | Manage Telegram, Discord, WhatsApp, Google Calendar credentials |