# Projects

A project is a folder under /workspace holding one or more repository checkouts. It is what the agent works in: you choose it in the Terminal's Project directory. Settings → Projects has three parts: Projects, Repositories and Jobs.

# How projects and repositories fit together

Repositories is the list of repositories your workspace knows. Adding one only registers it; nothing is cloned yet.
A project is a folder, /workspace/<project>, that checks out one or more repositories from that list, each optionally on a branch of its own.

The same repository can be used in several projects, each with its own independent checkout. Every checkout is a Git repository in its own right, so the agent can work in it directly.

# Repositories

Click Add repository and enter:

Field	What it is
Repository URL	The full URL, or for Git the short host and path form
Type	Git, or SVN (preview). The type cannot be changed later; remove and add the repository again instead.
Default branch	Optional. The branch projects check out unless they choose another. Empty means the repository's own default branch.
Read-only reference	Tells the agent not to change this repository. Use it for code the agent should read but never modify.
Test the connection first	Checks the repository can be reached with your current credentials before adding it.

The list shows which credential each repository is cloned with: your credential, the deployment credential, or no credential for this host. In the last case, private repositories fail to clone until you add a credential under Credentials.

Select repositories to Test or Delete several at once, or use Remove unused to clear the ones no project uses. A repository still used by a project cannot be removed.

# SVN repositories

Enter the full URL including the path, such as https://svn.example.com/project/trunk. svn://, svn+ssh://, https:// and file:// work; the short host and path form is Git-only.
The branch setting is ignored for SVN.
Sign in with an SVN credential for the host under Credentials, or with SVN_USERNAME and SVN_PASSWORD under Personal environment.
SVN checkouts are not indexed by CodeGraph.

# Projects

Click New project and enter:

Name: lowercase letters, digits, dots and dashes. The project becomes /workspace/<name>.
Repositories: at least one from your list. Each is checked out on its default branch. If one is missing, add it under Repositories first.
Build a CodeGraph index for this project, to give the agent code intelligence for it.

The clones run in the background as jobs. Each project then shows its checkouts, with their branch and state (Cloned, Not cloned, or uncommitted changes), and its CodeGraph state.

Action	What it does
Assign repository	Adds another checkout, from your list or as a new repository. For the optional branch: if it exists remotely it is checked out; otherwise the default branch is cloned and the branch is created locally.
Sync	Clones any checkout that is missing and pulls the others. Pulls only fast-forward, so local work is never overwritten; if a pull cannot fast-forward, the job reports it and your work is kept.
Build CodeGraph / Rebuild CodeGraph	Builds or rebuilds the project's CodeGraph index.
Remove a checkout	Removes one checkout from the project. It refuses when the checkout has uncommitted changes, no upstream or unpushed commits, unless you tick Force.
Remove the project	Removes the project and its checkouts. Optionally, also removes its repositories from your list, keeping any another project still uses.

Checkouts are never pulled or reset for you, so work in progress is safe. Use Sync, or git pull in a terminal, when you want upstream changes. To change a checkout's branch, remove it and assign it again with the new branch.

Projects from your company's catalog are loaded on the Company sub-tab and then appear here.

# Jobs

Clones, removals, syncs and CodeGraph builds run in the background as jobs. The Jobs list shows each one as Queued, Running, Done or Failed, with its Log. A failed clone usually means a missing or wrong credential for the repository's host.

# CodeGraph code intelligence

CodeGraph builds a map of a project's code (its symbols, references and calls) so the agent can answer structural questions without reading every file. The agent uses it through its codegraph tool.

Per project. Tick it when you create the project, or use Build CodeGraph later. The first index builds in the background and does not slow down your workspace.
Kept up to date. An indexed project is refreshed after every git pull or checkout in it, and every 30 minutes as a safety net. For an immediate refresh, use Rebuild CodeGraph or run codegraph sync /workspace/<project> in a terminal.
Stored with the project, in /workspace/<project>/.codegraph/.

Credentials

../credentials/

Company

../company/

Terminal

../../terminal/

ai coding phoeniqs ai build settings projects repositories git svn codegraph