1password

Retrieve and inject 1Password secrets into Hermes command workflows.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MarbleSodas/Mavis --skill 1password-marblesodas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 1password
Source: https://github.com/MarbleSodas/Mavis/tree/main/optional-skills/security/1password
Command: npx skills add https://github.com/MarbleSodas/Mavis --skill 1password-marblesodas

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you avoid insecure plaintext secrets by managing credentials through 1Password CLI so you can safely run commands that need sensitive data without exposing it in logs or files.

Core Features & Use Cases

  • Secret retrieval from 1Password: Read secrets using op read with op://Vault/Item/field references.
  • Secret injection into templates/configs: Use op inject to generate runtime-ready configuration from templates that contain 1Password placeholders.
  • Command execution with ephemeral secret env vars: Use op run to set secret-backed environment variables for a single command execution.
  • Auth flows for different environments: Support interactive desktop app integration, non-interactive service accounts via OP_SERVICE_ACCOUNT_TOKEN, and self-hosted Connect server credentials.

Quick Start

Configure the service account token by setting OP_SERVICE_ACCOUNT_TOKEN in ~/.hermes/.env, then run op read "op://app-prod/db/password" to fetch the secret for use in subsequent Hermes commands.

Frequently Asked Questions about 1password

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I inject secrets from 1Password into config templates without exposing plaintext?

You can inject secrets into config templates using `op inject` to replace 1Password placeholders with runtime-ready values. This prevents sensitive data from being exposed in logs or files during command workflows.

How do I retrieve a specific secret field from 1Password CLI for local development?

To retrieve a secret for local development, use the `op read` command with an `op://Vault/Item/field` reference. This securely fetches the exact credential needed for your Hermes command workflows.

Can I run commands with ephemeral secret environment variables using 1Password?

Yes, you can use `op run` to set secret-backed environment variables for a single command execution. This allows the command to access credentials securely without leaving persistent plaintext environment variables.

Does 1Password CLI support non-interactive service accounts for CI pipelines?

Yes, 1Password CLI supports non-interactive service accounts by setting the `OP_SERVICE_ACCOUNT_TOKEN` environment variable. This enables secure secret retrieval during headless CI execution without manual authentication.

What authentication methods are available for 1Password CLI besides the desktop app?

Besides interactive desktop app integration with tmux-stable auth context, you can authenticate using a service account token via `OP_SERVICE_ACCOUNT_TOKEN` or self-hosted Connect server credentials for headless and automated environments.

What do I need to configure before fetching secrets with 1Password CLI?

You need the 1Password CLI installed and a configured authentication context, such as setting `OP_SERVICE_ACCOUNT_TOKEN` in your environment. This provides the necessary access to retrieve secrets from your vaults.