Skip to content
RoleSpecOS

Your job search.
Fully in your hands.

One private workspace for your next chapter. Tailor your resume, find the right opportunities, and move every application forward.

v1.0.2 desktop preview · Windows x64 · Prefer self-hosting?

ROLESPEC OS / RESUME STUDIOAPP PREVIEW
RoleSpec resume studio showing career history sections beside a paginated resume preview

Master resumes, role-specific versions, ATS inspection, and paginated PDF export. Screenshots use sample data. Open full screenshot

Open source, by design.AGPL-3.0Self-hosted workspaceYour choice of AINo managed AI service

Less tab switching.
More moving forward.

Your resume builder, application tracker, and outreach tools belong in the same place. RoleSpec connects the work between them.

  1. 01

    Bring your experience.

    Import a resume and build your master career history. Keep your skills, experience, and achievements together.

  2. 02

    Make every role specific.

    Save a posting, inspect its requirements, and create a tailored resume from your verified credentials.

  3. 03

    Keep the next step in sight.

    Draft your cover letter or outreach, track the application, and plan the follow-up in one workspace.

Your experience.
Sharper for every role.

Keep the full story in your master resume. Create a focused version for each opportunity without rebuilding it from scratch.

  • Token matching against the job description
  • Five-dimension resume auditing
  • Action–Result–Reason rewrite suggestions
  • Raw-text “View as ATS” inspection

A clearer view of your resume, not a promise of passing every employer’s ATS.

RESUMES / MASTER → TAILORED → PDF

One career history.
Many possibilities.

Your master resume stays the source.
Each role gets its own focused version.

Four export templates
  • Minimal
  • Modern
  • Harvard
  • Corporate

A place for every lead.
A plan for what’s next.

Switch between Kanban and table views. Keep requirements, follow-ups, and your calendar agenda close to the applications they belong to.

  1. Interested
  2. Applied
  3. Screening
  4. Interview
  5. Offer
  6. Rejected
  7. Archived

Read the requirements early.

Surface visa sponsorship, clearance, and remote or onsite requirements before investing time in an application.

Spot the warning signs.

Heuristic checks flag suspicious redirects, unrealistic compensation, and potential scam or ghost-job signals for your review.

Found a role?
Bring it with you.

Discover targeted job-board links, then clip a posting into your pipeline with the companion Chrome extension. Keep the description and requirements beside your next action.

Set up the extension

Manifest V3 · Built from source · Load unpacked in Chrome, Brave, or Edge

LinkedInIndeedGreenhouseLeverWorkdayAshby
Your RoleSpec workspacePosting saved. Context kept.

Your AI.
Your way of running it.

Use a subscription you already have, a local model, free hosted models, or a provider API. First-run setup helps you choose and test the connection.

AI provider options and supported environments
Connect withHow it worksWhere it runs
Your subscriptionCodex CLI · Claude CodeConnect an eligible ChatGPT or Claude subscription through its CLI. Provider usage limits still apply.Host / desktop
Free hosted modelsOpenCodeChoose from the zero-cost models discovered by the OpenCode CLI. Availability and rate limits can change.Host / desktop
Your own hardwareOllama · LM StudioKeep AI processing local with a model running on your own CPU or GPU.Host / desktop
Cloud APIsOpenAI · Anthropic · Gemini · DeepSeekBring your own API key. Usage is billed by the provider you choose.Host / desktop / Docker

Resume editing and application tracking work without AI. Tailoring, analysis, matching, and generated writing need a working provider. Docker supports cloud API providers; CLI and local-model connections need a host process.

Your career is personal.
Keep control of it.

Self-host the workspace and choose where your AI runs. Local models keep AI processing on your hardware; hosted providers receive the prompts you send to them.

Credentials encrypted at rest
Stored AI provider credentials use AES-256-GCM encryption.
Account-scoped data
Resumes, applications, and exports are scoped to the authenticated user.
Inspectable source
AGPL-3.0 code, an open issue tracker, and a documented security policy.

One app.
From browser to desktop.

The Tauri desktop shell runs the same Next.js server as the web app, with a bundled Node runtime and a private PostgreSQL database. One schema. One migration history.

Application
Next.js 16 · React 19 · TypeScript · Tailwind CSS 4
Data & state
PostgreSQL · Prisma 7 · Zustand · TanStack Query
AI & exports
Vercel AI SDK 7 · CLI providers · @react-pdf/renderer
Desktop & browser
Tauri 2 · Rust · PostgreSQL 17 · Manifest V3 extension

Make it your workspace.

Install the Windows desktop preview, or run the web app yourself. Your choice of setup, your choice of AI.

Windows desktop

Preview

Install, open, and complete onboarding. The runtime and private database come bundled. No Docker, Node.js, or environment file to set up.

Download v1.0.2

Windows 10/11 x64 · WebView2 required

Check the release notes and checksums before installing. Preview builds may show a Windows SmartScreen warning. Automatic updates are not available in the current release.
Self-host with Docker

Start with Docker Desktop. Copy the environment template and configure a cloud AI provider.

git clone https://github.com/Ry0x7/rolespec-os.git
cd rolespec-os
cp .env.docker.example .env.docker
docker compose up -d --build

Open http://localhost:3000. Your private workspace logs you in automatically. CLI subscriptions and local models are unavailable inside Docker.

Run directly with Node.js

Requires Node.js 22+ and PostgreSQL. Configure DATABASE_URL and AUTH_SECRET in .env.

git clone https://github.com/Ry0x7/rolespec-os.git
cd rolespec-os
npm install
cp .env.example .env
# Configure .env before continuing
npx prisma migrate dev
npx prisma db seed
npm run dev

Open http://localhost:3100 and complete first-run setup. See the full setup guide for provider configuration.

A few things to know.

Is RoleSpec an AI-free app?

You can edit resumes and track applications without AI. AI-powered analysis, tailoring, matching, and writing require a connected provider. You choose it during setup.

Does “self-hosted” mean everything stays offline?

Your workspace runs on your machine or server. With Ollama or LM Studio, AI processing can stay local too. Subscription CLIs, free hosted models, cloud APIs, and job-board links still use external services.

Is there a hosted demo or an account to create here?

This is the product showcase. The screenshots are from RoleSpec, not a live workspace. Install the desktop preview or self-host the app to use your own private workspace.

Can I contribute?

Yes. Bug fixes, workflow improvements, accessibility work, documentation, and desktop packaging contributions are welcome. Start with the contributing guide.

Your next chapter.
Start on your terms.

Bring your experience. Keep your context. Make the next application count.