IntelligenceX
Cmdlet

Invoke-IntelligenceXChat

Namespace IntelligenceX.PowerShell
Inputs
System.String
Outputs
IntelligenceX.Json.JsonValue IntelligenceX.OpenAI.AppServer.Models.TurnInfo

Super-easy chat command that handles connect, init, login, thread, and send.

Examples

Example 1


Invoke-IntelligenceXChat -Text "Summarize these changes."
        

Quick chat

Example 2


Invoke-IntelligenceXChat -Text "List risks." -Stream -WaitSeconds 10
        

Chat with streaming output

Example 3


@"
            text: Describe the image
            image: C:\temp\diagram.png
            "@ | Invoke-IntelligenceXChat -Dsl
        

Use the DSL to mix text and an image

Example 4


Invoke-IntelligenceXChat -Text "Hello" -Login ApiKey -ApiKey $env:OPENAI_API_KEY
        

Use API key login

Example 5


Invoke-IntelligenceXChat -Text "Run tests" -Workspace "C:\repo" -AllowNetwork
        

Run with a workspace sandbox and network access

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.

Syntax

Invoke-IntelligenceXChat -Text <string> [-AllowNetwork] [-ApiKey <string>] [-ApprovalPolicy <string>] [-Arguments <string>] [-ClientName <string>] [-ClientTitle <string>] [-ClientVersion <string>] [-DownloadImageUrls] [-Dsl] [-ExecutablePath <string>] [-ImageFileNamePrefix <string>] [-ImagePath <string>] [-ImageUrl <string>] [-Instructions <string>] [-Login <string>] [-Model <string>] [-NewThread] [-OpenBrowser] [-OverwriteImages] [-Raw] [-ReasoningEffort <Minimal|Low|Medium|High|XHigh>] [-ReasoningSummary <Auto|Concise|Detailed|Off>] [-SaveImagesTo <string>] [-Stream] [-Temperature <double>] [-TextVerbosity <Low|Medium|High>] [-WaitSeconds <int>] [-WorkingDirectory <string>] [-Workspace <string>] [<CommonParameters>]
#
Parameter set: By Text

Parameters

Text string requiredposition: 0pipeline: false
Message text to send.
AllowNetwork SwitchParameter optionalposition: namedpipeline: false
Allow network access when using a workspace sandbox.
ApiKey string optionalposition: namedpipeline: false
API key to use when Login is ApiKey.
ApprovalPolicy string optionalposition: namedpipeline: false
Approval policy (for example auto).
Arguments string optionalposition: namedpipeline: false
Codex app-server arguments.
ClientName string optionalposition: namedpipeline: false
Client name for initialization.
ClientTitle string optionalposition: namedpipeline: false
Client title for initialization.
ClientVersion string optionalposition: namedpipeline: false
Client version for initialization.
DownloadImageUrls SwitchParameter optionalposition: namedpipeline: false
Download image URLs when saving images.
Dsl SwitchParameter optionalposition: namedpipeline: false
Parse Text as a simple DSL (lines starting with image:, url:, text:).
ExecutablePath string optionalposition: namedpipeline: false
Codex executable path.
ImageFileNamePrefix string optionalposition: namedpipeline: false
Prefix for saved image file names.
ImagePath string optionalposition: namedpipeline: false
Image file path to include with the message.
ImageUrl string optionalposition: namedpipeline: false
Image URL to include with the message.
Instructions string optionalposition: namedpipeline: false
System instructions for the assistant.
Login string optionalposition: namedpipeline: false
Login method: ChatGpt, ApiKey, or None.
Model string optionalposition: namedpipeline: false
Model identifier. Defaults to gpt-5.3-codex.
NewThread SwitchParameter optionalposition: namedpipeline: false
Reset thread before sending.
OpenBrowser SwitchParameter optionalposition: namedpipeline: false
Open the login URL in the default browser.
OverwriteImages SwitchParameter optionalposition: namedpipeline: false
Overwrite existing files when saving images.
Raw SwitchParameter optionalposition: namedpipeline: false
Return raw JSON response.
ReasoningEffort ReasoningEffort optionalposition: namedpipeline: falsevalues: 5
Reasoning effort level. Possible values: Minimal, Low, Medium, High, XHigh
Possible values: Minimal, Low, Medium, High, XHigh
ReasoningSummary ReasoningSummary optionalposition: namedpipeline: falsevalues: 4
Reasoning summary level. Possible values: Auto, Concise, Detailed, Off
Possible values: Auto, Concise, Detailed, Off
SaveImagesTo string optionalposition: namedpipeline: false
Save image outputs to the specified directory.
Stream SwitchParameter optionalposition: namedpipeline: false
Write streaming deltas to the host.
Temperature double optionalposition: namedpipeline: false
Sampling temperature.
TextVerbosity TextVerbosity optionalposition: namedpipeline: falsevalues: 3
Response verbosity level. Possible values: Low, Medium, High
Possible values: Low, Medium, High
WaitSeconds int optionalposition: namedpipeline: false
Wait N seconds for streaming output after sending.
WorkingDirectory string optionalposition: namedpipeline: false
Working directory for app-server.
Workspace string optionalposition: namedpipeline: false
Workspace directory for file writes (sets sandbox policy).

