Skip to content

Komalpreet2809/Rolequill

Repository files navigation

Rolequill

Rolequill Logo

Master Every Role with Total Context

Grounded AI drafting workspace for resumes, job descriptions, and GitHub-verified project answers.

Next.js React TypeScript Tailwind CSS


🖋️ What is Rolequill?

Rolequill isn't just another AI chatbot. It's a grounded workspace designed for applicants who want their claims to be backed by evidence. By syncing your GitHub repositories and analyzing your resume against target JDs, Rolequill ensures your application drafts are high-impact and hallucination-free.

Why it feels different:

  • 🔗 Grounded Answers: Repository README content is treated as the primary source of truth.
  • 🧠 Role-Aware Chat: The assistant understands the context of the specific role you're applying for.
  • 🎯 Project Shortlisting: Identifies the strongest matches from your profile instead of dumping everything into a prompt.

🛠️ The Experience

Rolequill Dashboard Demo

🚀 Core Features

🛡️ Grounded Context 📂 GitHub Sync
Uses resume, JD, and repo metadata to build tight, defensible project claims. Pulls real-time repository data from your OAuth session for deep analysis.
💬 Contextual Chat 📝 Intelligent Drafting
Grounded Q&A that knows when to pull from your JD versus your repo history. Generates four distinct, role-specific application drafts from your source context.

📐 Product Architecture

graph TD
    A[GitHub OAuth] --> B[Profile Sync]
    B --> C{Workspace}
    C --> D[Resume Parser]
    C --> E[JD Analyzer]
    C --> F[GitHub Repo Miner]
    D & E & F --> G[Grounded Context Engine]
    G --> H[Contextual Chat]
    G --> I[Draft Generator]
    H --> J[High-Impact Answers]
    I --> K[Tailored Applications]
Loading

🚦 Getting Started

1. Prerequisites
  • Groq API Key
  • GitHub OAuth Application
  • Node.js & npm
2. Environment Setup

Create a .env.local file in the root:

GROQ_API_KEY=your_groq_api_key
GROQ_MODEL=openai/gpt-oss-20b

NEXTAUTH_URL=http://localhost:3000
AUTH_SECRET=your_nextauth_secret
AUTH_GITHUB_ID=your_github_oauth_client_id
AUTH_GITHUB_SECRET=your_github_oauth_client_secret
3. Installation
npm install
npm run dev

🏗️ Technical Stack


(back to top)


Built with ❤️ by Komal

About

GitHub-grounded AI workspace for role-fit answers, repo ranking, and job application drafts.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors