#Architecture

┌──────────────────────────────────────────────────────────┐
│                    Claudia RH (Tauri)                     │
│                                                          │
│  ┌──────────┐  ┌────────┐  ┌──────────┐  ┌──────────┐  │
│  │Dashboard │  │Profile │  │ Pending  │  │ Feedback │  │
│  │          │  │ (chat) │  │ actions  │  │ (graphs) │  │
│  └──────────┘  └────────┘  └──────────┘  └──────────┘  │
│                                                          │
│       React 19 + TypeScript + xterm.js                   │
│  ─────────────────────────────────────────────────────   │
│       Rust (Tauri v2) + SQLite + keyring                 │
│                                                          │
│  ┌─────────────────────────────────────────────────┐    │
│  │  PTY Manager  →  claude --chrome  →  Chrome     │    │
│  │                   (Claude Code CLI)   Extension  │    │
│  └─────────────────────────────────────────────────┘    │
└──────────────────────────────────────────────────────────┘
         ↕ Tauri events (SQLite watcher, idle watcher)
    SQLite DB: jobs · applications · pending actions · sessions

#Tech stack

Layer	Technology	Version	Purpose
Desktop shell		v2	Native Windows app without Electron
Frontend		19.1	Reactive UI
UI language		5.8	Type-safety on the frontend
Backend		2021 edition	System logic, PTY, SQLite, credentials
Database		via rusqlite	Jobs, applications, sessions, pending actions
Terminal	xterm.js + portable-pty	6.x	Real PTY embedded inside the app
AI		latest	Application agent with Chrome access
Credentials	keyring v3	3.x	Windows Credential Manager — never plain text

#Prerequisites

#Claude in Chrome extension setup — critical step

Without this step the agent cannot control the browser and will do nothing.

claude

/chrome

#Installation

#Option 1 — npm (recommended)

Installs the app and the Claude Code CLI in one command:

npm install -g claudia-rh

On first run, claudia-rh downloads the Windows executable automatically:

claudia-rh

#Option 2 — direct download

Download the latest installer from the Releases page:

#Option 3 — build from source

# 1. Clone
git clone https://github.com/JohnGabie/claudia-rh.git
cd claudia-rh

# 2. Install dependencies
npm install

# 3. Dev mode
npm run tauri dev

# 4. Production build
npm run tauri build

The installer will be at src-tauri/target/release/bundle/.

#Project structure

claudia-rh/
├── src/                        # React frontend
│   ├── components/
│   │   ├── Dashboard.tsx       # Statistics and session control
│   │   ├── Perfil.tsx          # Conversational profile chat
│   │   ├── Vagas.tsx           # Job history and applications
│   │   ├── Pendencias.tsx      # Pending blockers (captcha, etc.)
│   │   ├── Feedback.tsx        # Results analysis + charts
│   │   ├── Configuracoes.tsx   # Credentials, triggering, strategy
│   │   ├── Terminal.tsx        # Integrated PTY terminal
│   │   └── Sidebar.tsx         # Navigation + badges
│   └── styles/tokens.css       # Design tokens (colours, typography)
│
└── src-tauri/src/              # Rust backend
    ├── commands/
    │   ├── perfil.rs           # candidate_base.yaml + search_variants.yaml
    │   ├── sessao.rs           # Session triggering and management
    │   ├── curriculos.rs       # CV generation
    │   ├── cover_letter.rs     # Cover letter generation
    │   ├── feedback.rs         # Feedback analysis
    │   ├── credenciais.rs      # Keyring (Windows Credential Manager)
    │   └── estado.rs           # Statistics queries
    ├── db/schema.sql           # Full SQLite schema
    ├── pty_manager.rs          # PTY process management + session signals
    ├── idle_watcher.rs         # Inactivity detection (Win32 GetLastInputInfo)
    └── notificacoes.rs         # Windows notifications (Tauri plugin)

#Disclaimer

This tool automates browser actions on your behalf. Ensure the terms of service of the job platforms you use allow automation. The author is not responsible for account bans or other effects resulting from using this tool.

#Contributing

Issues and PRs are welcome. Before opening a large PR, open an issue to discuss the approach.

Read the contributing guide for dev setup, commit conventions, and PR process. This project follows the Contributor Covenant Code of Conduct. To report security vulnerabilities, see the security policy.

Built with ☕ and way too many rejected applications.

If you made it this far and found it useful — a star makes a difference! ⭐