The Remote Projects settings page lets you view and manage all your control-plane projects across your organizations.

​
Accessing Remote Projects Settings

To open Remote Projects settings:
  1. Open Settings (click the gear icon or press the settings shortcut)
  2. Select Projects from the sidebar. The page title shown in the content area is Remote Projects.
You must be signed in to access Remote Projects. If you’re not signed in, you’ll see a prompt to sign in first.

​
Understanding the Layout

The Remote Projects page has a two-column layout:
ColumnDescription
OrganizationsLists all organizations you belong to. Personal organizations are marked with a “Personal” badge.
ProjectsShows projects in the selected organization. Click the + button to create a new project.
When you select a project, an edit form appears below where you can modify the project details.

​
Viewing Projects

1

Select an organization

Click on an organization in the left column to view its projects.
2

Browse projects

Projects appear in the right column with their colour indicator. Click any project to select it.

​
Creating a Project

To create a new project in an organization:
1

Select the organization

Click on the organization where you want to create the project.
2

Click the + button

Click the + button in the Projects column header.
3

Enter project details

In the dialog that appears:
  • Project Name - Enter a name for your project
  • Project Colour - Click the colour swatch to choose a colour
4

Create the project

Click Create Project to create the project. It will appear in the projects list.

​
Editing a Project

To edit an existing project:
1

Select the project

Click on the project you want to edit. An edit form appears below the two-column picker.
2

Make changes

Update the project details:
  • Project Name - Change the display name
  • Project Colour - Select a different colour from the palette
3

Save changes

A save bar appears at the bottom when you have unsaved changes. Click Save to apply your changes, or Discard to revert.
Changes sync automatically to all team members in the organization.

​
Configuring Main Chat

Main Chat binds a project to a registered host and a project root folder on that host. To configure Main Chat:
1

Select the project

Open Settings → Projects, select the organization, and choose the project.
2

Open Main Chat settings

In the project edit form, find Main Chat and choose Configure Main Chat.
3

Choose an online host

Select the registered host that owns the project folder. The host must be online to validate the path.
4

Enter the project root

Enter the absolute project root path on that host and save.
If the folder is moved later, Main Chat reports that the host project folder is missing. Reconfigure Main Chat with the new path instead of creating a new workspace.

​
Project Chat

Project Chat does not need Remote Projects configuration. Every project has a control-plane Project Chat for project messages and Telegram voice transcripts. Use Main Chat settings only when you need host-bound Codex execution against a real project root on a registered host.

​
Project Notification Settings

Remote Projects also contains each user’s Telegram notification preferences for the selected project. Project members can select projects from their organizations and manage their own notification preferences alongside the project administration controls. Project read-only users can select projects under Shared with me and edit only their own Telegram notification preferences for that project. They cannot rename the project, change project colour, configure Main Chat, manage readers, or delete the project. Task-only readers are not shown in project-level notification settings because they do not have project-level access. They can still receive personal issue-reader notifications when they are added to or removed from a specific issue. Project notification preferences are filters, not access grants. For example, if a project read-only user enables Task description changed, they still receive that notification only when the underlying issue event creates them as an eligible recipient. Normal issue updates currently target issue assignees and followers who are organization members. See Telegram for the full event matrix, defaults, and quiet-hours behaviour.

​
Deleting a Project

Deleting a project permanently removes all its issues, comments, and data. This cannot be undone.
To delete a project:
1

Find the project

Select the organization and locate the project you want to delete.
2

Open the menu

Hover over the project and click the ⋯ (three dots) menu that appears.
3

Click Delete

Select Delete from the menu.
4

Confirm deletion

Confirm the deletion when prompted. The project and all its data will be permanently removed.

​
Switching Between Organizations

If you belong to multiple organizations, you can quickly switch between them:
  1. Click on a different organization in the left column
  2. The projects list updates to show that organization’s projects
  3. If you have unsaved changes, you’ll be prompted to discard them first

​
Troubleshooting

Make sure you’re signed in. If you just signed up, a personal organization should have been created automatically.If you still don’t see any organizations:
  1. Sign out and sign back in
  2. Check your internet connection
  3. Try refreshing the page
Check the following:
  • You must have an organization selected
  • You need to be signed in
  • Check your internet connection
If you’re trying to create a project in someone else’s organization, you may not have permission.
The save bar appears when you have unsaved changes. Make sure to click Save before:
  • Selecting a different project
  • Selecting a different organization
  • Closing the settings dialog
If save fails, check your internet connection and try again.