Connect an external agent

Connect Claude Code, Codex or another agent using its own AI plan. Requires Deta Pro or a Studio seat.

Updated

Use Claude Code, Codex or another coding agent to work on your Deta drawings. The Deta skill teaches it to use the CLI to read and edit markups, takeoff tables, page scales and product libraries.

You need Deta Pro or a Studio seat, an agent that can run commands, and Node 20 or later on the computer running the agent. AI usage is billed through your agent's own plan or API account; this workflow does not spend Deta credits.

To work directly in Deta instead, see Deta agent.

Connect your agent

Copy this prompt and paste it into Claude Code, Codex or your preferred agent to connect it to Deta.

Install the Deta skill from https://github.com/GabrielMunnich/deta-agent and help me connect my Deta account.

You can also copy it from + → Chat settings → Use Deta from an external agent in Deta chat. Your agent will install the Deta skill and guide you through signing in.

Connect and open a drawing

  1. Give the agent the email of your Deta account when it asks. Deta emails you a sign-in code; give the code to the agent to finish connecting. Browser sign-in is also available.
  2. Open a cloud drawing in Deta and copy its link. Paste the link into the agent's chat.
  3. Describe the task, for example: “Count the doors on page 2, mark each one and create a takeoff table grouped by type.”
  4. Return to Deta to review the saved markups and table. The agent works with your Deta account's access and permissions.

The sign-in stays on that computer for later chats. Ask the agent to sign out of Deta when you want to disconnect.

Manual installation

If you prefer to install the plugin yourself, run the command for your agent once:

AgentCommand
Claude Codeclaude plugin marketplace add GabrielMunnich/deta-agent && claude plugin install deta@deta
Codexcodex plugin marketplace add GabrielMunnich/deta-agent && codex plugin add deta@deta
Gemini CLIgemini extensions install https://github.com/GabrielMunnich/deta-agent
Antigravityagy plugin install https://github.com/GabrielMunnich/deta-agent

Allow the CLI in your agent

The plugin runs the Deta CLI, the npm package @deta-studio/cli.

AgentSetting
Claude CodeAllow Bash(npx -y @deta-studio/cli@latest:*).
CodexAllow network access: codex -s workspace-write -c sandbox_workspace_write.network_access=true. If the sandbox can't write ~/.config/deta, set DETA_CONFIG_DIR to a folder it can write.

Without the plugin

Any agent that runs commands can use the CLI directly:

npx -y @deta-studio/cli@latest login --email you@example.com
npx -y @deta-studio/cli@latest login --email you@example.com --code <code>
npx -y @deta-studio/cli@latest open https://www.deta.studio/home/<workspace>/drawings/<drawing>
npx -y @deta-studio/cli@latest help

login --email emails you a sign-in code, and --code signs in with it. login alone signs in through the browser instead. open selects the drawing for the other commands in the current folder, and guide explains markups, tables and libraries. The CLI calls the Deta API with your own Deta permissions.

Reference

See the Deta CLI setup instructions and the API specification used by the CLI.