git-mentor is a terminal coach for your GitHub presence: profile attractiveness, repo portfolio, social graph, and community discussions — with evidence-only advice (no invented stats or threads). It runs as an Ink TUI, ships a bundled GitHub MCP server, and exposes the same coaching brain to Cursor via MCP.

Use Ollama locally, Ollama cloud, or OpenRouter. Switch models with gitmentor model or /model in chat — no lock-in to a single vendor.

| | | | --- | --- | | Real terminal UI | Ink chat with streaming replies, slash commands, context bar, and a startup panel (model, MCP, skills). | | GitHub-native actions | Profile, README, pins, fork, follow, discussions — via gh auth and MCP tools (human confirmation for writes). | | Coaching brain | Rules + skills injected into every session (gap-coaching, profile optimization, repo deep-scan). | | Out of scope | Issues, PRs, merge/review automation, local git clone / disk deep scan. |

Quick install

Requires Node.js 20+.

npm install -g git-mentor
gitmentor init --provider ollama --model gpt-oss:20b
gitmentor login
gitmentor

From source:

git clone https://github.com/Tamsi/git-mentor.git
cd git-mentor
npm install -g .
# postinstall runs pnpm install + build

Getting started

gitmentor              # Interactive chat (default: your GitHub user)
gitmentor octocat      # Coach a public profile
gitmentor login        # GitHub (gh) + Ollama cloud
gitmentor login gh     # GitHub only
gitmentor login ollama # Ollama cloud only
gitmentor model        # Pick LLM model
gitmentor auth         # GitHub token / scopes status
gitmentor doctor       # Config, gh, LLM, MCP checks
gitmentor init         # Rules, skills, tools.md, MCP entry
gitmentor mcp          # Built-in MCP server for Cursor

With gh auth login, your profile dossier loads at startup and is cached under ~/.local/share/git-mentor/reports/<username>.md.

CLI vs chat quick reference

| Action | Terminal (one-shot) | In chat | | --- | --- | --- | | Start coaching | gitmentor · gitmentor chat @user | (opens TUI) | | Refresh profile audit | gitmentor analyze me | /analyze profile | | Deep-scan a repo | gitmentor analyze owner/repo | /analyze owner/repo | | Change model | gitmentor model | /model | | Target role | gitmentor me --role staff-engineer | /role <id> | | Followers / following | — | /followers · /following | | Discussions | — | /discussions community · /discussions owner/repo | | Apply profile writes | — | /apply bio · /apply readme · /apply pin | | Sign in | gitmentor login [gh\|ollama] | /login · /login gh | | Help | gitmentor --help | /help | | Quit | Ctrl+C | /quit · Esc (empty prompt) |

Example questions

• What are my biggest gaps for Staff Engineer?
• Who follows me vs who do I follow?
• What should I improve on my profile README?
• Which threads are active on community/community?
• Fork and follow suggestions after /trending

GitHub MCP (~24 tools)

Shipped on server github (auto-enabled when gh is authenticated):

Read / search: get_user, list_followers, list_following, list_user_repositories, get_repository, get_repository_file, list_repository_commits, list_repository_branches, list_starred_repositories, search_repositories, search_code, list_discussions, get_discussion, list_discussion_comments.

Write (own account only): update_user_profile, upsert_repository_file, update_repository_metadata, pin_repositories, fork_repository, follow_user, unfollow_user, create_repository, create_discussion, create_discussion_comment.

Reference: ~/.config/git-mentor/mcp/tools.md (regenerated on gitmentor init).

gitmentor auth refresh   # scopes for follow / fork / private repos

MCP (Cursor)

Built-in git-mentor server (gitmentor mcp):

analyze_profile, compare_role, get_recommendations, discover_trending_repos, discover_profiles_to_follow, improve_profile, analyze_repository, list_target_roles, list_rules, list_skills, get_agent_context

{
  "mcpServers": {
    "git-mentor": {
      "command": "gitmentor",
      "args": ["mcp"]
    }
  }
}

Enable the bundled github server in ~/.config/git-mentor/config.yaml (or run gitmentor init after gh auth login).

Rules, skills & config

| Location | Purpose | | --- | --- | | ~/.config/git-mentor/config.yaml | LLM, GitHub, MCP servers, active skills | | ~/.config/git-mentor/rules/*.md | Global coaching rules | | ~/.config/git-mentor/skills/<id>/SKILL.md | Procedural skills | | .git-mentor/rules/ · .git-mentor/skills/ | Project overrides |

gitmentor init

In chat: /rules, /skills, /skills use repo-deep-scan, /mcp, /export

Monorepo

packages/core · github · llm · agents · chat · cli

Development

pnpm install
pnpm build
pnpm test
pnpm --filter git-mentor dev octocat --deterministic

License

MIT — see LICENSE.