Connect an Assistant
Understand Agent and Chat Assistants, connection checks, and defaults.
Sections in this article
Choose an Assistant type
| Type | Use it for | Keep in mind |
|---|---|---|
| Agent Assistant | Project work with a local Agent such as Codex or Claude Code | Tools, files, and session capabilities depend on the Agent. |
| Chat Assistant | Conversations through a local or cloud model API | No Agent tools or workspace semantics. The provider defines model capabilities. |
Connect and check
Prepare the source
Install and authenticate a local Agent using its publisher’s instructions, or configure a model provider. Orylo does not include a general third-party Agent installer.
Create the Assistant
Choose the source in Settings, give the Assistant a clear name, and set its instructions. You can also ask an already configured Agent Assistant to help with setup; inspect the proposed settings before saving.
Verify availability
Run the check. A successful check enables a newly created Assistant; a failed check keeps its configuration for troubleshooting. Recheck after fixing the source.
Set reusable defaults
Save instructions, a default workspace where supported, and assigned Skills or MCP tools on the Assistant. Model and reasoning options appear only when supported by the source.
Defaults apply to new conversations. A conversation can keep its own model options; its workspace is fixed after the first message. A Chat Assistant can switch among enabled models from its provider within a conversation.