AI connections

Use a compatible external AI client to work with Yuntu's supported editor operations. Conversations and model configuration live in that client; Yuntu shows the project and the resulting changes.

What you need

• A running Yuntu Editor build with its local connection capability available.
• A compatible external client configured for that connection, including MCP where supported.
• Access to an AI model through your client or provider. Provider charges are separate from editor use.

Connection setup varies by client and build. Use the connection instructions supplied with your installed version for its actual executable, discovery location, and supported transport. This guide does not prescribe a universal configuration file or command that may target another installation.

Connect to the intended instance

1. Open the project in Yuntu and check the page you intend to work on.
2. Follow that build's connection instructions in your external client.
3. Ask the client to inspect the active project and page before making a change.
4. Confirm that it sees the intended local instance, especially if several editor windows are running.
5. Start with a small edit, inspect the result in Yuntu, and continue when the target is correct.

Local connection credentials can authorize edits. Keep tokens and discovery files private; do not paste them into public issues, screenshots, project documents, or committed configuration.

Give useful instructions

Name the page, element, and intended outcome. For example: "On the settings page, align the Theme label with its field and keep the current text." For a larger change, specify which content must stay and how you will judge the result.

Use the AI observation view to follow work while staying in your external client. Inspect the command details and before-and-after presentation. Check the actual page rather than assuming a successful tool call produced the intended design.

Review or undo a change

Use supported undo or selective command undo when available. If the document changed again after the command, inspect the current state before reverting it. Avoid asking a second client to make simultaneous edits to the same page.

Review comments give the next revision a precise target. Saving a comment does not automatically instruct AI to change the page. See Review and history.

If connection fails

Check that the intended editor instance is running and that the client is using its current connection information. Refresh the connection after a restart if required. Keep error messages, but remove credentials before sharing them. Continue with local editing while diagnosing the connection; do not overwrite your project to reset a client.