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
- 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.
- Open a cloud drawing in Deta and copy its link. Paste the link into the agent's chat.
- Describe the task, for example: “Count the doors on page 2, mark each one and create a takeoff table grouped by type.”
- 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:
| Agent | Command |
|---|---|
| Claude Code | claude plugin marketplace add GabrielMunnich/deta-agent && claude plugin install deta@deta |
| Codex | codex plugin marketplace add GabrielMunnich/deta-agent && codex plugin add deta@deta |
| Gemini CLI | gemini extensions install https://github.com/GabrielMunnich/deta-agent |
| Antigravity | agy 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.
| Agent | Setting |
|---|---|
| Claude Code | Allow Bash(npx -y @deta-studio/cli@latest:*). |
| Codex | Allow 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.