00 / Customer Success
Joy is customer success. In a small business the sale gets all the attention and the week after the sale gets none: the client signs, pays, and then waits to hear what happens next. Joy owns that week and every week after. Each new client gets a folder, an onboarding plan and a welcome kit. She walks them through go live one step at a time, checks that what the welcome kit promises matches what the agreement says, and tells you each morning what changed. This guide sets her up on Hermes Agent, a free and open source agent from Nous Research that runs on your own machine.
The software is free. The model behind it is not always free, and the real work is writing down what a good first month looks like once, in one place.
Checked on 2026-11-21. Commands and limits change. Sources are at the bottom.
every command below was copied from the Hermes Agent documentation on that date. We have not test-run them on a fresh machine. If a step does not behave the way it says, see "If a step breaks" near the end: your AI can patch it for you in a minute.
In this guide she never emails, texts or calls a client. Every message she writes waits for you to read it and send it yourself.
01 / Before you start
| You need | Why | Cost | Checked |
|---|---|---|---|
| A computer that stays on: macOS, Linux, Windows or WSL2 | The morning note only runs while Hermes' gateway is running | Yours already | 2026-11-21 |
| Git and curl | The installer uses them | Free | 2026-11-21 |
| Hermes Agent | Runs Joy | Free, MIT licence | 2026-11-21 |
| A model with at least 64,000 tokens of context | Hermes rejects smaller models at startup | Depends on the provider you pick. Not measured here | 2026-11-21 |
| One signed agreement to start with | Everything she writes is checked against it | Yours already | 2026-11-21 |
| The steps it takes to get a client live | She cannot walk a checklist that is not written | Yours already | 2026-11-21 |
| Telegram (optional) | To get the morning note on your phone | Free | 2026-11-21 |
On a brand new install the setup wizard may offer a "Free, start now" choice that needs no account. The Hermes docs say it is shown only when it is available, so do not plan around it.
One thing to decide first: whatever model you choose will read the agreements you paste in. Remove anything you would not want leaving your machine, such as bank details or a client's personal information, before you save an agreement in her folder.
| When | What | Your time |
|---|---|---|
| Day 1 | Install Hermes and get one normal chat working | The Hermes docs say under 5 minutes. Allow 30 |
| Day 1 | Create Joy and give her a desk folder | 20 minutes |
| Day 1 | Write your onboarding plan and welcome kit templates | 1 hour. This is the part that decides everything |
| Day 2 | Turn on the morning note | 20 minutes |
| Week 1 | Onboard one real client with her, start to finish | 15 minutes a day, most of it reading her drafts |
The slow part is not the install. It is deciding what your first month with a client is supposed to look like. Most businesses have never written it down, which is why it goes differently every time. Once it is a template, she can run it the same way for every client.
She only knows a client exists if you open their folder and paste in the agreement.
She does not read your inbox or your CRM in this guide. She works from what you put in the folder and tells you what to send.
She can tell you the welcome kit and the agreement disagree. She cannot tell you which one is right. That is yours to answer.
02 / The build
Do not add anything else until a plain conversation works. The Hermes quickstart is blunt about this, and it is right.
On macOS and Windows the Hermes docs recommend the Hermes Desktop installer from https:/
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Reload your shell, pick a model, and start a chat:
source ~/.zshrc hermes setup hermes
a welcome banner naming your model, and a reply to a simple question. If replies are empty or broken, run hermes model again and confirm the provider, the model and the login. If anything else looks off, run hermes doctor.
Every agent in Hermes gets its own profile: its own settings, memory and identity. Never point two agents at the same profile.
hermes profile create joy --description "Customer success. Opens a folder for every new client, writes the onboarding plan and welcome kit from templates, walks the go live checklist step by step, checks every promise against the signed agreement, and reports only what changed. Never contacts a client or changes an agreement. The owner does."
Creating the profile also creates a joy command. Check it:
joy chat
the same kind of chat as step 1, now running as the joy profile.
In Hermes, who an agent is lives in a file called SOUL.md inside that agent's home. For a profile named joy that is:
~/.hermes/profiles/joy/SOUL.md
Hermes creates a starter file there. Replace its contents with the text in "Joy's instructions" below. Keep it about who she is and how she talks. Your templates and your clients go in different files, in the next step.
after starting a new joy chat, she introduces herself as your customer success when asked who she is.
This is the step everybody rushes, and it is the one that makes Joy useful.
Make a folder for her to work from:
mkdir -p ~/joy-desk/templates ~/joy-desk/clients
Put three files in it. Hermes loads AGENTS.md from the folder you start a chat in, and Joy reads the others as she works.
~/joy-desk/AGENTS.md, the rules:
# How Joy works this desk - Every client gets one folder in clients/, named for the client. It holds agreement.md (pasted in by me), onboarding_plan.md, welcome_kit.md, go_live.md and log.md. - The signed agreement is the source of truth. Every price, date, deliverable and promise in the plan and the kit comes from agreement.md. Never from memory, from another client, or from a guess. - Write the onboarding plan from templates/onboarding_plan.md and the welcome kit from templates/welcome_kit.md. Fill a gap with the word UNKNOWN and ask me once. Never invent a detail. - Before I see a plan or a kit, compare it with agreement.md line by line. List every place they disagree, with both versions side by side, and who should settle it. A kit with an open mismatch is not ready. - go_live.md is the checklist for that client. Walk it one step at a time. For each step draft the short note to the client: what just happened, what happens next, and what you need from them. - Keep log.md current: the date, what was done, what is waiting, and on whom. - You draft. You never email, text or call a client, never change an agreement, and never promise anything that is not in agreement.md. Show the draft to me. - When I ask what changed, tell me only what is different since the last time I asked. If nothing changed, say so in one line.
~/joy-desk/templates/onboarding_plan.md, the plan template:
# Onboarding plan: {client}
Signed: {date from the agreement}
What they bought: {from the agreement, in their words where possible}
Go live target: {date from the agreement, or UNKNOWN}
| Step | What happens | Who does it | Needs from the client | By when |
|---|---|---|---|---|
| Kickoff | {the first call or message} | {you or the client} | {what} | {date} |
| Setup | {access, accounts, information} | {who} | {what} | {date} |
| Build | {the work} | {who} | {what} | {date} |
| Test | {how it gets checked} | {who} | {what} | {date} |
| Go live | {the switch} | {who} | {what} | {date} |
| First check in | {when you look at how it is going} | {who} | {what} | {date} |
~/joy-desk/templates/welcome_kit.md, the welcome kit template:
# Welcome, {client}
## What you bought
{deliverables, exactly as the agreement lists them}
## What it costs and when
{every price and payment date, exactly as the agreement states them}
## What happens next
{the next three steps from the onboarding plan, with dates}
## What we need from you
{access, information, decisions, each with a date}
## How to reach us
{the one channel you want them to use, and how fast you answer}
## What is not included
{anything the agreement excludes, in plain words}
when you run joy chat from inside ~/joy-desk and ask what goes in a welcome kit, she answers from your template.
Make a folder for one real client and paste their signed agreement into agreement.md there. From inside ~/joy-desk run joy chat and send her this:
New client: {client name}. Their signed agreement is in clients/{client name}/agreement.md. Write their onboarding_plan.md and welcome_kit.md from the two templates, using only what the agreement says. Write UNKNOWN wherever the agreement does not answer the template. Then write go_live.md as a numbered checklist for this client, and start log.md with today's date. Do not draft anything to the client yet.
four new files in the client's folder, every price and date traceable to the agreement, and UNKNOWN wherever the agreement is silent.
Hermes has a built-in scheduler. Give the job Joy's folder so she reads your clients when she runs. The folder must be written as a full path.
hermes -p joy cron create "weekdays at 8am" \ "Morning note. Read every client folder in clients/. Report only what changed since yesterday or needs me today: a go live step that is due or overdue, something we are waiting on from a client for more than three days, an open mismatch between a welcome kit and its agreement, or a draft waiting for me to send. One line each, with the client's name. If nothing changed, reply with the single line: Nothing changed. Contact no one and change no file. Keep it under 120 words." \ --workdir /Users/you/joy-desk \ --name "Client success note"
Schedules run from a gateway, and each profile has its own. Start Joy's, and check that her scheduler is alive:
joy gateway start hermes -p joy cron status
joy gateway install keeps it running after a restart.
By default the note is saved on your machine. To get it on your phone, connect Telegram first with hermes gateway setup, then create the job with --deliver telegram added.
One thing to check on your machine: whether your times come out in your own timezone. Hermes reads the schedule in the profile's timezone: setting. Add --timezone America/Los_Angeles (or your zone) to pin it.
a short client note waiting for you the next weekday morning, or the one line saying nothing changed.
Before the first welcome kit goes anywhere, from inside ~/joy-desk run joy chat and send her this:
Compare clients/{client name}/welcome_kit.md and onboarding_plan.md with agreement.md. Go line by line. List every price, date, deliverable and promise in the kit and the plan. For each one say whether it matches the agreement, and if it does not, show what the kit or plan says next to what the agreement says. Flag anything promised that is not in the agreement at all. Tell me who should settle each mismatch. Change nothing.
a short list where every number the client is about to see is either matched to the agreement or flagged, and both files untouched.
Paste this into ~/.hermes/profiles/joy/SOUL.md. Change the parts in braces.
# Who you are
You are Joy. You are customer success for {your business}.
Your job starts when a client signs. You make sure they know what happens next, that it happens in order, and that everything they are told matches what they signed.
# How you work
- Every client gets a folder, an onboarding plan and a welcome kit, the day they sign.
- The signed agreement is the source of truth. A price, a date or a promise that is not in it does not go in front of a client.
- You check the paperwork against the agreement before the client sees it, and you show both versions when they disagree.
- You walk go live one step at a time. One clear note per step: what happened, what is next, what you need.
- You draft and your owner sends. You never contact a client yourself.
- You report what changed, and only what changed.
- When you do not know, you write UNKNOWN and ask once. You never guess.
# How you talk
- Warm, caring and cheerful. Reassuring without being vague.
- Plain words. Short sentences. No jargon the client did not use first.
- Lead with what the client needs to know or do.
- When nothing changed, you say so in one line and stop.
- When you ask a question, ask exactly one.
This persona was written from Joy's job description for this guide. It is not a copy of the instructions she runs on in our own team.
Run joy chat from inside ~/joy-desk and send her this:
List every client folder in clients/. For each one tell me: which of agreement.md, onboarding_plan.md, welcome_kit.md, go_live.md and log.md are present, which go live step is next, and every place the word UNKNOWN still appears. Use only what is in the folders. Change nothing.
A good answer names the missing files instead of pretending they exist, gives the next step exactly as the checklist has it, and lists the unknowns instead of filling them.
If she states a price or a date that is not in a client's agreement, tighten the "source of truth" rule in AGENTS.md and ask her where it came from.
03 / When it goes wrong
| What you see | Why | Fix |
|---|---|---|
| Empty or broken replies | Model or login is wrong | hermes model, then a plain chat before anything else |
| She does not know your templates | The chat was not started in ~/joy-desk |
Start joy chat from that folder |
| A welcome kit has a price that is not in the agreement | She guessed, or the agreement was not in the folder | Put the agreement in the client's folder, then tighten the "source of truth" rule in AGENTS.md and SOUL.md |
| She missed a mismatch | The agreement was pasted in part, or the item is worded differently in the two files | Paste the whole agreement, and name the item the same way in both places |
| Her notes to clients sound stiff | The persona is thin for your business | Add two real notes you have sent to SOUL.md as examples of your voice |
| No morning note | Joy's gateway is not running, or the job is missing its folder | hermes -p joy cron status, joy gateway start, and recreate the job with --workdir |
| The note arrives at the wrong hour | The schedule is running in another timezone | Recreate the job with --timezone set to your zone |
| Anything else | hermes doctor |
Hermes changes fast, so a command here can drift from what your version expects. You do not need us to fix it. Paste this into Hermes itself, or into Claude or ChatGPT, with the error underneath:
I am following a setup guide for a customer success agent on Hermes Agent. This step failed. Here is the step, the exact command I ran, and the full error. Check the current Hermes Agent docs at https://hermes-agent.nousresearch.com/docs, tell me what changed, and give me the corrected command.
hermes doctor is worth running first. It catches most setup problems on its own.
hermes model. Every morning note and every draft is model usage. Not measured here, so no number is given.04 / If you would rather not
Nobody stalls on the install. They stall on writing down what a good first month looks like.
CAMBY Ai sets Joy up and runs her for you: https:/