jaidu-agent is the host runtime that connects a developer machine to the Jaidu control plane through relay.

​
Current jaidu-agent Version

The current public release is v0.311.0. Only Linux x86_64 is supported for the current public artifact.

​
Install Or Update

Run the stable installer on the Linux x86_64 machine that should host jaidu-agent:
The installer downloads the current versioned archive and checksum, verifies the binary, installs it under ~/.local/lib/jaidu-agent, links ~/.local/bin/jaidu-agent, writes the systemd user service, starts the service, and keeps the previous working release for rollback. A piped script cannot update the current shell process. If the installer says it configured ~/.local/bin, run the printed export PATH=... command in the current terminal or open a new terminal. Check the installed command with:

​
Service Status And Logs

The installer manages jaidu-agent as a systemd user service:
For startup after reboot without an interactive login, enable linger for your Linux user. The installer prints this as optional guidance when linger is disabled:

​
Manual Diagnostics

Manual start is only for diagnostics when you want to watch first-run logs directly. Stop the systemd user service first so two agents do not run on the same machine.
Restart the managed service afterwards:

​
Approve Pending Registration

On first run, jaidu-agent creates a pending machine registration and waits. While it is waiting, logs can show that registration is pending approval. Keep the systemd service running while you approve it. In the Jaidu web UI:
  1. Open Settings → My Hosts.
  2. Find the expected machine under pending registrations.
  3. Confirm the host_name and machine_id match the machine you started.
  4. Click Claim host.
After claim, the running agent polls the control plane, stores agent_auth.json, connects through relay, and appears under My Hosts. No terminal input is required on the agent side. Organization and project access are configured after the host is claimed. If no pending machine appears, check the agent logs and confirm that the service uses the public Jaidu deployment.

​
Version History

​
Released 2026-08-14
  • Workspace panels — file changes, processes, previews, approvals, and agent discovery — now stream live updates instead of polling, so they react instantly and use less bandwidth.
  • Very large file diffs no longer bloat the live stream; full contents load on demand when you open them.
  • Reconnecting after a network drop reliably restores the full workspace state.
​
Released 2026-08-13
  • Re-importing an external CLI session no longer duplicates or resurrects conversation history; repeat imports are fully idempotent.
  • Opening a long legacy session now backfills history oldest-to-newest in one pass and lands on the freshest messages.
  • Conversation history is written by a single writer path, removing several legacy write mechanisms and their edge-case corruption risks.
​
Released 2026-08-12
  • Keeps live workspace conversations connected through idle periods and recovers dead connections promptly.
  • Handles current Claude Code system events without leaking unsupported protocol messages into the conversation feed.
  • Lets project agents create, inspect, update, and cancel planned calls and their agenda parts.
​
Released 2026-08-12
  • Streams conversation updates as incremental events over a live connection, removing the polling delay in the workspace view.
  • Keeps streamed command output visible when an agent re-asks for approval, and streaming metadata no longer freezes at the first chunk.
  • Agent artifacts are standalone and can be explicitly attached to their runs and issues through new MCP tools.
​
Released 2026-08-11
  • Streams long agent conversations faster in the web workspace view.
  • Reports terminal input failures instead of silently dropping keystrokes, and keeps terminal output flowing safely under slow connections.
  • Keeps the host connected to Jaidu even if the relay reconnect loop hits an internal error.
​
Released 2026-08-08
  • Lets agents inspect project schedules and recent runs when advising what automation to add next.
  • Improves scheduled-run recovery and prevents duplicate work when delivery is retried.
​
Released 2026-08-06
  • Lets scheduled agents publish HTML artifacts and attach them to run results.
  • Adds artifact creation, discovery, and updates to Jaidu’s project-management tools.
​
Released 2026-08-05
  • Keeps host requests responsive while Jaidu performs filesystem and Git work.
  • Streams high-volume terminal output more efficiently.
  • Improves request tracing and recovery when a host operation fails.
​
Released 2026-08-01
  • Resolves each scheduled scenario’s required skills and MCP servers on the selected host before creating the schedule.
  • Freezes the resolved runtime with the scenario so later runs use the same host resources or pause with an actionable error.
