> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jinn.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started with Jinn

> Seven steps from an empty account to decisions from meetings you can search, correct and act on.

> [!NOTE]
>
> Already signed in and inside a workspace? Start here. If not,
> [create your account](https://docs.jinn.so/workspace/sign-in.md) first — it takes a minute, and that page walks you
> through creating your first workspace or joining the one you were invited to.

By the end of this you'll have one real meeting recorded, written up, corrected where the AI
got it wrong, and answering a question you put to it — and you'll know which screen each of
those happens on.

## 1. Check which workspace you're in

Everything in Jinn lives inside a workspace: one workspace is one team, with its own people,
projects and AI account. Which steps below are yours depends on how you got into it:

* **You created it** — it's empty and yours to set up. Carry on to step 2.
* **A colleague invited you** — whoever runs it has probably done steps 2 and 3 already.
  Step 2 isn't yours to change in any case: managing AI keys is limited to workspace owners
  and admins. If the workspace already has a project you can record into, jump to
  [step 4](#4-record-a-meeting).

> [!NOTE]
>
> Inviting colleagues can wait — nothing below needs a second person. See
> [people and access](https://docs.jinn.so/workspace/people-and-access.md) when you're ready.

## 2. Set up your AI

Everything Jinn does with a meeting is AI work — writing out what was said, reading the
transcript into write-ups, indexing both so
[search](https://docs.jinn.so/find/search.md) finds them by meaning. None of it happens
until an AI account is behind it, so this is the step to get right before you record.

Open **Settings** → **AI Providers**. Under **How your AI is powered** you either run on Jinn
credits, which needs nothing from you, or on provider keys you paste in yourself.

Whichever you choose, [How your AI is powered](https://docs.jinn.so/workspace/ai-and-indexing.md) walks through the
modes, which provider does which job, and what to do when a key stops working.

## 3. Create a project

Click **New project**, name it after the work rather than the meeting — *Website redesign*, not
*Monday sync* — and choose who can see it:

* **Private** — only you and the people you invite.
* **Open** — anyone in the workspace can find it and work in it.

You can change the name and description later. See [projects](https://docs.jinn.so/projects/manage-projects.md).

> [!NOTE]
>
> Every new project comes with a built-in [agent](https://docs.jinn.so/agents/add-an-agent.md) called **Default**, so it
> can already read a meeting before you've added anything of your own.

## 4. Record a meeting

Recording happens in the Jinn desktop app, so this is the point to
[download it](https://app.jinn.so/download) if you haven't. It records on macOS and Linux; the
browser can do everything else, but it can't record.

Now start the meeting. The recording bar appears over whatever you're doing: click **Start**,
then click the bar to open it and pick the project under **Select project** if you know it.

Click **Stop & Generate** when the meeting ends. Jinn saves the audio, creates the recording
and opens it. See
[recording a meeting](https://docs.jinn.so/meetings/record-a-meeting.md).

> [!TIP]
>
> Recorded it somewhere else? Drop the audio or video file right to Jinn instead. See [uploading a recording](https://docs.jinn.so/meetings/upload-a-recording.md).

## 5. Give it a project, if you didn't

Recorded without picking a project? That's the ordinary case. The recording is saved and will
be transcribed, but nothing will read it until it belongs somewhere.

Look in your inbox: there's a notification saying the recording needs a project. Choose one
from the notification and the rest starts by itself. See
[what to do about a recording with no project](https://docs.jinn.so/meetings/check-a-recording.md).

## 6. Read what came back

Open the recording. The transcript is written during the meeting, piece by piece, and is final
a few minutes after you stop. The page updates itself, so there's nothing to refresh.

Once the transcript is there, the **Default** agent reads it and writes back a summary, the key
points and the action items it heard. Read it, and fix what's wrong: it's ordinary text, so
rewrite a point, delete one that isn't real, or regenerate the whole thing.

> [!TIP]
>
> Then try a second opinion. If the project has other agents, ask one of them and it reads the
> same transcript through its own lens. If it doesn't yet, add one from a ready-made role —
> that's the next thing worth doing. See [reviewing a meeting](https://docs.jinn.so/meetings/review-a-meeting.md).

## 7. Ask Jinn about it

With the project or the recording open, click **Ask Jinn** in the bar at the bottom of the
screen (or press **⌘J**, **Ctrl+J** off a Mac). A chat opens beside it, already reading what
you had open. Ask in your own words: *do we have any decisions from our last sync?*, *what are
my next steps on this project?* Jinn answers from what it finds: transcripts, your
[docs](https://docs.jinn.so/docs/write-a-doc.md), and the write-ups your agents wrote, and every answer shows what it
read to get there. See
[asking about your work](https://docs.jinn.so/find/ask-a-question.md).

This is the step that pays for the rest. A meeting that can answer a question weeks later is
worth recording; one you have to re-read isn't.

## If something didn't happen

> [accordion] No transcript, and no error
>
> The transcript is final a few minutes after you stop. If it failed, the transcript says
> **Transcription failed**, with the reason and **Try again** — Jinn doesn't fail silently
> here.

> [accordion] Transcript, but no analysis
>
> Almost always the recording has no project. Check your inbox.

> [accordion] Nothing at all, and the AI settings look fine
>
> If the workspace runs on its own keys and a key has stopped working, search can stop taking in new content. See [How your AI is powered](https://docs.jinn.so/workspace/ai-and-indexing.md).

## Where to go next

> [card] [How Jinn works](https://docs.jinn.so/getting-started/how-jinn-works.md)
>
> Every step from pressing record to finding the meeting again months later.

> [card] [Find your way around](https://docs.jinn.so/getting-started/find-your-way-around.md)
>
> What the sidebar opens, what Home shows, and where the trash is.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.