← Back to HireAgent
Setup Guide

Getting started with HireAgent

A simple, step-by-step walkthrough - no technical experience needed. Pick your plan below and follow along. You'll be up and running in about 10 minutes.

Before you start

Right after you subscribe, we send you a welcome email. Keep it handy - it has your personal HireAgent web address and your sign-in details. Everything below uses what's in that email.

The Basic plan is run from a small free app on your computer called the “CLI” (command-line tool). Don't worry - you only type a few short lines, and we give you each one to copy.
1

Open your welcome email

Find the email titled “Your HireAgent tenant is ready”. It contains:

  • Your web address (looks like yourname.hireagent.clevotics.com)
  • Your access key (a long secret code)
  • A link to download the HireAgent app
2

Download and install the HireAgent app

Click the download link in your email and open the file. It installs thehireagent tool. Then open your computer's terminal (on Windows it's “Command Prompt”, on Mac it's “Terminal”).

3

Sign in

Type this, using the web address from your email, then press Enter. It will ask for your access key - paste it in.

hireagent login --url https://yourname.hireagent.clevotics.com

You should see “Logged in.”

4

Connect your email inbox

This lets HireAgent read incoming applications and send replies. Run these four lines, replacing the example with your details:

hireagent settings set IMAP_USER you@yourcompany.comhireagent settings set IMAP_PASSWORD your-app-passwordhireagent settings set SMTP_USER you@yourcompany.comhireagent settings set SMTP_PASSWORD your-app-password
What is an “app password”? For security, email providers (Gmail, Zoho, Outlook) want a special password for apps - not your normal login. It takes a minute to create: search your provider's help for “create app password”, generate one, and paste that here. Your real password is never used.
5

Tell it what a good candidate looks like

Describe the role and what matters to you in plain English. HireAgent uses this to decide who fits.

hireagent jobs create --title "Sales Executive" --criteria "2+ years sales experience, fluent English, based in India"
6

Let it work

That's it - HireAgent now checks your inbox automatically and handles every application. To see how things are going at any time:

hireagent statushireagent applicants list

To look at one person in detail, or change a decision yourself:

hireagent applicants show 12hireagent applicants override 12 shortlisted
Want to change how often it checks your inbox? Run hireagent settings set POLL_INTERVAL_MINUTES 10 for every 10 minutes. That's it - no restart needed.

Your data stays private

You get your own private, isolated instance. Your candidates' details and CVs are never shared with other customers.

Need a hand?

Stuck on any step? Contact us and we'll help you get set up - or even do it with you on a quick call.

Back to plans