Roger

Roger is a local, AI-powered career assistant that runs in AI coding tools (Gemini CLI), designed to automate the tailoring of high-quality resumes and cover letters.

"Who are we today?"

Roger is named after Roger Smith, the alien from the animated sitcom American Dad!.

Roger is famous for his ability to craft completely distinct, fully realized personas for any situation. He doesn't just "change clothes"; he constructs an entire backstory, personality, and set of credentials to fit a specific narrative. Whether he needs to be a hard-nosed detective, a wedding planner, or a corrupt politician, Roger has a persona for it.

---

Table of Contents

• Prerequisites
• Installation & Setup
• Quick Start
• Critical Concept
• Features
• Project Structure
• Customization
• Troubleshooting

Prerequisites

Before running the agent, ensure your environment is fully prepared:

1. Gemini CLI: Installed and authenticated with your Google account. This is the interface where you will chat with the agent.

   • Installation Guide

2. Python 3.11+: Required to run the local MCP Server script. The server acts as a bridge between the AI model and your local file system.

3. uv: Modern, fast Python package manager for managing dependencies. This project uses uv instead of traditional pip.

   • Installation: curl -LsSf https://astral.sh/uv/install.sh | sh
   • Or via Homebrew: brew install uv

4. LaTeX Environment: A working local installation of pdflatex or xelatex. The agent relies on this engine to render the final PDF. (Detailed installation instructions in the next section)

5. Google Gemini API Key: Exported in your shell environment (GEMINI_API_KEY). This allows the CLI to communicate with the Gemini models.

Installation & Setup

1. Fork and Clone the Repository

Click the "Fork" on top-right of the page, and create your forked repo.

git clone https://github.com/yourname/Roger.git
cd Roger

2. Install LaTeX Distribution

The agent requires a LaTeX compiler to generate PDFs. Choose the installation method for your operating system:

macOS

Option A: Full Installation (Recommended)

brew install --cask mactex

This installs the complete MacTeX distribution (~4GB). After installation, you may need to add LaTeX to your PATH:

export PATH="/Library/TeX/texbin:$PATH"

Linux (Ubuntu/Debian)

Full Installation:

sudo apt-get update
sudo apt-get install texlive-full

Windows

Option 1: Download from miktex.org Option 2: Download from tug.org/texlive

Verify Installation: After installation, verify LaTeX is working:

pdflatex --version

You should see version information for pdfLaTeX.

3. Install Python Dependencies and Start MCP Server

Navigate to the MCP server directory and use uv to install dependencies:

cd mcp-latex-server

# Install dependencies
uv venv .venv
uv pip install -r requirements.txt

# Start MCP Server
uv run latex_server.py

4. Configure MCP Server in Gemini CLI

Add the LaTeX MCP server to your Gemini CLI configuration:

1. Open or create the Gemini settings file:

# Create .gemini directory if it doesn't exist
mkdir -p ~/.gemini

# Edit settings.json (use your preferred editor)
open ~/.gemini/settings.json

1. Add the MCP server configuration:

{
  "mcpServers": {
    "latex": {
      "command": "uv",
      "args": [
        "--directory",
        "<YOUR_PATH>/Roger/mcp-latex-server",
        "run",
        "latex_server.py"
      ],
      "env": {
        "LATEX_BASE_PATH": "<YOUR_PATH>/Roger"
      },
      "cwd": "<YOUR_PATH>/Roger"
    }
  }
}

Important: Replace <YOUR_PATH>/Roger with your actual project path. You can get the full path by running:

cd /path/to/Roger
pwd

5. Populate Your Context (Crucial Step)

The quality of the output depends entirely on the quality of your input.

• Open the context/ folder
• Fill experience.md, projects.md, skills_inventory.md, and other relevant files with your actual data following the examples format that has been provided in the files.

Tip: Be verbose in these master files. Include every metric, every tool used, and every achievement. The agent acts as an editor; it's easier for it to summarize a long list than to invent details that aren't there. For example, instead of "Improved performance," write "Reduced API latency by 40% (200ms to 120ms) by implementing Redis caching."

QuickStart

Step 1: Launch Gemini CLI

The MCP server will start automatically when you launch Gemini CLI:

gemini

Tips: Make s

...