Very bad DX - results in very long and frustrating integration process

[giladrom]

Your environment

op-vscode version:1.0.5

VS Code version: Cursor 0.47.8

CLI version:2.30.3

OS: Macos 15.2

Steps to reproduce

1. Sign up for 1Password Team
2. Install the OP CLI
3. Install the VSCode plugin
4. Store too .env files in 1Password shared vault using generated links ("op://Shared/xxx")

What happened?

Many issues arise during initial setup and integration:

1. No documentation about the 1Password Desktop app requiring to enable the "Integrate with 1Password CLI", resulting in a never-ending loop when attempting to install and setup the VSCode plugin
2. When adding a new secret to 1Password using the VSCode plugin, the intuitive thing to do is place all related secrets under one Section. This results in 1Password creating multiple secrets with the same name. For example:

AWS/secret key
AWS/secret key id

Rather than the expected:

AWS/
  - secret key
  - secret key id

This causes an error when trying to use op run, as it complains about duplicate secrets:

[ERROR] 2025/03/26 09:56:04 could not resolve item UUID for item AWS: More than one item matches "AWS". Try again and specify the item by its ID:
...
...

The error message does not explain how to resolve the issue with regards to the .env file and is mostly useless.

Seeing as the plugin complains about duplicate entries, I tried merging all duplicate entries under item (In the UI, merge "AWS/secret key" and "AWS/secret key id" into a single entry named "AWS" with multiple passwords under it), and adjusting the Section_xxx values to the unified vault item.

This results in another error:

[ERROR] 2025/03/26 10:25:24 could not find item AWS in vault Shared, because it has been deleted or archived. Please restore the item if you want to use it with secret provisioning

As you can tell, this is extremely frustrating and caused me to give up on setting up 1Password integration with our code.

What did you expect to happen?

An integration that actually works.

Notes & Logs

[rzyns]

No documentation about the 1Password Desktop app requiring to enable the "Integrate with 1Password CLI", resulting in a never-ending loop when attempting to install and setup the VSCode plugin

This is literally Step 2 in the Get Started with 1Password CLI documentation, which is the documentation that's linked to from the extension: