Overleaf Integration

Overleaf Integration & Homework Workflow

Create, manage, and sync Overleaf LaTeX documents. Full homework transcription pipeline.

Quick Start

# Add CLI to PATH
export PATH="$PATH:/workspace/overleaf/bin"

# Common operations
overleaf list                     # List all projects
overleaf status                   # Check sync status
overleaf pull                     # Download from Overleaf
overleaf push                     # Push local changes

Important Directories

All Overleaf work happens in:

/workspace/overleaf/projects/

Each project gets its own subdirectory:

projects/
├── hw5-solutions/
│   ├── main.tex
│   ├── .overleaf/       # Sync metadata
│   └── figures/
└── research-paper/
    ├── main.tex
    └── .overleaf/

Homework Transcription Workflow

When to Use

Trigger phrases:

• "This is my work for homework/problem set X"
• "Transcribe this to LaTeX"
• "Create solutions document for [class]"
• Any combination of: homework images + class name + request to create document

Quick Reference

Delegation Pattern (Recommended)

For homework tasks, delegate the entire workflow so you stay responsive:

from task_delegation import delegate_task

task_id = delegate_task(
    description="Process CHEN5838 Problem Set 1 homework submission",
    context={
        "original_prompt": user_message,
        "user_instructions": "Box final answers",  # Extracted from user message
        "image_paths": ["/tmp/discord_attachments/page1.jpg"],
        "problem_set_source": "Desktop/CHEN5838/problem_sets/PS1.pdf",
        "class_name": "CHEN5838",
        "assignment": "PS1",
        "subject": "Chemical Engineering",
        "workflow": "homework"
    },
    discord_channel_id="DISCORD_CHANNEL_ID",
    priority=3
)

# Respond immediately:
f"On it! I've started processing your PS1 submission (task #{task_id})."

Full Workflow (For Sub-Agent)

from homework_workflow import HomeworkWorkflow

workflow = HomeworkWorkflow()
result = workflow.process(
    image_paths=["/tmp/discord_attachments/page1.jpg"],
    problem_set_path="Desktop/CHEN5838/problem_sets/PS1.pdf",
    output_folder="Desktop/CHEN5838/homeworks/PS1",
    project_name="CHEN5838 Problem Set 1 Solutions",
    subject="Chemical Engineering",
    user_instructions="Box final answers"
)

Overleaf Operations

API Operations (Fast - Do Directly)

import sys
sys.path.insert(0, '/workspace/overleaf/scripts')
from overleaf_api import OverleafAPI, load_cookie

api = OverleafAPI(load_cookie())
projects = api.get_enriched_projects()

Quick Reference

Sync Operations

For bidirectional sync, use the overleaf-sync skill or CLI:

# Link local directory to Overleaf project
cd /path/to/local/project
overleaf link 507f1f77bcf86cd799439011

# Pull from Overleaf
overleaf pull

# Edit files locally...
# Check what changed
overleaf status

# Push changes (generates Playwright steps)
overleaf push

Write Operations (Playwright MCP)

Write operations require browser automation.

Create New Project

1. Navigate: browser_navigate to https://www.overleaf.com/project
2. Click "New Project" button
3. Select "Blank Project"
4. Enter project name
5. Get project ID from URL

Playwright Sequence for Project Creation

1. mcp__playwright__browser_navigate → https://www.overleaf.com/project
2. mcp__playwright__browser_snapshot → Get page state
3. mcp__playwright__browser_click → "New Project" button
4. mcp__playwright__browser_click → "Blank Project"
5. mcp__playwright__browser_type → Enter project name
6. mcp__playwright__browser_click → "Create"
7. mcp__playwright__browser_wait_for → time: 3
8. mcp__playwright__browser_press_key → "Control+a"
9. mcp__playwright__browser_type → Paste LaTeX content
10. mcp__playwright__browser_wait_for → time: 10 (compilation)

LaTeX Templates

Basic Article

\documentclass{article}
\usepackage{amsmath,amssymb,amsthm}
\usepackage{geometry}
\geometry{margin=1in}

\title{Document Title}
\author{Student Name}
\date{\today}

\begin{document}
\maketitle

\section{Introduction}

\end{document}

Problem Set

\documentclass{article}
\usepackage{amsmath,amssymb}
\usepackage{enumitem}

\begin{document}

\textbf{Problem 1.}
\begin{align}
    % solution here
\end{align}

\end{document}

Session Management

Session cookie location: /workspace/overleaf/.credentials

If session expires:

1. Login to Overleaf in browser
2. Open DevTools (F12) → Application → Cookies
3. Copy overleaf_session2 value
4. Update .credentials file

Error Handling

When User Says...

OneDrive Paths

Common locations for the user's classes:

• Desktop/CHEN5838/ - Chemical Engineering course
• Desktop/PHYS1140/ - Physics TA materials

Related Skills

• /overleaf-sync - Bidirectional sync with Overleaf (push/pull)
• /task-delegation - For delegating complex Overleaf tasks
• /browser-automation - Playwright MCP reference