Connect your agent

Tilda connects your coding agents for you. You don’t need a terminal, Node.js, or npm. Connect adds the tilda MCP server and Tilda’s skills to an agent, and every agent runs them from the Tilda app you installed.

Connect an agent#

Open Tilda. The Coding agents section lists Claude Code, OpenCode, and Grok, and shows what Tilda found on this Mac.
Choose Connect next to your agent.
Start a new session in your agent, so it loads the tilda server and the skills. For OpenCode, restart its service with opencode service restart.

Then ask your agent to check something in your browser. It calls JsReplExec, and Tilda shows the agent under Coding agents while it’s using Tilda.

What each state means#

Connected. The agent has the tilda MCP server and the skills from this copy of Tilda.
Not connected. The agent is installed, and nothing of Tilda’s is in its configuration. Choose Connect.
Needs repair. The agent’s configuration points at a Tilda that is no longer there, for example after you moved the app, or parts of it are missing. The row says what’s wrong. Choose Repair to point it at this copy.
Can’t connect. Something you or another tool wrote is in the way, such as your own server or plugin named tilda. The row names the file and says what to remove. Tilda never overwrites configuration it didn’t write.
Not found. Tilda didn’t find the agent on this Mac. Install it, then choose the refresh button above the list.

Tilda looks for agents on your login shell’s PATH and in each agent’s usual install folder.

What Connect changes#

Connect writes only what the agent needs to reach Tilda. Disconnect removes exactly that, and leaves the rest of your configuration as it was.

Claude Code. Tilda adds a plugin marketplace named tilda that points into the app, and turns on its tilda plugin, through Claude Code’s own claude plugin commands. Claude Code loads the plugin from the app itself.
OpenCode. Tilda adds a one-line plugin, ~/.config/opencode/plugins/tilda.js, that loads the app’s plugin, and links the skills into ~/.config/opencode/skills.
Grok. Tilda adds an [mcp_servers.tilda] table to ~/.grok/config.toml, and links the skills into ~/.grok/skills.

The skills are links into the app, not copies. If you set GROK_HOME, CLAUDE_CONFIG_DIR, OPENCODE_CONFIG_DIR, or XDG_CONFIG_HOME in the environment Tilda starts with, Tilda uses those folders instead. A value set only in your shell’s profile doesn’t reach an app opened from the Dock.

When you update or move Tilda#

Connected agents run the MCP server and Node.js inside Tilda’s app bundle, so updating Tilda in place updates every agent. Start a new agent session to pick up the new version.

If you move Tilda to another folder, its agents show Needs repair. Open Tilda from its new place and choose Repair for each one.