Skip to main content

Managing Projects

A project in Obi represents a codebase that your agents can work with. Projects link to a repository through a git integration and store context that agents reference during executions. They are especially useful for automations that involve reading, reviewing, or modifying code.

Creating a Project​

  1. Open Projects from the sidebar.
  2. Click Create Project.
  3. Enter a name for the project.
  4. The project appears in the list. Click on it to configure it.

Configuring a Project​

The project detail page has two main areas.

Project Context​

The left side of the page contains a Markdown editor where you write instructions and context for the project. This information helps agents understand the codebase they are working with. For example, you might describe the project's architecture, coding conventions, or common patterns.

Agents that are assigned to work on this project can reference this context during execution.

Repository Settings​

The right panel lets you connect the project to a code repository.

  1. Click Edit to modify repository settings.
  2. Select a git integration (such as your connected GitHub account).
  3. Choose a repository from the list of available repositories.
  4. Select an image type for the execution environment.
  5. Select an instance type that defines the compute resources (CPU, memory, and disk) used when agents work on this project.
  6. Save your changes.

The repository connection lets agents access and work with the actual code in your repository during executions.

Projects and Triggers​

Projects can be associated with executions through trigger assignation rules. When a trigger fires, project assignation rules determine which project context should be attached to that execution. This ensures that agents have the right codebase context regardless of how the execution was started.

See Setting Up Triggers for information on configuring project assignation rules.

Deleting a Project​

To remove a project:

  1. Select the project from the list.
  2. Use the delete option.
  3. Confirm the deletion.

Deleting a project removes its context and repository connection. Any trigger rules that reference the project will need to be updated.