​
Released 2026-07-31
  • Makes a scheduled run say what it found in its workspace, instead of leaving the transcript empty once the result is filed.
​
Released 2026-07-30
  • Makes scheduled-run workspaces open correctly from run details, including workspaces reused by later runs.
​
Released 2026-07-30
  • Runs scheduled work from frozen scenario definitions and keeps runs waiting for a person in a truthful waiting state.
  • Adds call-part discovery and on-demand transcript requests to the project-management tools available on registered hosts.
  • Recovers or pauses schedule runs that cannot continue instead of leaving them silently stuck.
​
Released 2026-07-28
  • Launches scheduled workspace runs on the host and closes out runs that never start.
  • Keeps conversation history in the order the host recorded it, so a reply no longer appears above the message that prompted it.
  • Eases host polling while a workspace sits idle, and publishes a fresh Linux x86_64 jaidu-agent artifact.
​
Released 2026-07-25
  • Adds host support for scheduled workspace runs (Schedules Phase 0).
  • Keeps scheduled runs consistent by validating their runtime configuration on the host.
  • Publishes a fresh Linux x86_64 jaidu-agent artifact.
​
Released 2026-07-25
  • Adds Claude Code as a selectable coding agent for registered-host workspaces alongside Codex.
  • Validates the local Claude CLI on the host so Jaidu offers Claude Code only where it can run.
  • Publishes a fresh Linux x86_64 jaidu-agent artifact.
​
Released 2026-07-21
  • Keeps Workspace Git and Changes requests responsive in large repositories.
  • Improves registered-host recovery during repeated Workspace refreshes.
​
Released 2026-07-19
  • Improves Codex history import identity and parent/child thread tracking.
  • Keeps imported Main Chat and workspace history consistent across repeated syncs.
​
Released 2026-07-14
  • Prevents empty parent runs from reappearing in Dashboard activity after Codex review handoffs.
​
Released 2026-07-13
  • Explains CLI history import notes with the affected workspace and run names.
  • Keeps routine history cleanup informational while highlighting unfinished runs.
​
Released 2026-07-12
  • Adds accurate Goal-level Dashboard activity across continuations and subagents.
  • Reports Goal lifecycle and Run ownership without changing Thread totals.
  • Keeps missing usage prices visibly partial instead of counting them as zero.
​
Released 2026-07-12
  • Keeps one conversation message when a registered-host Codex turn is reconciled with imported history.
  • Preserves prompt library chip details on that canonical history message.
​
Released 2026-07-12
  • Adds registered-host support for prompt library messages while keeping the prompt sent to Codex as plain resolved text.
  • Keeps prompt library context available through queued messages, retries, edits, and conversation history.
​
Released 2026-07-12
  • Improves dashboard usage accuracy by retaining and importing the Codex service tier from host rollout history.
  • Preserves the original runtime-skill cleanup diagnostic summary and path when a Codex resume cleanup fails.
​
Released 2026-07-10
  • Uses each registered host’s Codex configuration to initialise the model and reasoning for new workspace conversations.
  • Reports the models and reasoning choices available on the registered host.
  • Improves compatibility with older hosts and future model or reasoning values.
​
Released 2026-07-10
  • Adds GPT-5.4, GPT-5.5, and GPT-5.6 choices to workspace conversations on registered hosts.
  • Adds model-specific reasoning choices, including Max and Ultra for GPT-5.6.
  • Publishes a fresh Linux x86_64 jaidu-agent artifact.
​
Released 2026-07-09
  • Requires Codex CLI 0.142.0 or newer for registered-host Codex sessions.
  • Handles newer Codex reasoning modes, including ultra, when starting a thread.
  • Publishes a fresh Linux x86_64 jaidu-agent artifact.
​
Released 2026-07-09
  • Hides internal Codex model-parameter metadata from new chat output.
  • Keeps registered-host chat logs focused on user and assistant messages.
  • Publishes a fresh Linux x86_64 jaidu-agent artifact.
