Craft Apps Guide

Use Codex in SolidCraft's Agent chat

SolidCraft's desktop Agent chat can connect to Codex through an ACP adapter. That means you issue a request inside SolidCraft while a coding agent runs under your own account. It is a different direction from using an external agent to control SolidCraft through MCP. Choose the route by where you want to work; the official Agent chat documentation describes the in-app route.

Your starting pointConnectionGuide
You are inside SolidCraft and want its Assistant panel to use CodexACP through codex-acpThis page.
You are in an external agent and want it to operate SolidCraftSolidCraft MCP serverSolidCraft MCP guide.

Prepare the desktop app and adapter

The official documentation labels Agent chat desktop app only. Install SolidCraft from its official repository and sign in to the Codex account you intend to use. Open Preferences → AI and keep Show AI features enabled. Install the documented Codex ACP adapter with npm install -g @agentclientprotocol/codex-acp; this is the command in the official Agent chat document. The adapter, your Codex sign-in and the SolidCraft app are separate components.

Open SolidCraft's Assistant panel from its application-bar button, Cmd+Shift+A on Mac or Ctrl+Shift+A on Windows/Linux, or the Agent chat entry in the view settings. Select Codex in the agent list. Press Refresh after installing an adapter so SolidCraft checks the installed programs again; Test starts a short agent session and ends it. A found login file is not proof that authentication still works: the connection or Test confirms it, as the official document explains.

First design check

Use an empty design and a small reversible request, such as asking for one simple labeled shape. Before sending it, save a copy of the design. After the agent responds, inspect the design itself and the history for the requested object and dimensions. Keep the chat response and actual geometry separate in your assessment: a sentence saying “done” is not a model check. The agent acts under your own account and permissions, so review file or command approvals in the agent's prompt.

If SolidCraft reportsCheck in this order
Codex is not foundAdapter installation, executable path, then Refresh.
Program does not startThe adapter's version/start check and the system reason SolidCraft displays.
Not signed inYour Codex sign-in, then Test or a new connection.
Connected but design unchangedThe exact request, selected design and actual geometry/history.

The official documentation says SolidCraft checks for an agent's login file or key variable without reading credentials, then relies on a connection to confirm authentication. It does not sell or proxy the coding agent's account. The SolidCraft MCP guide covers the other direction. SolidCraft is a separate product and is not one of the 16 Craft Apps in the ArtCraft directory.

Common questions

Is codex-acp the same as SolidCraft MCP? No. ACP connects Codex to SolidCraft's in-app chat; MCP lets an external client use SolidCraft's exposed tools.

Does opening the panel start Codex immediately? The official document says SolidCraft looks for installed agents when the panel opens and starts one when you send a message or press Connect, unless you enabled its separate auto-connect preference.

Does a detected login mean the connection works? No. Test or a chat connection is the check that can confirm the agent accepts the session.

Sources