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.
LevelNameWhat it can do
0WatcherRead your data, answer questions, give suggestions
1AdvisorSuggest new quests and warn about missed habits
2ScribeCreate quests and log entries on your behalf
3AgentRun tools, modify quests, execute commands (with your approval)
4SovereignFull autonomy, no approval prompts
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: 
grindxp setup
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: 
grindxp companion soul

​
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

ProviderDefault modelAccepts
Anthropicclaude-3-5-haiku-latestAny Anthropic model string
OpenAIgpt-4o-miniAny OpenAI model string
Googlegemini-2.0-flash-expAny Google model string
Ollamallama3.1:8bAny model running locally
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.