CLI Overview

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`

grindxp status

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

`dashboard`

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`

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

Commands

Integrations & Automation

​Quick Commands

​status

​dashboard

​log

​Command Reference

Quick Commands

`status`

`dashboard`

`log`

Command Reference