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
Startjaidu-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 relayMain 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