Main Chat is a project-level Codex conversation bound to a specific registered host and a host-side project root folder. Use it when you want to inspect or change an existing project without creating a new branch workspace first. Main Chat is different from Project Chat and issue workspaces:
AreaProject ChatMain ChatWorkspace
PurposeProject messages and notesProject-level Codex contextIssue or task execution context
Host requiredNoYesYes
FolderNoneExisting host project rootHost-side workspace folder/worktree
Codex executionNoYesYes
BranchingNoDoes not create a new branch by itselfCreates or attaches a branch/worktree
Git mutation flowsNoWorkspace-only branch actions are blockedBranch/fork, PR, push, merge, and rebase flows are available

​
Configure Main Chat

1

Register and select a host

Confirm the host is online in Settings → Remote Access or from the host picker in the app shell.
2

Open Remote Projects settings

Go to Settings → Remote Projects, select the organisation and project, then open the Main Chat configuration.
3

Choose the host project root

Select the registered host and enter the absolute project root path on that host. The host validates that the path exists and is a directory.
4

Open Main Chat

Use Open Main Chat from the project board or the project sidebar. Jaidu opens the host-side main workspace and starts or resumes a Codex thread.

​
What Main Chat Can Do

From Main Chat you can:
  • send prompts to Codex through the selected host;
  • inspect and edit files under the bound project root;
  • run terminal commands on the host;
  • inspect Git branch and diff state;
  • run Codex /plan;
  • view project-level GitHub or pull request changes exposed by the host.
Main Chat does not create a temporary workspace folder just because you open or continue the conversation.
Use Project Chat instead when you only need project messages, notes, or Telegram text and recording imports without Codex execution.

​
Main Chat Threads

Main Chat can have multiple threads. Starting another thread keeps the same host project root and filesystem state, but creates a fresh Codex conversation thread. Use a new Main Chat thread when:
  • the previous conversation is too long;
  • you want a separate investigation thread;
  • you want another Codex configuration for the same project root.
Use an issue workspace instead when you need a branch/fork, isolated worktree, or PR workflow.

​
Rollback History In Imported Threads

Imported Codex CLI threads can include rollback events, such as when you press Esc in Codex CLI and continue from an earlier point. Main Chat treats that as history branching inside the same thread:
  • the active thread shows the continuation after the rollback;
  • the turns that were rolled back from remain available as rollback history;
  • rollback history opens as a chat-like read-only view;
  • you cannot send, retry, reset, or edit from a rollback history view.
Use the active thread when you want to continue working. Use rollback history when you need to inspect what happened before the rollback without changing the conversation.

​
Import Codex CLI Threads

If you have already used Codex CLI directly in the same project folder on the selected host, you can import those conversations into Main Chat as separate threads. To import existing CLI threads:
1

Configure Main Chat for the same folder

Select the registered host and project root that you used with Codex CLI. Jaidu matches CLI threads whose working directory is that root or a folder inside it.
2

Import CLI threads

From the project Main Chat card, select the host and choose Import CLI threads. If the Main Chat workspace has not been opened yet, Jaidu creates it before importing.
3

Open Main Chat

Open Main Chat to view imported CLI conversations in the thread list. Each matched Codex CLI conversation appears as its own Main Chat thread.
Jaidu shows how many thread files were scanned, matched, imported, and skipped after the import completes. You can run the import again; existing imported threads and turns are not duplicated. When an import depth is selected, Jaidu uses the latest event timestamp in each Codex CLI thread. A long-running thread created under an older date folder is still eligible when it was updated within the selected window.
Importing CLI threads adds conversation history to Main Chat. It does not copy Project Chat messages, create branches, create worktrees, or turn imported threads into issue workspaces.

​
Missing Project Folders

A Main Chat binding can become stale if the host folder is moved or deleted after configuration. When that happens, Jaidu keeps the binding visible enough to repair it and reports that the host project folder is missing. Reconfigure Main Chat with the new valid path instead of debugging it as a generic bad-path error.

​
Boundaries

Main Chat workspaces intentionally block workspace-only mutation flows such as:
  • fork/branch creation from Main Chat;
  • workspace Git push, merge, rebase, and branch rename actions;
  • review flows that are only supported for issue/workspace branches.
Create or fork a workspace when you need those branch workflows.