credentials-utils

Read, refresh, and sync credentials in the omelet store via the evo CLI.

Updated Feb 6, 2026
One-click install
npx skills add https://github.com/maycuatroi1/agent-skills --skill credentials-utils-maycuatroi1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: credentials-utils
Source: https://github.com/maycuatroi1/agent-skills/tree/main/skills/credentials-utils
Command: npx skills add https://github.com/maycuatroi1/agent-skills --skill credentials-utils-maycuatroi1

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing API keys, OAuth tokens, and service credentials scattered across machines is error-prone: tokens expire silently, flat config files drift out of sync, and secrets get leaked into logs. This Skill provides a single command surface (evo cred) to read, list, refresh, migrate, and sync credentials from a per-service folder store that compiles into a flat ~/.omelet.json. ## Core Features & Use Cases - Credential lookup and health checks: Read any value by dotted key path with evo cred get, and audit every credential's expiry and status with evo cred doctor. - Google OAuth lifecycle: Run first-time consent flows with evo cred auth and refresh short-lived access tokens for rclone, gmail, google-drive, and google-calendar with evo cred refresh. - Cross-machine sync: Push and pull the credentials folder through a private GitHub repo using evo cred sync, with automatic backups and permission hardening. - Use Case: Your rclone Google Drive token expired mid-backup. Run evo cred refresh --service rclone to renew the access token, recompile the flat config, and resume without touching any JSON by hand. ## Quick Start Ask the agent to check which credentials in the omelet store are expired by running evo cred doctor.

Frequently Asked Questions about credentials-utils

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

FAQPage Schema
How do I read an API key from the omelet credential store?

Use evo cred get with a dotted key path, for example evo cred get openai_api_key. Only the value reaches stdout, so it composes into shell variables like OPENAI_KEY="$(evo cred get openai_api_key)" without exposing the secret in logs.

How do I refresh an expired Google OAuth token for rclone or gmail?

Run evo cred refresh --all to renew all four Google services, or evo cred refresh --service gmail for one. It uses the stored refresh token, writes the new access token and expiry back to the folder file, and recompiles the flat config.

How do I sync credentials across multiple laptops?

Set OMELET_SYNC_REPO to a private GitHub repo, then run evo cred sync push after local edits and evo cred sync pull on other machines. Pull backs up the existing folder and recompiles the flat ~/.omelet.json automatically.

Can I migrate an old flat omelet.json into the folder-based store?

Yes, evo cred migrate splits a flat file into per-service folder files, routing known keys to their mapped locations and unmapped keys to misc/. Use --dry-run to preview, --merge to fold in keys from another machine without overwriting existing values.

Why did my refreshed token get reverted after running evo cred compile?

The flat ~/.omelet.json has multiple writers, including red-life and sibling repos that refresh tokens directly. If a consumer wrote after your last folder edit, compile reverts it; fold the flat file back into the folder with evo cred add before compiling.