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

# Projects

> List, switch, and inspect your Inference.net projects.

Projects organize your training runs, evaluations, datasets, and inferences. Most CLI commands operate on the active project, which is stored in `~/.inf/config.json` and settable per-invocation with the global `--project <id>` flag.

## `inf project list`

Display every project you have access to in the active team. The active project is flagged with a green dot (`●`).

<Metadata text="cli/project/list" />

```bash theme={"system"}
inf project list
```

**Alias:** `inf project ls`

### Example

<Metadata text="cli/project/list-examples" />

```bash theme={"system"}
inf project list
```

## `inf project switch`

Set a different project as the active project. The CLI validates that the project exists and that you have access before saving.

<Metadata text="cli/project/switch" />

```bash theme={"system"}
inf project switch <project-id>
```

**Alias:** `inf project use`

### Arguments

| Argument     | Required | Description                       |
| ------------ | -------- | --------------------------------- |
| `project-id` | Yes      | The ID of the project to activate |

### Examples

<Metadata text="cli/project/switch-examples" />

```bash theme={"system"}
# Switch to the staging project
inf project switch proj_789ghi012jkl

# Same, using the `use` alias
inf project use proj_789ghi012jkl
```

<Tip>
  Temporarily override the active project for a single command without changing your stored config using the global `--project` flag:

  ```bash theme={"system"}
  inf training list --project proj_789ghi012jkl
  ```
</Tip>

## `inf project current`

Show details about the currently active project — project ID, name, team ID, and creation date. If no project is active, the command errors and points you at `inf project switch <id>`.

<Metadata text="cli/project/current" />

```bash theme={"system"}
inf project current
```