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.293.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 hostjaidu-agent:
~/.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 managesjaidu-agent as a systemd user service:
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.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:
- Open Settings → My Hosts.
- Find the expected machine under pending registrations.
- Confirm the
host_nameandmachine_idmatch the machine you started. - Click Claim host.
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
- Prevents empty parent runs from reappearing in Dashboard activity after Codex review handoffs.
- Explains CLI history import notes with the affected workspace and run names.
- Keeps routine history cleanup informational while highlighting unfinished runs.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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-agentartifact.
- 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-agentartifact.
- 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-agentartifact.
- Improves Codex
/goalhandling on registered hosts. - Starts the requested goal work immediately after saving the objective.
- Publishes a fresh Linux x86_64
jaidu-agentartifact.
- Adds host support for richer scenario action metadata.
- Improves manual scenario gates used by graph-based workflows.
- Publishes a fresh Linux x86_64
jaidu-agentartifact.
- Adds support for scenario templates with branching dependency graphs.
- Improves scenario run progress reporting for dependent steps.
- Publishes a fresh Linux x86_64
jaidu-agentartifact.
- 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.
- 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-agentartifact from current main.
- 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.
- Improves Codex runtime history cleanup for registered hosts.
- Uses safer placeholders when preparing Codex resume history.
- 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.
- 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.
- 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.
- 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.
- Connects organization Ask Jaidu project workspaces to the host-side project management tools.
- Improves project-linked organization chat work on registered hosts.
- Hardens Codex command discovery for agents started by systemd.
- Refreshes shell path detection before launching Codex work.
- 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.
- Supersedes
v0.268.0for hosts affected by a duplicate local database migration version. - Repairs the partial startup state left by the failed
v0.268.0migration without deleting local agent data. - Adds release validation for local database migration versions.
- Superseded by
v0.269.0for 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.
- 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.
- 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.
- 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.
- 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.
- Improves workspace status refreshes when Jaidu needs details for selected workspaces.
- Keeps board-linked workspace activity checks focused on the requested workspaces.
- 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.
- Tightens selected runtime preset skill guidance for each Codex turn.
- Tells Codex to treat unselected skills as unavailable for that turn.
- 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.
- Applies selected workspace runtime preset skills when
jaidu-agentlaunches Codex turns. - Keeps non-selected skills disabled for explicit runtime presets.
- Labels
/mcpoutput as base host MCP status when it is not scoped to the selected per-turn runtime preset. - Shows selected runtime MCP IDs in the
/mcpdiagnostic note when Jaidu passes an explicit workspace runtime configuration.
- Keeps Codex history import warnings visible while the dashboard refreshes after import.
- Improves Codex history import handling for duplicate or moved local history files.
- Supports per-turn workspace runtime settings for registered-host work.
- Keeps runtime choices attached when Jaidu starts or reuses workspaces for follow-up messages.
- 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.
- 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.
- Fixes startup for hosts with recent local database migrations.
- Keeps the Codex history import duplicate-activity fixes from v0.252.0.
- 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.
- 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.
- 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.
- 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.
- Clears queued follow-ups when a running workspace task is stopped.
- Prevents stopped workspace runs from sending stale queued messages.
- Adds host-side support for workspace external source scratch data.
- Adds workspace file downloads from registered-host workspaces.
- Imports recent Codex review subagent sessions after registered-host runs finish.
- Syncs review subagent dashboard usage so activity and cost stay visible.
- Improves slash-command submission and approval handling in Codex sessions.
- Keeps timed-out questions from being submitted accidentally.
- Imports task workspace Codex threads from the workspace worktree repo path when the stored repo record points to the base repository.
- 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.
- 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.
- 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.
- Supersedes
v0.238.0for 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.
- 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.
- Adds native Codex slash commands for
/plan,/review, and/goalin registered-host sessions. - Keeps bare
/reviewand 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.
- 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.
- 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-agentartifact for the session activity update.
- Aligns first-run
jaidu-agentregistration 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-agentartifact for the host-access rollout.
- 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.
- 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.
- Added progress feedback while issue workspaces start on registered hosts.
- Bound issue workspaces to the control plane before
jaidu-agentstarts 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.
- Fixed attachment uploads when creating issue workspaces through registered hosts.
- Published a versioned Linux x86_64 archive.
- Changed the default Linux state directory for new
jaidu-agentruns to~/.local/share/jaidu-agent. - Kept
JAIDU_AGENT_STATE_DIRas the explicit state directory override for portable or managed setups. - Published a versioned Linux x86_64 archive.
- 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.