​
Released 2026-07-07
  • Improves Codex /goal handling on registered hosts.
  • Starts the requested goal work immediately after saving the objective.
  • Publishes a fresh Linux x86_64 jaidu-agent artifact.
​
Released 2026-07-07
  • Adds host support for richer scenario action metadata.
  • Improves manual scenario gates used by graph-based workflows.
  • Publishes a fresh Linux x86_64 jaidu-agent artifact.
​
Released 2026-07-07
  • Adds support for scenario templates with branching dependency graphs.
  • Improves scenario run progress reporting for dependent steps.
  • Publishes a fresh Linux x86_64 jaidu-agent artifact.
​
Released 2026-07-05
  • Recovers Codex CLI history files that contain isolated NUL-prefixed JSONL records.
  • Improves diagnostics for malformed Codex history records by reporting the source file and line number.
​
Released 2026-07-03
  • Adds stricter validation for authored scenario templates before installation.
  • Rejects scenario dependency graphs that are not supported by the current linear workflow runner.
  • Publishes a fresh Linux x86_64 jaidu-agent artifact from current main.
​
Released 2026-07-01
  • Adds host support for installed scenario templates launched from Jaidu chat.
  • Keeps scenario runs tied to saved workflow snapshots after template changes.
  • Improves access checks for scenario runtime presets on registered hosts.
​
Released 2026-06-30
  • Improves Codex runtime history cleanup for registered hosts.
  • Uses safer placeholders when preparing Codex resume history.
​
Released 2026-06-29
  • Adds project management guidance for host-side Jaidu agents.
  • Improves project management tool schemas used by registered hosts.
  • Refines Ask Jaidu project-management flows for delegated project work.
​
Released 2026-06-27
  • Publishes issue draft proposal cards back into chat for delegated project work.
  • Preserves the originating workspace and chat context for issue draft proposals.
  • Improves host-side project management flows used by organization chat.
​
Released 2026-06-27
  • Adds task-draft review support for Ask Jaidu project conversations.
  • Preserves structured tool results so Jaidu can present proposed work more clearly.
  • Lets eligible project agents approve or reject issue drafts from chat.
​
Released 2026-06-26
  • Adds safer host-side project management writes for Ask Jaidu and project workflows.
  • Lets eligible project agents create and update issues, complete issues, and create subissue drafts through Project MCP.
  • Preserves project-boundary checks, idempotency, and audit tracking for issue writes.
​
Released 2026-06-25
  • Connects organization Ask Jaidu project workspaces to the host-side project management tools.
  • Improves project-linked organization chat work on registered hosts.
​
Released 2026-06-25
  • Hardens Codex command discovery for agents started by systemd.
  • Refreshes shell path detection before launching Codex work.
​
Released 2026-06-25
  • Adds organization Ask Jaidu workspaces for project-linked host work.
  • Adds host-side project management support for organization chat workflows.
  • Reports Codex runtime setup details that Jaidu can show in host settings.
​
Released 2026-06-23
  • Supersedes v0.268.0 for hosts affected by a duplicate local database migration version.
  • Repairs the partial startup state left by the failed v0.268.0 migration without deleting local agent data.
  • Adds release validation for local database migration versions.
​
Released 2026-06-23
  • Superseded by v0.269.0 for hosts affected by a duplicate local database migration version.
  • Adds project-scoped MCP access presets for registered hosts.
  • Lets CLI Threads start a fresh thread directly.
  • Adds dashboard host filtering for projects with multiple hosts.
​
Released 2026-06-23
  • Adds project management MCP tools for registered hosts.
  • Adds call transcript access through the project management tools.
  • Improves Codex review and scenario handling for long confirmed transcripts.
​
Released 2026-06-22
  • Cleans up Codex history more reliably when workspace runtime skills are deselected.
  • Keeps Codex resume cleanup safe around missing or renamed runtime tools.
  • Handles skill names next to normal punctuation during Codex resume cleanup.
​
Released 2026-06-21
  • Uses Jaidu workspace naming for newly created host workspaces.
  • Converts Cyrillic task titles into readable Latin workspace branch slugs.
  • Keeps workspace response indicators focused on active unseen work.
