#workgraph-codex-cli

workgraph-codex-cli implements the workgraph-core coding-agent contract with the native Codex CLI SDK.

#Package

import {
  "totto2727/workgraph-codex-cli"
}

The module supports and prefers the native target.

#Example

The example uses the local Codex CLI authentication and runs a read-only prompt in the current workspace.

moon run --target native package/workgraph-codex-cli/src/examples/basic

CodexAdapterError

source

pub suberror CodexAdapterError {
  SessionClosed
} derive(@moonbitlang/core/debug.Debug
Debug)

Raised when execution is requested after a session has closed.

CodexAgentOptions

source

pub struct CodexAgentOptions {
  codex_path_override : @moonbitlang/x/path.Path
Path?
  base_url : String?
  api_key : String?
  config : Map[String, @totto2727/codex-sdk.CodexConfigValue
CodexConfigValue]?
  resume_thread_id : String?
  model : String?
  sandbox : @totto2727/codex-sdk.SandboxMode
SandboxMode?
  skip_git : Bool?
  reasoning : @totto2727/codex-sdk.ModelReasoningEffort
ModelReasoningEffort?
  web_search : @totto2727/codex-sdk.WebSearchMode
WebSearchMode?
}

Configuration shared by every Codex session opened by this adapter.

CodexAgentOptions::CodexAgentOptions

source

fn CodexAgentOptions::CodexAgentOptions(codex_path_override? : @moonbitlang/x/path.Path
Path, base_url? : String, api_key? : String, config? : Map[String, @totto2727/codex-sdk.CodexConfigValue
CodexConfigValue], resume_thread_id? : String, model? : String, sandbox? : @totto2727/codex-sdk.SandboxMode
SandboxMode, skip_git? : Bool, reasoning? : @totto2727/codex-sdk.ModelReasoningEffort
ModelReasoningEffort, web_search? : @totto2727/codex-sdk.WebSearchMode
WebSearchMode) -> CodexAgentOptions

Creates Codex adapter options with the SDK's defaults.

codex_agent

source

fn codex_agent(id : @totto2727/workgraph-agent-cli.CodingAgentId
CodingAgentId, options : CodexAgentOptions) -> @totto2727/workgraph-agent-cli.CodingAgent
CodingAgent