Documentation

🚀Getting started

1. Go to kudibot.com and choose "Create your organization". You sign in with your email: we send you a one-time link, no password.
2. Name your organization, pick the language and time zone, and open Settings → Modules to turn on what you need (Recognition, Standups, Work, HR).
3. Invite people from Settings → Members & access, or from People → Add person (with a work email and "Invite").
4. Optional: link a Discord server from Settings → Discord server to use the commands and notifications there. KudiBot works without it.

🏢Organization, roles and permissions

Every company is an organization at kudibot.com/app/your-name. The owner can rename its address; old links keep working.

Roles decide what each person sees: owner, admin, HR admin, coordinator and member, plus custom roles you create in Settings → Roles & permissions. Each permission has a scope: own data, own team or everyone. Nobody can grant more than they hold.

Settings → Audit log records sensitive reads and changes. Settings → Data & privacy sets how long reports, tasks and logs are kept.

👥People

People holds profiles, teams, locations, job titles and the org chart. Add custom fields in Settings → HR structure and import people from a CSV.

Personal and sensitive fields (address, ID numbers, bank) are encrypted and visible only to the person and to roles with permission. A person can request a change to their own data; HR approves it in Approvals.

🗓️Time off and attendance

Time off: create leave types, accrual policies and holidays per country in Settings → Time off. People request days on the web (Time off); approvers decide in Approvals or from the buttons in their Discord DMs.

Attendance: in Settings → Attendance choose task hours, clock in and out, or both, and whether weeks need approval. People clock in on the web, or by greeting ("hola", "good morning") and saying goodbye to /kudibot in Discord. Weekly timesheets can be exported to CSV for payroll.

🧭Onboarding and offboarding

Create checklist templates in Settings → Onboarding, by job title, department or for everyone, with tasks for HR, IT, the manager, a buddy or the person, and dates relative to the start or last day.

Start onboarding from Onboarding: a new person gets their record and an email invitation. Offboarding ends their access after the last day once every task is done.

📄Documents

Upload company policies and personal documents in Documents. Files go to your own Cloudflare R2, Backblaze B2 or Amazon S3 (Settings → File storage), or to a 100 MB fallback.

Ask people to confirm they read a document, set expiry dates for reminders, and create PDFs from templates with fields such as the person's name. Documents of people who left can be deleted after the period you choose.

🎯Performance

Goals with check-ins, 1:1 notes with action items, review cycles (self and manager) and feedback. There are no automatic scores.

Each person decides in Performance → AI evidence whether AI drafts of their review may use their kudos and task summaries (off by default).

📈Reports

Reports shows headcount, hires and exits, turnover, tenure, time off, hours, onboarding and expiring documents, computed by the platform, with a people CSV. Team leads see their teams.

✨The assistant

The assistant is the chat button in the web app, and /kudibot in Discord. It answers from your organization's data, only what you are allowed to see: who is out, your time off balance, what waits for your approval, your hours, kudos and tasks.

It can also propose actions (clock in or out, request time off). It asks you to confirm each time, or you can choose "Always allow" and change it later in Settings → Notifications. Managers can ask for an analysis; it is written from facts with names replaced by aliases.

Answers can include lists, tables and bold text. An admin turns the assistant on in Settings → AI.

🔌API and webhooks

In Settings → Integrations create API keys with the scopes you choose (people, structure, time off, attendance) and call /api/public/v1 with "Authorization: Bearer <key>". Keys are shown once and can be revoked.

Webhooks send signed events (a person created, time off approved, onboarding started or completed). Only public HTTPS URLs are accepted.

👏Giving kudos

On the web: Recognition → Give kudos. In Discord: run /kudos, pick a teammate and optionally write a reason.

You can also right click a message or a user and choose Apps → Give kudos, or react with an allowed emoji. Giving kudos to yourself or to bots is not possible.

/kudos user:@alice reason:Thanks for the help!
Right click a message or a user → Apps → Give kudos
React to a message with ⭐

⌨️Commands

/kudos gives kudos. /kudistats shows the leaderboard. /kudireport opens the standup form. /kuditask registers a task (link, summary, time).

/kudime gives you a summary, your settings and a one-time link to the web app.

/kudibot is the assistant: ask a question, or greet and say goodbye to clock in and out. Without text it replies with a motivational phrase.

🔒Privacy

Discord is optional. When linked, KudiBot only uses Discord's Guilds and Guild Message Reactions intents and cannot read your messages.

Data is stored in the Americas. Personal data, storage credentials and secrets are encrypted, and access follows roles. See the Security page for details.

📢Allowed channels and limits

Kudos work in every channel by default. To limit them, choose "Only selected channels" in Settings → Kudos and enable the channels you want.

The daily kudos limit and the emojis used for reaction kudos are also configured in Settings → Kudos.

📝Standups and weekly recap

Members run /kudireport to open a short standup form: feeling, plans and blockers. Finished work is registered with /kuditask, and the report shows a summary of the last workday from those tasks. KudiBot posts the answers to the report channel chosen in Settings → Reports & Tasks. Report text is stored only when the server turns on "Store reports and tasks".

The weekly recap posts a summary of the week's kudos in the channel you choose (Settings → Weekly recap). Scheduled messages are only sent between 07:00 and 21:00 in the server timezone.

/kudireport

📊Analytics

Overview shows total kudos, active givers and receivers, a kudos-per-day chart and the top receivers and givers.

Custom report filters kudos by dates, giver and receiver, exports to CSV and, when rewards are on, shows an Earned column. The Rewards view shows earnings per cycle or custom dates, also as CSV.

The People tab shows AI member profiles when that feature is on. Members can also see the leaderboard in Discord with /kudistats.

💰Rewards

Rewards are optional and off by default. In Settings → Rewards set a money value per kudos with a reason and another without a reason. Each value can apply to the giver, the receiver or both; if the with-reason value doesn't apply to someone, they get the without-reason value.

Kudos given automatically by the bot pay only the receiver. You can set an optional cap per person. A monthly summary is posted on the payout day, and amounts appear in Discord only if you enable it.

🤖AI

AI is optional and uses your organization's own key (DeepSeek, Google Gemini, Anthropic or OpenAI), set in Settings → AI. Each feature has its own switch and there is a monthly token budget.

Names and ids are anonymized before anything reaches the AI, and outputs are checked. The AI never scores, ranks or compares people.

Linked Discord servers use the organization's AI settings.

🌐Language

The website and dashboard are available in English and Spanish; use the language selector in the navigation bar.

The bot language for each server is set in Settings → General.