​
Released 2026-06-18
  • Keeps Codex runtime preset history appendable when selected skills change in a workspace thread.
  • Avoids redacting active skill references when selected and deselected skill names overlap.
​
Released 2026-06-17
  • Improves workspace status refreshes when Jaidu needs details for selected workspaces.
  • Keeps board-linked workspace activity checks focused on the requested workspaces.
​
Released 2026-06-17
  • Reports runtime preset cleanup diagnostics to Jaidu when selected skills need safer Codex history handling.
  • Keeps local agent logs as a fallback when diagnostic delivery is unavailable.
​
Released 2026-06-16
  • Tightens selected runtime preset skill guidance for each Codex turn.
  • Tells Codex to treat unselected skills as unavailable for that turn.
​
Released 2026-06-16
  • Applies selected runtime preset skills as current-message guidance when launching Codex turns.
  • Keeps runtime preset guidance focused on skills while MCP tools continue through runtime configuration.
​
Released 2026-06-15
  • Applies selected workspace runtime preset skills when jaidu-agent launches Codex turns.
  • Keeps non-selected skills disabled for explicit runtime presets.
​
Released 2026-06-15
  • Labels /mcp output as base host MCP status when it is not scoped to the selected per-turn runtime preset.
  • Shows selected runtime MCP IDs in the /mcp diagnostic note when Jaidu passes an explicit workspace runtime configuration.
​
Released 2026-06-13
  • Keeps Codex history import warnings visible while the dashboard refreshes after import.
  • Improves Codex history import handling for duplicate or moved local history files.
​
Released 2026-06-12
  • Supports per-turn workspace runtime settings for registered-host work.
  • Keeps runtime choices attached when Jaidu starts or reuses workspaces for follow-up messages.
​
Released 2026-06-11
  • Suppresses zero-token parent review handoff rows that duplicate the real imported review thread.
  • Keeps imported Codex review activity focused on the derived thread that owns the usage.
​
Released 2026-06-11
  • Suppresses live Codex activity that is matched after its imported history already exists.
  • Backfills local Codex overlap state so repeated imports keep dashboard usage canonical.
​
Released 2026-06-11
  • Fixes startup for hosts with recent local database migrations.
  • Keeps the Codex history import duplicate-activity fixes from v0.252.0.
​
Released 2026-06-11
  • Superseded by v0.253.0 for hosts with recent local database migrations.
  • Imports Codex history without duplicating matching live host activity.
  • Keeps task workspace Codex threads focused on the imported canonical thread.
  • Improves dashboard usage syncing for Codex turns that were also seen live.
​
Released 2026-06-11
  • Keeps queued follow-ups in FIFO order when several messages are waiting.
  • Recovers queued follow-ups safely after an interrupted registered-host handoff.
  • Keeps follow-up queue controls aligned with active registered-host work.
​
Released 2026-06-11
  • Runs queued follow-up messages one by one after registered-host work finishes.
  • Keeps queued follow-ups from getting stuck while setup or cleanup work is still finishing.
  • Keeps Codex Stop and Queue controls aligned with the active registered-host run.
​
Released 2026-06-09
  • Keeps Codex Stop and Queue controls available while registered-host runs are active.
  • Keeps plan-mode implementation turns controllable after plan approval.
  • Prevents stale Codex control state from crossing between workspace sessions.
​
Released 2026-06-08
  • Clears queued follow-ups when a running workspace task is stopped.
  • Prevents stopped workspace runs from sending stale queued messages.
​
Released 2026-06-06
  • Adds host-side support for workspace external source scratch data.
​
Released 2026-06-06
  • Adds workspace file downloads from registered-host workspaces.
​
Released 2026-06-06
  • Imports recent Codex review subagent sessions after registered-host runs finish.
  • Syncs review subagent dashboard usage so activity and cost stay visible.
​
Released 2026-06-05
  • Improves slash-command submission and approval handling in Codex sessions.
  • Keeps timed-out questions from being submitted accidentally.
