# Projects

> Create a project in AI CodeOps: link a Git repository or start from scratch, set the default branch and test command, and see what a project tracks over time.

Source: https://aicodeops.dev/docs/projects

A project is a codebase AI CodeOps works on. Every AI session belongs to a project, and the project collects what happens to that code over time: sessions, changes, deployments, incidents, SBOMs and decision records.

## Create a project

1. Open **Plan → Projects** and choose **New project**.
2. Fill in the form (fields below).
3. Choose **Create project**.

| Field                | What to enter                                                                                                                                                                          |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Identifier**       | Lowercase, no spaces, for example `billing-api`. Used in URLs and reports. It can't change later.                                                                                      |
| **Name**             | A readable name, for example "Billing API".                                                                                                                                            |
| **Type**             | service, library, frontend, infra, data pipeline, model, docs or other.                                                                                                                |
| **Repository URL**   | Optional. The repository's address, for example `https://github.com/acme/billing-api`.                                                                                                 |
| **Default branch**   | Optional. The branch sessions and the terminal work against. Blank means the repository's own default.                                                                                 |
| **Test command**     | Optional. Run after a session writes code, against the proposed change, in an isolated environment. Blank means it is detected (a `package.json` test script, else pytest or go test). |
| **Health check URL** | Optional. A public https endpoint used by monitoring.                                                                                                                                  |
| **Description**      | Optional.                                                                                                                                                                              |

### Checking repository access

After entering a repository URL, choose **Verify access**. AI CodeOps tells you whether the repository is reachable and its default branch. If you have a [connected Git account](https://aicodeops.dev/docs/git/github) for that host, private repositories work: "Will use your GitHub account … private repos accessible." Without one, public repositories still clone, but you can't open pull requests.

With a connected account, the check also says whether that account can **push** to the repository and **open pull requests** in it, and what to change on your Git host when it can't. Nothing is pushed and nothing is created: it only asks the host. It is worth doing before the first session, because a token that can read a repository but not write to it otherwise fails only when the pull request is opened.

### How many projects you can have

Your plan includes a number of projects, counted across all the workspaces of your organization. The Projects page shows the count beside **New project**, for example "2 of 3 used". When none are left, the page says so in place of the form: archive a project to free its place (its history is kept, and it can be restored later), or upgrade the plan.

### Starting from scratch

Leave **Repository URL** empty to start a new codebase. Sessions then generate the source on the platform, and you can browse it under **Develop → Source**. When you want to ship it, choose **Add repo** on the project and enter a repository; later changes can then be opened as pull requests.

### Turning off tests

Tick **Don't run tests for this project** if it has no test suite. Sessions then skip the test step, and the run page shows that the change wasn't verified. This is also how you tell the release gate not to ask for a test result. Without it, a session that changed code and has no test result with counts is denied. See [Quality gates](https://aicodeops.dev/docs/quality-gates).

## The project page

Open a project to see:

- **Deployments**, **Open incidents**, **Vulnerable components (latest SBOM)** and **Recent ADRs** at a glance;
- an **Activity** timeline of sessions, deployments, incidents and decisions;
- **Recent deployments** and **Recent SBOMs**.

From here you can **Run workflow** (describe a task and start a session on this project), **Browse source**, **Edit** the project, or **Archive** it.

Projects that show up in your SBOMs, decision records or incidents but aren't set up yet appear under **Detected projects** on the projects list, ready to add.

## Archive and restore

**Archive** hides a project from the active list. Its history stays, but you can't run sessions against it. Archived projects are listed under **Archived**, with **Restore** to bring one back.

## Next steps

- [Run a session](https://aicodeops.dev/docs/sessions)
- [Connect a Git provider](https://aicodeops.dev/docs/git/github)
- [Security and SBOM](https://aicodeops.dev/docs/security-and-sbom)

## Frequently asked questions

### Can I create a project without a repository?

Yes. Leave the repository URL empty and the session's generated code stays on the platform. Add a repository later to ship it as a pull request.

### Can I delete a project?

You can archive it. An archived project is hidden and can't run sessions, but its history stays and you can restore it.
