# Grind

> Your Life Is The Game. Level Up For Real.

## Docs

- [grindxp companion](https://docs.grindxp.app/docs/cli/companion.md): View and configure your AI companion.
- [grindxp complete](https://docs.grindxp.app/docs/cli/complete.md): Mark a quest complete via self-report.
- [grindxp forge](https://docs.grindxp.app/docs/cli/forge.md): Manage automation rules and the forge daemon.
- [grindxp gateway](https://docs.grindxp.app/docs/cli/gateway.md): Manage the webhook gateway server.
- [CLI Overview](https://docs.grindxp.app/docs/cli/index.md): All Grind CLI commands: quick reference and usage notes.
- [grindxp init](https://docs.grindxp.app/docs/cli/init.md): First-time setup wizard that creates your vault, encryption key, and user profile.
- [grindxp integrations](https://docs.grindxp.app/docs/cli/integrations.md): Manage credentials for external integrations.
- [grindxp quest](https://docs.grindxp.app/docs/cli/quest.md): Create, list, and abandon quests from the command line.
- [grindxp setup](https://docs.grindxp.app/docs/cli/setup.md): Configure your AI provider and model.
- [grindxp start](https://docs.grindxp.app/docs/cli/start.md): Start a timer on a quest to earn a duration-based proof bonus.
- [grindxp stop](https://docs.grindxp.app/docs/cli/stop.md): Stop the running timer and optionally complete the quest.
- [grindxp web](https://docs.grindxp.app/docs/cli/web.md): Start and manage the Grind web dashboard.
- [Your AI Companion](https://docs.grindxp.app/docs/companion/overview.md): An AI that lives inside Grind, knows your goals, and earns autonomy over time.
- [Agent](https://docs.grindxp.app/docs/core/agent.md): The streaming agent runtime: how tool calls, streaming, and sessions work.
- [Companion](https://docs.grindxp.app/docs/core/companion.md): The AI companion system: trust ladder, provider registry, and context building.
- [Forge](https://docs.grindxp.app/docs/core/forge.md): The automation engine: signals, rules, and the daemon loop.
- [Gateway](https://docs.grindxp.app/docs/core/gateway.md): The webhook ingestion server: endpoints, signature verification, and signal normalization.
- [Proof System](https://docs.grindxp.app/docs/core/proof-system.md): How completion evidence is captured, validated, and turned into XP multipliers.
- [Quest Engine](https://docs.grindxp.app/docs/core/quest-engine.md): How quests are created, validated, and transitioned through their lifecycle.
- [Skill Trees](https://docs.grindxp.app/docs/core/skill-trees.md): How the skill tree is built, how XP flows, and how skills are structured.
- [Streaks](https://docs.grindxp.app/docs/core/streaks.md): How streaks are tracked, tiered, broken, and protected by shields.
- [Vault](https://docs.grindxp.app/docs/core/vault.md): The encrypted SQLite database: client, repositories, and migrations.
- [XP & Leveling](https://docs.grindxp.app/docs/core/xp-leveling.md): How XP is calculated, how levels are derived, and the math behind multipliers.
- [Architecture](https://docs.grindxp.app/docs/get-started/architecture.md): How Grind's packages fit together: the monorepo structure and data flow.
- [Core Concepts](https://docs.grindxp.app/docs/get-started/concepts.md): The mechanics behind quests, XP, skills, streaks, proofs, and automation.
- [Quickstart](https://docs.grindxp.app/docs/get-started/quickstart.md): Install Grind and complete your first quest in under 5 minutes.
- [What is Grind?](https://docs.grindxp.app/docs/get-started/what-is-grind.md): How Grind turns your habits and goals into a game, and why that works.
- [Grind](https://docs.grindxp.app/docs/index.md): Your Life Is The Game. Level Up For Real.
- [Installation](https://docs.grindxp.app/docs/install/index.md): Install Grind on macOS, Linux, or Windows using the installer script, Bun, or from source.
- [Self-Hosting (VPS / Server)](https://docs.grindxp.app/docs/install/self-hosting.md): Run Grind on any VPS or server. Install, initialize, keep services running with systemd, expose securely with a reverse proxy, and receive webhooks.
- [Changelog](https://docs.grindxp.app/docs/reference/changelog.md): What's changed in each Grind release.
- [Configuration](https://docs.grindxp.app/docs/reference/configuration.md): How Grind is configured: vault, companion settings, and the grind-home directory.
- [Contributing](https://docs.grindxp.app/docs/reference/contributing.md): How to set up a development environment and contribute to Grind.
- [Environment Variables](https://docs.grindxp.app/docs/reference/env.md): All environment variables Grind reads, with descriptions and defaults.
- [Game Mechanics](https://docs.grindxp.app/docs/reference/game-mechanics.md): XP calculation transparency, level curve approximations, and quest state transitions.
- [Security](https://docs.grindxp.app/docs/reference/security.md): Vault encryption, key management, companion trust risks, gateway exposure, and WhatsApp Web caveats.
- [Chat Screen](https://docs.grindxp.app/docs/tui/chat.md): Streaming AI companion chat with tool call rendering and session management.
- [Slash Commands](https://docs.grindxp.app/docs/tui/slash-commands.md): Full reference for all TUI chat slash commands.
- [Themes](https://docs.grindxp.app/docs/tui/themes.md): Customizing the TUI color scheme.
- [Terminal App](https://docs.grindxp.app/docs/tui/using-grind.md): The Grind terminal dashboard: a full-screen UI for your life OS.
- [Analytics](https://docs.grindxp.app/docs/web/analytics.md): XP trends, completion rates, streak calendars, and skill radar.
- [Chat](https://docs.grindxp.app/docs/web/chat.md): AI companion chat in the browser: streaming responses, tool visibility, and conversation history.
- [Dashboard](https://docs.grindxp.app/docs/web/dashboard.md): Live overview of your XP, active quests, skills, and recent activity.
- [Forge](https://docs.grindxp.app/docs/web/forge.md): Manage your automation rules in the browser.
- [Web App](https://docs.grindxp.app/docs/web/index.md): Grind in the browser: dashboard, AI chat, and more.
- [Quests](https://docs.grindxp.app/docs/web/quests.md): Browse and manage all your quests in the web app.
- [Skills](https://docs.grindxp.app/docs/web/skills.md): Skill tree with XP progress and level history.

## OpenAPI Specs

- [openapi](https://docs.grindxp.app/docs/api-reference/openapi.json)