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

# Projects

> Organize your codebases and track verification health at a glance.

A **project** in IronBee maps to a codebase. When you run `ironbee install` in a directory, that directory is associated with a project and all session data flows there automatically.

<img src="https://mintcdn.com/ironbee/kHX-DEGTUXrD4U7O/images/console/main-dark.png?fit=max&auto=format&n=kHX-DEGTUXrD4U7O&q=85&s=f38d664212c600f1b9dd2e8eef7f9bd3" alt="IronBee Console — Projects page" style={{borderRadius:'8px',width:'100%'}} width="1728" height="937" data-path="images/console/main-dark.png" />

## The projects page

The projects page is the home screen of the IronBee Console. It shows every project your account has access to. Use the **date filter** in the page header to scope all metrics to a specific time range.

## Quick Search

<img src="https://mintcdn.com/ironbee/kHX-DEGTUXrD4U7O/images/console/project/search-dark.png?fit=max&auto=format&n=kHX-DEGTUXrD4U7O&q=85&s=9faacbd61741edd244319c6e8d295dca" alt="IronBee Console — Search" style={{borderRadius:'8px',width:'100%'}} width="1723" height="963" data-path="images/console/project/search-dark.png" />

Use the search bar at the top of the console to jump directly to any project, session, or finding by ID or keyword. Quick Search returns results across all projects your account has access to.

## View modes

Toggle between **Card view** and **List view** using the toolbar controls. Your preference is saved automatically.

### Card view

<CardGroup cols={2}>
  <Card title="Each project card shows:">
    * **Project name**
    * **Last active date**
    * **Pass rate donut chart**, center label shows the percentage of verifications that passed; hover for a passed/failed count breakdown
    * **KPI stack**, Sessions, Verifications, Fixes counts
    * **Time breakdown**: Total activity time split into Coding, Verification, and Fix phases with percentages
    * **Findings tiles**, Critical, Concern, and Notice finding counts (click to go directly to the filtered Findings page)
    * **Recommendations button**, shows count of active recommendations (click to open the Recommendations page)
  </Card>

  <Card title="Card View">
    <img src="https://mintcdn.com/ironbee/kHX-DEGTUXrD4U7O/images/console/project/project-card-dark.png?fit=max&auto=format&n=kHX-DEGTUXrD4U7O&q=85&s=f7be55ab213b4aa49374076252da2741" alt="Card View" style={{borderRadius:'8px',width:'100%'}} width="380" height="633" data-path="images/console/project/project-card-dark.png" />
  </Card>
</CardGroup>

### List view

The table has the following columns (all sortable by clicking the header):

<img src="https://mintcdn.com/ironbee/kHX-DEGTUXrD4U7O/images/console/project/project-list-dark.png?fit=max&auto=format&n=kHX-DEGTUXrD4U7O&q=85&s=2bc144cf99267710a3ef267307372b56" alt="IronBee Projects — List View" style={{borderRadius:'8px',width:'100%'}} width="2992" height="1264" data-path="images/console/project/project-list-dark.png" />

| Column        | Description                                                     |
| ------------- | --------------------------------------------------------------- |
| Project       | Project name                                                    |
| Sessions      | Total session count                                             |
| Verifications | Total verification cycle count                                  |
| Success Rate  | Percentage of verifications that passed, with a bar chart       |
| Fixes         | Total fix attempts                                              |
| Total Time    | Combined coding + verification + fix time (hover for breakdown) |
| Verif. Time   | Time spent in verification cycles                               |
| Fix Time      | Time spent on fixes                                             |
| Analyze       | Critical / Concern / Notice finding counts (clickable)          |
| Recs          | Active recommendations count (clickable)                        |
| Activity      | Last and first activity dates                                   |

## Sorting

In card view, use the **Sort dropdown** in the toolbar to sort by: Project Name, Sessions, Verifications, Success Rate, Fixes, Total Time, Verif. Time, Fix Time, or Last Activity. In list view, click any column header to sort.

## Creating a project

Projects are created automatically the first time a session is started in a directory that has IronBee installed. No manual setup is required in the console.

## Next steps

<CardGroup cols={2}>
  <Card title="Sessions" icon="clock" href="/console/sessions">
    Browse and filter all sessions for a project.
  </Card>

  <Card title="Analysis" icon="sparkles" href="/console/analysis">
    View AI-powered insights across your project.
  </Card>
</CardGroup>