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

# Quickstart

> Set up Felan, connect your team, and start your first AI agent session.

This guide follows the current Felan onboarding and dashboard.

## Prerequisites

* A Felan account
* A team you created or joined
* Access to a GitHub or GitLab account when connecting repositories during onboarding

<Note>
  When you create your first trial team, Felan adds `$5` of non-expiring AI credit for managed-model usage. Each team owner receives this signup grant once; additional teams do not receive another signup grant. Team-provided model credentials remain independent of this balance.
</Note>

<Steps>
  <Step title="Choose where Felan sends updates">
    Onboarding starts with **Where should Felan send updates?** Choose one communication method:

    * **Slack** — connect a workspace, select a channel, and send the welcome message
    * **Microsoft Teams** — connect the Teams workspace and channel
    * **Email** — use your verified login email or verify other recipients

    If the team already has a communication channel, Felan can move directly to the repository connection step.
  </Step>

  <Step title="Connect a repository provider">
    Connect **GitHub** or **GitLab** and authorize Felan for the repositories your team wants it to use. For GitLab, complete project selection after authorization. Felan checks that either supported connection is active before continuing.
  </Step>

  <Step title="Start your first session">
    Choose **Map this codebase**, **Ship a quick win**, or **Fix a bug** as a starting point. Each template is editable, and you can replace it with any non-empty custom prompt. Submitting creates the first session and opens its session page; if creation fails, the prompt remains available to retry.
  </Step>

  <Step title="Review progress and follow up">
    Felan opens the new session and streams its transcript. The session header shows its status, and delegated agents appear with the session activity. When a conversational session is running or completed, use the composer below the transcript to clarify the request or ask for the next step.
  </Step>
</Steps>

## Add context when you need it

The first session can start with only a prompt. Add team-level configuration as your workflows require it:

* [Knowledge](/docs/platform/knowledge) for durable context, reference files, and learned memory
* [Environments](/docs/platform/environments) for variables and credentials used by agent runs
* [Integrations](/docs/integrations/overview) for additional repositories and external systems
* [Automations](/docs/platform/automations) for scheduled or event-driven requests

<Tip>
  Start with a specific outcome, relevant constraints, and the evidence Felan should inspect. Continue in the same session when the next request depends on its existing context.
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="How Felan works" icon="diagram-project" href="/docs/getting-started/how-it-works">
    Learn how Felan uses context, tools, and specialized agents.
  </Card>

  <Card title="Explore the dashboard" icon="table-columns" href="/docs/platform/dashboard">
    See where sessions and team configuration live.
  </Card>
</CardGroup>