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

# Repositories Overview

> Add and manage repositories in Zenflow to organize your AI-driven development work.

## What is a Repository?

A repository in Zenflow is the codebase your AI agents work in. Each repository contains tasks, workflows, and automation settings that define how agents interact with your code.

<Card title="Repository hierarchy" icon="sitemap" horizontal>
  **Organization → Repositories → Tasks → Subtasks/Chats**

  Each level inherits settings from above while allowing overrides for specific needs.
</Card>

## Adding a Repository

<Steps>
  <Step title="Open Zenflow">
    Launch the Zenflow desktop app and sign in with your Zencoder account.
  </Step>

  <Step title="Click Add repository">
    From the sidebar, click the **+** icon and select **Add repository**.
  </Step>

  <Step title="Choose how to add your repository">
    You have three options:

    * **Create blank repository** — creates a new empty repository in your local ZenflowProjects folder
    * **Clone from GitHub** — clone a repository directly from your GitHub account
    * **Select from computer** — browse your local machine for an existing repository

    Zenflow also shows **Suggested** repositories based on recently used local folders.

    <div className="flex flex-wrap gap-3 mt-3 items-start">
      <img src="https://mintcdn.com/forgoodaiinc/m_fgPU6jte68-pXN/images/zenflow/zenflow-add-repository-button.png?fit=max&auto=format&n=m_fgPU6jte68-pXN&q=85&s=0497990453d62207a201d4c4dbc619c7" alt="Add repository button in the Zenflow sidebar" style={{ height:"180px", width:"auto", borderRadius:"8px" }} width="674" height="366" data-path="images/zenflow/zenflow-add-repository-button.png" />

      <img src="https://mintcdn.com/forgoodaiinc/m_fgPU6jte68-pXN/images/zenflow/add-repository.png?fit=max&auto=format&n=m_fgPU6jte68-pXN&q=85&s=830e7e13dffbe756f115162088a08f24" alt="Add repository dialog showing Create blank repository, Clone from GitHub, and Suggested repositories" style={{ height:"180px", width:"auto", borderRadius:"8px" }} width="1260" height="1238" data-path="images/zenflow/add-repository.png" />
    </div>
  </Step>

  <Step title="Configure automation">
    Set up your default agent, verification scripts, and workflow preferences. You can always adjust these later.
  </Step>

  <Step title="Start working">
    Your repository is ready! Create your first task to begin.
  </Step>
</Steps>

## Repository Settings

Access repository settings by selecting your repository in Zenflow. Settings are organized into sections:

### General

| Setting                 | Description                                    |
| ----------------------- | ---------------------------------------------- |
| **Repository Name**     | The display name for this repository           |
| **Git Repository Path** | The absolute path to your local git repository |

### Scripts & Automation

Scripts run automatically during task execution to set up dependencies, start dev servers, and verify changes. Configuration is stored in `.zenflow/settings.json`.

Use **Set up with Agent** to have an AI agent analyze your repository and generate a suggested configuration automatically.

| Setting                 | Description                                                                           |
| ----------------------- | ------------------------------------------------------------------------------------- |
| **Setup Script**        | Runs when a new task worktree is created (install dependencies, run migrations, etc.) |
| **Verification Script** | Runs after each agent turn to validate changes (linting, type checks, tests)          |
| **Dev Server Script**   | Command to start your development server                                              |
| **Copy Files**          | Local files (e.g. `.env`) to copy into each task worktree                             |

### AI Rules

| Setting                   | Description                                                                                                        |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Always Included Rules** | Rule files (one per line) always added to the agent's context, e.g. `CLAUDE.md`, `.github/copilot-instructions.md` |

## Next Steps

<CardGroup cols={2}>
  <Card title="Repository Configuration" icon="gear" href="./project-configuration">
    Deep dive into .zenflow/settings.json
  </Card>

  <Card title="Tasks Overview" icon="check-square" href="./tasks-overview">
    Learn how to create and manage tasks
  </Card>
</CardGroup>