chainenv

name	chainenv
description	Operate the `chainenv` CLI for local secret workflows across macOS Keychain, Linux keyring, and optional 1Password integration. Use when requests mention `chainenv`, `.chainenv.toml`, `chainenv.toml`, keychain vs 1Password, shell export generation, copying secrets between backends, or troubleshooting backend availability and `op` token loading.

Chainenv

Use this skill when the user wants to work with the installed chainenv CLI. This skill is for operating the product, not for changing its source code.

Prerequisites

• chainenv must be installed and available on PATH.
• Start with chainenv diag to confirm backend availability on the current machine.
• For 1Password flows, the op CLI must be installed. Authentication can come from an active op session or from OP_SERVICE_ACCOUNT_TOKEN.
• If config-driven behavior matters, read references/auth.md for .chainenv.toml layout and token-loading behavior.

When To Use It

Use this skill for:

• backend diagnostics
• reading stored secrets with get or get-env
• generating shell exports for bash, zsh, fish, or plain output
• writing or updating secrets with set and update
• copying secrets between keychain and 1Password
• explaining how .chainenv.toml affects provider selection and default fallbacks

Read references/commands.md when you need exact command forms. Read references/usage.md when you need workflow guidance or troubleshooting.

Operating Guidance