Skip to main content

Connect WorkBuddy

Use a Primex chat model with the WorkBuddy task assistant. You need a WorkBuddy installation/account with custom-model settings and a Primex API key. Choose a model in WorkBuddy Setup. WorkBuddy's built-in models and account availability can vary by version or plan.

Configure an exact endpoint​

Open Settings → Model, add a model, and select Custom rather than a different provider's preset. Enable Custom Protocol in advanced settings.

SettingValue
ProviderCustom
Custom ProtocolOn
Request URLhttps://gateway.primexos.com/v1/chat/completions
API KeyYour dedicated Primex key, entered privately
Model name / IDThe exact ID selected in Setup

With Custom Protocol on, WorkBuddy sends directly to the entered URL and skips path auto-completion. Enter the complete request URL here, rather than only the Gateway host or /v1 base. Save, then select the custom model explicitly in the task/chat model selector; Auto can choose a different built-in model.

The JSON in Setup is a manual settings checklist, not a WorkBuddy import file. Existing ~/.codebuddy/models.json entries can appear in the newer settings UI; use the UI to manage this connection rather than copying the checklist into that file. Keep the key in the model credential, outside task prompts.

First text task​

Start with a plain text task: “Reply with a short greeting”. Ask a follow-up about the answer, then confirm the complete replies and exact model in Usage.

Leave tool calling, image input and optional reasoning controls off for the first text task. Provider presets can infer flags; manually match them to the model's published capabilities before using them. Where sampling controls are available, use Temperature1 or omit optional values. If the client sends a parameter your chosen model rejects and offers no way to change it, select another eligible model.

Extend to office/agent tasks​

File access, automation and tool execution belong to WorkBuddy's permissions and task environment. For a model with tool support, enable the needed capability and first try a harmless read-only tool task in a disposable folder. Image, memory, scheduled/background and auxiliary-model workflows require their own settings; the chat URL alone does not configure them.

Primex model requests use your Primex credit. WorkBuddy subscription/credits and its additional services remain separate. Inspect Usage before repeating uncertain tasks; a client retry or background action can make another request.

Fix a connection or remove it​

  • 401: check the custom model's key and authentication.
  • 404: enable Custom Protocol and use the complete request URL once.
  • Wrong model: select the custom model explicitly rather than Auto.
  • 400: review feature flags, sampling and the selected model's capabilities.
  • 402 / 429 / interrupted task: inspect Errors & limits and Usage.

Replace the model in dependent tasks, remove the custom entry and revoke its key when no longer used. Removing the provider does not remove WorkBuddy task data.

See the official Model Configuration guide. Report a setup issue.