​
Released 2026-06-05
  • Imports task workspace Codex threads from the workspace worktree repo path when the stored repo record points to the base repository.
​
Released 2026-06-05
  • Imports task workspace Codex threads when the saved session path differs from the active turn path.
  • Shows zero-token dashboard activity as zero-cost instead of unpriced.
​
Released 2026-06-05
  • Keeps task workspace Codex imports attached to the correct workspace.
  • Improves imported CLI thread sync for registered-host task workspaces.
  • Keeps same-root imported threads visible after workspace binding changes.
​
Released 2026-06-04
  • Adds workspace runtime presets so registered-host workspaces can start with the intended resources, skills, and tools.
  • Keeps Codex runs scoped to the selected workspace runtime configuration.
  • Preserves exact chat timestamps and stdout line buffering in registered-host conversation history.
​
Released 2026-06-03
  • Supersedes v0.238.0 for registered hosts affected by temporary control-plane auth refresh failures.
  • Keeps registered-host credentials through transient gateway errors instead of creating a new pending registration.
  • Refreshes existing host credentials once the control plane is reachable again.
​
Released 2026-06-03
  • Keeps Codex question prompts available from the pending approval state in registered-host sessions.
  • Shows timed-out question prompts clearly and prevents stale keyboard-submit answers from being sent.
  • Adds clearer task response indicators and absolute workspace-chat timestamps for registered-host work.
​
Released 2026-06-02
  • Adds native Codex slash commands for /plan, /review, and /goal in registered-host sessions.
  • Keeps bare /review and sticky plan-mode commands handled in the Jaidu composer before they reach the agent queue.
  • Starts slash-command reviews through the same Codex review flow as the review action.
​
Released 2026-06-02
  • Keeps Codex review child threads grouped with their parent CLI Thread after imports and sync, and keeps review subagents out of manual issue-workspace linking.
  • Carries issue context through CLI Threads opened from linked issue workspaces.
  • Removes the extra follow-up commit prompt from registered-host Codex runs.
​
Released 2026-05-30
  • Keeps CLI Threads ordered by recent activity across registered-host restarts.
  • Backfills existing host thread activity from previous runs and imports.
  • Publishes a fresh Linux x86_64 jaidu-agent artifact for the session activity update.
​
Released 2026-05-30
  • Aligns first-run jaidu-agent registration with the My Hosts claim flow.
  • Keeps registered-host Main Chat threads easier to identify by naming new untitled threads from the first prompt.
  • Publishes a fresh Linux x86_64 jaidu-agent artifact for the host-access rollout.
​
Released 2026-05-29
  • Keeps CLI Threads user prompts visible after a run completes and after reload.
  • Repairs prompt-backed conversation history for registered-host chat sessions.
  • Avoids duplicate user prompt rows when Codex already emits a user message.
​
Released 2026-05-29
  • Shows live work status for CLI Threads, issue workspaces, and Dashboard Activity while registered hosts run agent work.
  • Keeps Project Main Chat work on one active writable thread so follow-ups target the right conversation.
  • Improves registered-host project access checks when creating issue workspaces.
​
Released 2026-05-28
  • Added progress feedback while issue workspaces start on registered hosts.
  • Bound issue workspaces to the control plane before jaidu-agent starts work, so startup cannot finish at 100% without an openable workspace.
  • Kept project access failures actionable when a host cannot create an issue workspace for the selected project.
  • Published a versioned Linux x86_64 archive.
​
Released 2026-05-28
  • Fixed attachment uploads when creating issue workspaces through registered hosts.
  • Published a versioned Linux x86_64 archive.
​
Released 2026-05-26
  • Changed the default Linux state directory for new jaidu-agent runs to ~/.local/share/jaidu-agent.
  • Kept JAIDU_AGENT_STATE_DIR as the explicit state directory override for portable or managed setups.
  • Published a versioned Linux x86_64 archive.
​
Released 2026-05-21
  • Released the first public Linux x86_64 artifact for jaidu-agent.
  • Published a versioned Linux x86_64 archive.
  • Distributed only jaidu-agent; backend, relay, web UI, and deployment bundles are not public release artifacts.