# EmmauOS documentation

> EmmauOS is a spiritual gifts assessment churches put on their website, with a follow-up list for the team who place people on serving teams. These pages explain every feature in plain words. Each has a Markdown version at the same address with .md on the end.

## Getting started

- [Start here](https://emmauos.com/docs/start-here.md): What EmmauOS is, what happens in your first fifteen minutes, and the one moment that shows you what it is for. (for Everyone on the team)
- [Sharing the assessment](https://emmauos.com/docs/your-first-sunday.md): The link, the website embed and the bulletin, and what a member sees from the first tap to their result. (for Admin, Owner)
- [The demo church](https://emmauos.com/docs/demo-church.md): A church of example people you can open any time, read-only, reset every night, with a login that is published on purpose. (for Everyone on the team, Members)
- [The Overview](https://emmauos.com/docs/overview.md): The first screen after sign-in, a Monday picture of discipleship in your church: a short brief, three questions, vital signs, the path, where people want to grow, follow-through, season goals and ministries. (for Everyone on the team)
- [Set up with your AI](https://emmauos.com/docs/set-up-with-your-ai.md): Set up all of EmmauOS by talking to Claude, ChatGPT or another assistant. Copy one prompt, paste it, sign in, and it interviews you area by area, from your welcome line to your pathway, roles, staff and first discipleship pairs. (for Leader, Pastor, Admin, Owner)
- [What's new](https://emmauos.com/docs/whats-new.md): Where EmmauOS announces what changed, how to hear about it in the app, and where the tutorials for new features live. (for Everyone on the team, Members)

## The assessment

- [What people answer](https://emmauos.com/docs/the-assessment.md): The assessment itself: the three lenses it uses, why it asks about what has happened rather than what you are like, and what a member is asked to agree to. (for Everyone on the team, Members)
- [Reading a result](https://emmauos.com/docs/results-and-bands.md): Bands instead of a ranking, the gift at the edge, confirmations from two friends, and what the member gets that you do not. (for Everyone on the team, Members)
- [Questions, wording and the builder](https://emmauos.com/docs/questions-and-trials.md): How the test is doing on your people, trying a new question without it counting, rewording, editing the result page's words, and bringing in questions of your own. (for Admin, Owner)
- [Other assessments people take](https://emmauos.com/docs/other-assessments.md): Let people take APEST, SHAPE or your own test inside EmmauOS, from your church's licensed copy, with its own link, QR code and embed. Scored your way, never ranked. (for Admin, Owner)

## People and follow-up

- [People](https://emmauos.com/docs/people.md): Everyone in one list, filtered by gift, what they took, availability and status, with who follows up, bulk actions and a print view. Each person's results live on their page. (for Everyone on the team)
- [A person's page](https://emmauos.com/docs/a-persons-result.md): Everything about one person on one page (their stage and next step, gifts, serving and connections) and each result's conversation guide, with the three things you can do next. (for Leader, Pastor, Admin, Owner)
- [Follow-up statuses](https://emmauos.com/docs/follow-up-statuses.md): The four statuses a result moves through, what sets each one, and the rule that decides who is waiting for a first look. (for Leader, Pastor, Admin, Owner)
- [Drifting and carrying a lot](https://emmauos.com/docs/drifting-and-carrying-a-lot.md): Two flags for whoever follows up with someone. Drifting means they have gone quiet and nothing holds them. Carrying a lot means they serve in many places or nearly every week. (for Leader, Pastor, Admin, Owner)
- [The weekly digest](https://emmauos.com/docs/weekly-digest.md): One email a week that says who is waiting, which placements need a check-in or have gone quiet, and which signals started rising. Nothing if there is nothing. (for Pastor, Admin, Owner)
- [Introductions](https://emmauos.com/docs/introductions.md): Two people here who would help each other: EmmauOS suggests the introduction, says why in words, and tracks whether it was made. (for Leader, Pastor, Admin, Owner)
- [Walking with someone](https://emmauos.com/docs/walking-with.md): Ask one adult to walk with another for a season. Both are asked by email and nothing starts until both say yes; either can stop at any time. (for Pastor, Admin, Owner)
- [Generations](https://emmauos.com/docs/generations.md): See whether the people your church walks with are now walking with others, as lines of names from one generation to the next. Pastors only, with no score on anyone. (for Pastor, Admin, Owner)
- [Shape walks with your AI](https://emmauos.com/docs/shape-walks-with-your-ai.md): Connect Claude or ChatGPT, hand it your own discipleship materials, and let it draft your walk commitments and weekly questions. Drafts wait on How walks work for you to accept. (for Pastor, Admin, Owner)
- [The Web](https://emmauos.com/docs/the-web.md): Ask "who are you walking with?" once, with a link and a QR code. People who choose to show see who walks with whom in their groups and the whole church, with no counts and no ranking. (for Pastor, Admin, Owner)
- [Share a group's card](https://emmauos.com/docs/share-a-group-card.md): Give a small group or ministry a link, or a box on your website, that shows the group's goal and the steps people chose to share. First names only, and only people who said yes. (for Pastor, Admin, Owner, Members)
- [Tracks](https://emmauos.com/docs/pipelines.md): Belong, Become, Lead and any track you add, each as a short funnel. See where people are on every step, which step a track is stuck at, who has finished one track and not begun the next, and the names behind every number. (for Everyone on the team)
- [Pipeline, track, stage, step and role](https://emmauos.com/docs/pipeline-words.md): Five words that are easy to mix up, side by side. A pipeline is the whole thing; a track is one direction of growth with its own stages; a stage is a column on a track; a step is one thing to do; a role is a place you need people. (for Everyone on the team)
- [Where someone starts](https://emmauos.com/docs/starting-point.md): A short check-in in My Path, plus what EmmauOS already knows, suggests a starting stage on each track someone hasn't started. Staff confirm it with one click. Nothing moves on its own. (for Leader, Pastor, Admin, Owner)

## Ministries and placement

- [Ministries](https://emmauos.com/docs/ministries.md): The ministries of your church, what each one needs, who leads it, and the people EmmauOS thinks could serve there. (for Pastor, Admin, Owner)
- [Where we need people](https://emmauos.com/docs/where-we-need-people.md): How many more people each ministry needs, who at your church could fill each place, and the open spots in your Planning Center plans, with the people free to take them. (for Everyone on the team)
- [Placements](https://emmauos.com/docs/placements.md): Who is serving where, since when, and whether it took. EmmauOS asks a month after every placement and keeps the honest answer. (for Leader, Pastor, Admin, Owner)
- [Serving teams](https://emmauos.com/docs/serving-teams.md): The teams a member can ask to try at the end of their result. Add them by hand, pull them from Planning Center, or let EmmauOS find them on your website. (for Pastor, Admin, Owner)
- [Fitting the pipeline to your church](https://emmauos.com/docs/apply-the-pipeline.md): A pastor's guide to setting up tracks, steps and roles in your own church's words. Map the steps you already have, add the one role you most need, and give it fifteen minutes in a staff meeting each week. (for Pastor, Admin, Owner)
- [Your ministries (for leaders)](https://emmauos.com/docs/your-ministries.md): What a leader sees: the ministries you lead, the people who could serve in them, your introductions and placements, and nothing else. (for Leader)
- [Roles](https://emmauos.com/docs/roles.md): Name the places you need people, such as small group leader, elder or guest host. Say what each one asks, see who holds it from Planning Center, who is ready, and who is growing toward it. (for Leader, Pastor, Admin, Owner)
- [What a role asks](https://emmauos.com/docs/role-requirements.md): Requirements EmmauOS can check, such as a stage, gifts, months serving or a background check, and qualities only people can see, such as character, chemistry and calling, said by someone who knows them. (for Leader, Pastor, Admin, Owner)
- [Apprentices](https://emmauos.com/docs/apprentices.md): Name who is learning each role from the person who holds it, such as a co-leader who will take a group over or start the next one. See which leaders have nobody learning from them, and count the groups and teams that multiplied. (for Leader, Pastor, Admin, Owner)
- [Who knows them](https://emmauos.com/docs/who-knows-them.md): For anyone ready or growing toward a role, see who knows them best, such as their group leader, the person walking with them or their serving team lead, and ask that person what they see, by email or a Planning Center card. (for Leader, Pastor, Admin, Owner)

## Signals and insight

- [Signals](https://emmauos.com/docs/signals.md): Watches you set on what people write and which gifts arrive, so a quiet pattern across twenty results becomes a line on Monday's Overview. (for Pastor, Admin, Owner)
- [Insights](https://emmauos.com/docs/insights-on-overview.md): The charts on the Overview: how your church's gifts are shifting, how Ephesians 4 leanings fall, how teams line up with arrivals, and how you compare with other churches. (for Everyone on the team)
- [Where people want to grow](https://emmauos.com/docs/growth-gaps.md): What people said they would love to grow in, set against the classes, events, groups and resources your church already offers, so you can see where to start something. (for Pastor, Admin, Owner)
- [Group finder](https://emmauos.com/docs/group-finder.md): The open Planning Center groups that fit each person, on their page and their next step, and the groups worth launching where nothing near fits. (for Pastor, Admin, Owner)

## Resources

- [Resources](https://emmauos.com/docs/resources.md): A reading list your pastors curate, tagged by gift and topic, suggested on a person's page and listed on your public directory. Add a shelf of books from one photo. (for Pastor, Admin, Owner)

## Your team

- [Team and roles](https://emmauos.com/docs/team-and-roles.md): Who is on your team, the five roles and exactly what each one can see, inviting people, viewing as them, and what happens when someone leaves. (for Admin, Owner)

## Integrations and agents

- [Planning Center](https://emmauos.com/docs/planning-center.md): Connect once, map your fields, and every result writes its band names to the person's profile, pulls teams, and checks whether placements actually got scheduled. (for Admin, Owner)
- [Planning Center lists and workflows](https://emmauos.com/docs/planning-center-lists-and-workflows.md): On Large, a role can ask for a Planning Center list or workflow, EmmauOS can write who is ready for which role into a EmmauOS Roles tab, and a webhook keeps holders current the same day. (for Admin, Owner)
- [Your website and the embed](https://emmauos.com/docs/your-website-and-embed.md): Give EmmauOS your website once and it learns your colors, logo and ministries. Then put the assessment on your site with one line, or on your own subdomain. (for Admin, Owner)
- [AI briefs](https://emmauos.com/docs/ai-briefs.md): An optional staff-only summary of a person's words before a conversation, written by an AI your church pays for with its own key, from what the person wrote and never from their scores. (for Pastor, Admin, Owner)
- [Follow up through Planning Center](https://emmauos.com/docs/planning-center-follow-up.md): EmmauOS contacts no one. It hands Planning Center what it knows, so a workflow card, a list automation or a Clearstream text does the follow-up you already run there. (for Admin, Owner)
- [AI agents](https://emmauos.com/docs/ai-agents.md): Let Claude or another assistant work your EmmauOS for you: ask who is waiting, log a conversation, set up a new church. Each connection is named, scoped to a role, and expires. (for Admin, Owner)
- [Ask AI](https://emmauos.com/docs/ask-ai.md): A chat at the bottom right of every screen that answers questions about your church from your real list, on your church's own AI key. Pastors, admins and the owner only. It reads, and it can suggest a change that happens only when you press Do it. (for Pastor, Admin, Owner)

## Settings, plan and data

- [Settings](https://emmauos.com/docs/settings.md): Every switch in one place: your address and brand, what members are asked, how long results are kept, embedding, integrations, and the plan. (for Admin, Owner)
- [Plan and billing](https://emmauos.com/docs/plan-and-billing.md): Free for 50 assessments a year, then $40, $60 or $100 a month by church size. The year starts at your first real result, retakes are free, and a lapse does not lock you out. (for Owner)
- [Import and export](https://emmauos.com/docs/import-and-export.md): Bring people and the scores they already have in from a spreadsheet, take everything out as a sealed file, check every import before it happens, and never count an import against your plan. (for Admin, Owner)
- [Share EmmauOS](https://emmauos.com/docs/share-emmauos.md): Tell another church about EmmauOS with your link. When they pay for a plan, your church earns 20% of that first payment, as days on your own plan or as cash. (for Admin, Owner)
- [Languages](https://emmauos.com/docs/languages.md): EmmauOS runs in English and 10 other languages. Each person picks their own, the assessment and its emails follow the taker's language, and your church can translate its own questions. (for Everyone on the team, Members)

## For the people who take it

- [My Path (for members)](https://emmauos.com/docs/my-path.md): Your results, over time, in one private place: sign in with a code sent to your email, see how your gifts have moved, print or download, set a reminder, or erase everything. (for Members)

## Privacy and what EmmauOS never does

- [What EmmauOS never does](https://emmauos.com/docs/privacy-promises.md): The promises made to the people who take the assessment, in one list, with the switch each one is kept by. (for Everyone on the team, Members)

## Also

- [Site overview](https://emmauos.com/llms.txt)
- [Manifest (JSON)](https://emmauos.com/docs/index.json)
- [Start a church](https://emmauos.com/register)