Use this flow to sign in, connect a host, and start Codex work from the Jaidu control plane.

1. Sign in

Open the Jaidu control plane URL for your organisation and sign in with your account. Browser sign-in is separate from host authentication; jaidu-agent uses its own rotating keys after registration.

2. Register and approve a host

Start jaidu-agent on the machine that should own filesystem, Git, terminal, Codex, preview, and workspace execution. On first run, the agent creates a pending registration. An admin approves it from Settings → Remote Access. See Host Registration for the pending approval flow. For public host-runtime downloads, see Agent Releases.

3. Confirm the host is online

After approval, the host appears under Registered hosts in Remote Access. Use an online host before starting Main Chat or creating a workspace.

4. Configure the project root or workspace repos

For Main Chat, bind the project to an existing folder on the selected host. For workspace work, configure the repositories and scripts that Jaidu should use when it creates host-side workspaces.

5. Start Main Chat or create a workspace

  • Use Main Chat when you want Codex work bound to a specific host-side project root.
  • Use a workspace when you want a branch and host-side execution folder for issue-focused work.
  • Use Project Chat when you want project-scoped messages or Telegram imports without host execution.

6. Use a Codex thread

Install and authenticate OpenAI Codex on the host. Then send a prompt in Main Chat or a workspace thread. Main Chat uses the bound project root. Workspaces use their own host-side folder and branch.

7. Review changes

Review the files, diffs, logs, preview, and Git state from the workspace UI. When the workspace supports it, create a pull request from the workspace branch.

Next steps

Host registration

Register a host and confirm jaidu-agent is online through relay

Main Chat

Bind a project-level chat to a host project root

Project Chat

Discuss project context without host execution

Previewing changes

Set up a dev server, preview your app, and jump from the browser to source

Setup and cleanup scripts

Automate dependency installs, builds, and teardown so every workspace starts clean

Reviewing code changes

Review diffs, prompt Codex with feedback, and iterate before merging

Issue management

Break large features into issues, readers, comments, and linked workspaces

Telegram

Link Telegram and send text or voice transcripts into Project Chat