Skip to main content
Your companion is an AI assistant with access to your vault: quests, XP, streaks, skill progress, and activity history. It can answer questions, suggest what to work on next, help you reflect on your habits, and, at higher trust levels, take actions on your behalf. It is optional. Grind works fully without it.

​
Trust Ladder

The companion starts in observation mode. It gains capabilities as you increase its trust level, either manually or by letting it earn it through demonstrated reliability. Most people stay at level 1 or 2. Level 4 is for power users who trust the companion completely. At levels 3 and 4, the companion can run shell commands and edit files. Review what it does carefully before granting these levels.

​
Setting Up

Configure your AI provider once:
You’ll choose a provider (Anthropic, OpenAI, Google, or a local Ollama instance), enter an API key, select a model, and give your companion a name. That’s it. To adjust the companion’s personality, focus areas, or trust level later:

​
Using the Companion

Open the chat interface from the terminal or web app: From there, just talk to it. Some things you can ask:
  • “What should I work on today?”
  • “How is my fitness streak looking?”
  • “Create a daily quest for morning reading.”
  • “Why did my XP drop this week?”

​
Provider Options

Your conversation goes to whichever provider you’ve configured, and nowhere else. Grind does not have a backend that receives your data.

​
Connecting Messaging Apps

You can also chat with your companion through Telegram, Discord, or WhatsApp. See Integrations to connect them.