Outputs

IntelligenceX.Json.JsonValue, IntelligenceX.OpenAI.AppServer.Models.TurnInfo

Invoke-IntelligenceXChat [-AllowNetwork] [-ApiKey <string>] [-ApprovalPolicy <string>] [-Arguments <string>] [-ClientName <string>] [-ClientTitle <string>] [-ClientVersion <string>] [-DownloadImageUrls] [-Dsl] [-ExecutablePath <string>] [-ImageFileNamePrefix <string>] [-ImagePath <string>] [-ImageUrl <string>] [-InputObject <string>] [-Instructions <string>] [-Login <string>] [-Model <string>] [-NewThread] [-OpenBrowser] [-OverwriteImages] [-Raw] [-ReasoningEffort <Minimal|Low|Medium|High|XHigh>] [-ReasoningSummary <Auto|Concise|Detailed|Off>] [-SaveImagesTo <string>] [-Stream] [-Temperature <double>] [-TextVerbosity <Low|Medium|High>] [-WaitSeconds <int>] [-WorkingDirectory <string>] [-Workspace <string>] [<CommonParameters>]
#
Parameter set: By InputObject

Parameters

AllowNetwork SwitchParameter optionalposition: namedpipeline: false
Allow network access when using a workspace sandbox.
ApiKey string optionalposition: namedpipeline: false
API key to use when Login is ApiKey.
ApprovalPolicy string optionalposition: namedpipeline: false
Approval policy (for example auto).
Arguments string optionalposition: namedpipeline: false
Codex app-server arguments.
ClientName string optionalposition: namedpipeline: false
Client name for initialization.
ClientTitle string optionalposition: namedpipeline: false
Client title for initialization.
ClientVersion string optionalposition: namedpipeline: false
Client version for initialization.
DownloadImageUrls SwitchParameter optionalposition: namedpipeline: false
Download image URLs when saving images.
Dsl SwitchParameter optionalposition: namedpipeline: false
Parse Text as a simple DSL (lines starting with image:, url:, text:).
ExecutablePath string optionalposition: namedpipeline: false
Codex executable path.
ImageFileNamePrefix string optionalposition: namedpipeline: false
Prefix for saved image file names.
ImagePath string optionalposition: namedpipeline: false
Image file path to include with the message.
ImageUrl string optionalposition: namedpipeline: false
Image URL to include with the message.
InputObject string optionalposition: namedpipeline: true (ByValue)
Pipeline input for DSL lines (text, image, url).
Instructions string optionalposition: namedpipeline: false
System instructions for the assistant.
Login string optionalposition: namedpipeline: false
Login method: ChatGpt, ApiKey, or None.
Model string optionalposition: namedpipeline: false
Model identifier. Defaults to gpt-5.3-codex.
NewThread SwitchParameter optionalposition: namedpipeline: false
Reset thread before sending.
OpenBrowser SwitchParameter optionalposition: namedpipeline: false
Open the login URL in the default browser.
OverwriteImages SwitchParameter optionalposition: namedpipeline: false
Overwrite existing files when saving images.
Raw SwitchParameter optionalposition: namedpipeline: false
Return raw JSON response.
ReasoningEffort ReasoningEffort optionalposition: namedpipeline: falsevalues: 5
Reasoning effort level. Possible values: Minimal, Low, Medium, High, XHigh
Possible values: Minimal, Low, Medium, High, XHigh
ReasoningSummary ReasoningSummary optionalposition: namedpipeline: falsevalues: 4
Reasoning summary level. Possible values: Auto, Concise, Detailed, Off
Possible values: Auto, Concise, Detailed, Off
SaveImagesTo string optionalposition: namedpipeline: false
Save image outputs to the specified directory.
Stream SwitchParameter optionalposition: namedpipeline: false
Write streaming deltas to the host.
Temperature double optionalposition: namedpipeline: false
Sampling temperature.
TextVerbosity TextVerbosity optionalposition: namedpipeline: falsevalues: 3
Response verbosity level. Possible values: Low, Medium, High
Possible values: Low, Medium, High
WaitSeconds int optionalposition: namedpipeline: false
Wait N seconds for streaming output after sending.
WorkingDirectory string optionalposition: namedpipeline: false
Working directory for app-server.
Workspace string optionalposition: namedpipeline: false
Workspace directory for file writes (sets sandbox policy).

Outputs

IntelligenceX.Json.JsonValue, IntelligenceX.OpenAI.AppServer.Models.TurnInfo